Ping.SendPingAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Sendet eine ICMP (Internet Control Message Protocol)-Echomeldung an einen Computer und empfängt eine entsprechende ICMP-Echoantwortmeldung von diesem Computer als asynchronen Vorgang.
Überlädt
| SendPingAsync(String, TimeSpan, Byte[], PingOptions, CancellationToken) |
Sendet eine ICMP-Echonachricht (Internet Control Message Protocol) mit dem angegebenen Datenpuffer an den angegebenen Computer und empfängt eine entsprechende ICMP-Echoantwortmeldung von diesem Computer als asynchronen Vorgang. Mit dieser Überladung können Sie einen Timeoutwert für den Vorgang, einen Puffer für das Senden und Empfangen, die Steuerung der Fragmentierung und time-to-Live-Werte und einen CancellationToken für das ICMP-Echonachrichtenpaket angeben. |
| SendPingAsync(IPAddress) |
Senden Sie eine ICMP (Internet Control Message Protocol)-Echomeldung mit dem angegebenen Datenpuffer an einen Computer mit der angegebenen IPAddress und empfängt eine entsprechende ICMP-Echoantwortmeldung von diesem Computer als asynchronen Vorgang. |
| SendPingAsync(String) |
Sendet eine ICMP (Internet Control Message Protocol)-Echomeldung mit dem angegebenen Datenpuffer an den angegebenen Computer und empfängt eine entsprechende ICMP-Echoantwortmeldung von diesem Computer als asynchronen Vorgang. |
| SendPingAsync(IPAddress, Int32) |
Senden Sie eine ICMP (Internet Control Message Protocol)-Echomeldung mit dem angegebenen Datenpuffer an einen Computer mit der angegebenen IPAddress und empfängt eine entsprechende ICMP-Echoantwortmeldung von diesem Computer als asynchronen Vorgang. Diese Überladung ermöglicht es Ihnen, einen Timeoutwert für den Vorgang anzugeben. |
| SendPingAsync(String, Int32) |
Sendet eine ICMP (Internet Control Message Protocol)-Echomeldung mit dem angegebenen Datenpuffer an den angegebenen Computer und empfängt eine entsprechende ICMP-Echoantwortmeldung von diesem Computer als asynchronen Vorgang. Diese Überladung ermöglicht es Ihnen, einen Timeoutwert für den Vorgang anzugeben. |
| SendPingAsync(IPAddress, Int32, Byte[]) |
Senden Sie eine ICMP (Internet Control Message Protocol)-Echomeldung mit dem angegebenen Datenpuffer an einen Computer mit der angegebenen IPAddress und empfängt eine entsprechende ICMP-Echoantwortmeldung von diesem Computer als asynchronen Vorgang. Diese Überladung ermöglicht es Ihnen, einen Timeoutwert für den Vorgang und einen Puffer für Senden und Empfangen anzugeben. |
| SendPingAsync(String, Int32, Byte[]) |
Sendet eine ICMP (Internet Control Message Protocol)-Echomeldung mit dem angegebenen Datenpuffer an den angegebenen Computer und empfängt eine entsprechende ICMP-Echoantwortmeldung von diesem Computer als asynchronen Vorgang. Diese Überladung ermöglicht es Ihnen, einen Timeoutwert für den Vorgang und einen Puffer für Senden und Empfangen anzugeben. |
| SendPingAsync(IPAddress, Int32, Byte[], PingOptions) |
Sendet eine ICMP-Echomeldung (Internet Control Message Protocol) mit dem angegebenen Datenpuffer an einen Computer mit der angegebenen IPAddress und empfängt eine entsprechende ICMP-Echoantwortmeldung von diesem Computer als asynchronen Vorgang. Mit dieser Überladung können Sie einen Timeoutwert für den Vorgang angeben, einen Puffer zum Senden und Empfangen und die Werte für Fragmentierung und Gültigkeitsdauer des ICMP-Echomeldungspakets steuern. |
| SendPingAsync(String, Int32, Byte[], PingOptions) |
Sendet eine ICMP (Internet Control Message Protocol)-Echomeldung mit dem angegebenen Datenpuffer an den angegebenen Computer und empfängt eine entsprechende ICMP-Echoantwortmeldung von diesem Computer als asynchronen Vorgang. Mit dieser Überladung können Sie einen Timeoutwert für den Vorgang angeben, einen Puffer zum Senden und Empfangen und die Werte für Fragmentierung und Gültigkeitsdauer des ICMP-Echomeldungspakets steuern. |
| SendPingAsync(IPAddress, TimeSpan, Byte[], PingOptions, CancellationToken) |
Sendet eine ICMP-Echomeldung (Internet Control Message Protocol) mit dem angegebenen Datenpuffer an einen Computer mit der angegebenen IPAddress und empfängt eine entsprechende ICMP-Echoantwortmeldung von diesem Computer als asynchronen Vorgang. Mit dieser Überladung können Sie einen Timeoutwert für den Vorgang, einen Puffer für das Senden und Empfangen, die Steuerung der Fragmentierung und time-to-Live-Werte und einen CancellationToken für das ICMP-Echonachrichtenpaket angeben. |
Hinweise
Die von einer der SendPingAsync Methoden zurückgegebene IP-Adresse kann von einem böswilligen Remotecomputer stammen. Stellen Sie mithilfe dieses Vorgangs keine Verbindung mit dem Remotecomputer her. Verwenden Sie DNS, um die IP-Adresse des Computers zu ermitteln, mit dem Sie eine Verbindung herstellen möchten.
SendPingAsync(String, TimeSpan, Byte[], PingOptions, CancellationToken)
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
Sendet eine ICMP-Echonachricht (Internet Control Message Protocol) mit dem angegebenen Datenpuffer an den angegebenen Computer und empfängt eine entsprechende ICMP-Echoantwortmeldung von diesem Computer als asynchronen Vorgang. Mit dieser Überladung können Sie einen Timeoutwert für den Vorgang, einen Puffer für das Senden und Empfangen, die Steuerung der Fragmentierung und time-to-Live-Werte und einen CancellationToken für das ICMP-Echonachrichtenpaket angeben.
public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (string hostNameOrAddress, TimeSpan timeout, byte[]? buffer = default, System.Net.NetworkInformation.PingOptions? options = default, System.Threading.CancellationToken cancellationToken = default);member this.SendPingAsync : string * TimeSpan * byte[] * System.Net.NetworkInformation.PingOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply>Public Function SendPingAsync (hostNameOrAddress As String, timeout As TimeSpan, Optional buffer As Byte() = Nothing, Optional options As PingOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of PingReply)Parameter
- hostNameOrAddress
- String
Der Computer, der das Ziel für die ICMP-Echomeldung ist. Der für diesen Parameter angegebene Wert kann eine Hostname oder eine Zeichenfolgenentsprechung einer IP-Adresse sein.
- timeout
- TimeSpan
Die Zeitspanne (nach dem Senden der Echonachricht) auf die ICMP-Echoantwortnachricht zu warten.
- buffer
- Byte[]
Ein Byte-Array, das Daten enthält, die mit der ICMP-Echomeldung gesendet und in der ICMP-Echoantwortmeldung zurückgegeben werden sollen. Das Array kann höchstens 65.500 Bytes enthalten.
- options
- PingOptions
Ein PingOptions-Objekt, das verwendet wird, um die Werte für Fragmentierung und Gültigkeitsdauer des ICMP-Echomeldungspakets zu steuern.
- cancellationToken
- CancellationToken
Das Token zum Überwachen von Abbruchanforderungen. Der Standardwert ist None.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Gilt für:
SendPingAsync(IPAddress)
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
Senden Sie eine ICMP (Internet Control Message Protocol)-Echomeldung mit dem angegebenen Datenpuffer an einen Computer mit der angegebenen IPAddress und empfängt eine entsprechende ICMP-Echoantwortmeldung von diesem Computer als asynchronen Vorgang.
public:
System::Threading::Tasks::Task<System::Net::NetworkInformation::PingReply ^> ^ SendPingAsync(System::Net::IPAddress ^ address);public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (System.Net.IPAddress address);member this.SendPingAsync : System.Net.IPAddress -> System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply>Public Function SendPingAsync (address As IPAddress) As Task(Of PingReply)Parameter
- address
- IPAddress
Eine IP-Adresse , die den Computer bezeichnet, der das Ziel für die ICMP-Echomeldung ist.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
address ist null.
Ein Aufruf von SendPingAsync wird gerade ausgeführt.
Beim Senden oder Empfangen der ICMP-Meldungen wurde eine Ausnahme ausgelöst. Welche Ausnahme genau ausgelöst wurde, entnehmen Sie der internen Ausnahme.
address ist keine gültige IP-Adresse.
Dieses Objekt wurde verworfen.
Hinweise
Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult>> Objekt wird abgeschlossen, nachdem das ICMP-Paket gesendet und die Antwort empfangen wurde.
Gilt für:
SendPingAsync(String)
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
Sendet eine ICMP (Internet Control Message Protocol)-Echomeldung mit dem angegebenen Datenpuffer an den angegebenen Computer und empfängt eine entsprechende ICMP-Echoantwortmeldung von diesem Computer als asynchronen Vorgang.
public:
System::Threading::Tasks::Task<System::Net::NetworkInformation::PingReply ^> ^ SendPingAsync(System::String ^ hostNameOrAddress);public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (string hostNameOrAddress);member this.SendPingAsync : string -> System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply>Public Function SendPingAsync (hostNameOrAddress As String) As Task(Of PingReply)Parameter
- hostNameOrAddress
- String
Der Computer, der das Ziel für die ICMP-Echomeldung ist. Der für diesen Parameter angegebene Wert kann eine Hostname oder eine Zeichenfolgenentsprechung einer IP-Adresse sein.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
hostNameOrAddress ist null oder eine leere Zeichenfolge ("").
Ein Aufruf der SendAsync(String, Object)-Methode wird gerade ausgeführt.
Beim Senden oder Empfangen der ICMP-Meldungen wurde eine Ausnahme ausgelöst. Welche Ausnahme genau ausgelöst wurde, entnehmen Sie der internen Ausnahme.
hostNameOrAddress konnte nicht in eine gültige IP-Adresse aufgelöst werden.
Dieses Objekt wurde verworfen.
Hinweise
Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult>> Objekt wird abgeschlossen, nachdem das ICMP-Paket gesendet und die Antwort empfangen wurde.
Gilt für:
SendPingAsync(IPAddress, Int32)
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
Senden Sie eine ICMP (Internet Control Message Protocol)-Echomeldung mit dem angegebenen Datenpuffer an einen Computer mit der angegebenen IPAddress und empfängt eine entsprechende ICMP-Echoantwortmeldung von diesem Computer als asynchronen Vorgang. Diese Überladung ermöglicht es Ihnen, einen Timeoutwert für den Vorgang anzugeben.
public:
System::Threading::Tasks::Task<System::Net::NetworkInformation::PingReply ^> ^ SendPingAsync(System::Net::IPAddress ^ address, int timeout);public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (System.Net.IPAddress address, int timeout);member this.SendPingAsync : System.Net.IPAddress * int -> System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply>Public Function SendPingAsync (address As IPAddress, timeout As Integer) As Task(Of PingReply)Parameter
- address
- IPAddress
Eine IP-Adresse , die den Computer bezeichnet, der das Ziel für die ICMP-Echomeldung ist.
- timeout
- Int32
Die maximale Anzahl von Millisekunden (nach dem Senden der Echomeldung), für die auf die ICMP-Echoantwortmeldung gewartet werden soll.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
address ist null.
Ein Aufruf der SendAsync-Methode wird gerade ausgeführt.
Beim Senden oder Empfangen der ICMP-Meldungen wurde eine Ausnahme ausgelöst. Welche Ausnahme genau ausgelöst wurde, entnehmen Sie der internen Ausnahme.
address ist keine gültige IP-Adresse.
Dieses Objekt wurde verworfen.
Hinweise
Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult>> Objekt wird abgeschlossen, nachdem das ICMP-Paket gesendet und die Antwort empfangen wurde.
Gilt für:
SendPingAsync(String, Int32)
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
Sendet eine ICMP (Internet Control Message Protocol)-Echomeldung mit dem angegebenen Datenpuffer an den angegebenen Computer und empfängt eine entsprechende ICMP-Echoantwortmeldung von diesem Computer als asynchronen Vorgang. Diese Überladung ermöglicht es Ihnen, einen Timeoutwert für den Vorgang anzugeben.
public:
System::Threading::Tasks::Task<System::Net::NetworkInformation::PingReply ^> ^ SendPingAsync(System::String ^ hostNameOrAddress, int timeout);public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (string hostNameOrAddress, int timeout);member this.SendPingAsync : string * int -> System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply>Public Function SendPingAsync (hostNameOrAddress As String, timeout As Integer) As Task(Of PingReply)Parameter
- hostNameOrAddress
- String
Der Computer, der das Ziel für die ICMP-Echomeldung ist. Der für diesen Parameter angegebene Wert kann eine Hostname oder eine Zeichenfolgenentsprechung einer IP-Adresse sein.
- timeout
- Int32
Die maximale Anzahl von Millisekunden (nach dem Senden der Echomeldung), für die auf die ICMP-Echoantwortmeldung gewartet werden soll.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
address ist null.
timeout ist kleiner als Null.
Ein Aufruf der SendAsync-Methode wird gerade ausgeführt.
Beim Senden oder Empfangen der ICMP-Meldungen wurde eine Ausnahme ausgelöst. Welche Ausnahme genau ausgelöst wurde, entnehmen Sie der internen Ausnahme.
address ist keine gültige IP-Adresse.
Dieses Objekt wurde verworfen.
Hinweise
Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult>> Objekt wird abgeschlossen, nachdem das ICMP-Paket gesendet und die Antwort empfangen wurde.
Gilt für:
SendPingAsync(IPAddress, Int32, Byte[])
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
Senden Sie eine ICMP (Internet Control Message Protocol)-Echomeldung mit dem angegebenen Datenpuffer an einen Computer mit der angegebenen IPAddress und empfängt eine entsprechende ICMP-Echoantwortmeldung von diesem Computer als asynchronen Vorgang. Diese Überladung ermöglicht es Ihnen, einen Timeoutwert für den Vorgang und einen Puffer für Senden und Empfangen anzugeben.
public:
System::Threading::Tasks::Task<System::Net::NetworkInformation::PingReply ^> ^ SendPingAsync(System::Net::IPAddress ^ address, int timeout, cli::array <System::Byte> ^ buffer);public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (System.Net.IPAddress address, int timeout, byte[] buffer);member this.SendPingAsync : System.Net.IPAddress * int * byte[] -> System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply>Public Function SendPingAsync (address As IPAddress, timeout As Integer, buffer As Byte()) As Task(Of PingReply)Parameter
- address
- IPAddress
Eine IP-Adresse , die den Computer bezeichnet, der das Ziel für die ICMP-Echomeldung ist.
- timeout
- Int32
Die maximale Anzahl von Millisekunden (nach dem Senden der Echomeldung), für die auf die ICMP-Echoantwortmeldung gewartet werden soll.
- buffer
- Byte[]
Ein Byte-Array, das Daten enthält, die mit der ICMP-Echomeldung gesendet und in der ICMP-Echoantwortmeldung zurückgegeben werden sollen. Das Array kann höchstens 65.500 Bytes enthalten.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
address oder buffer ist null.
timeout ist kleiner als Null.
Ein Aufruf von SendPingAsync wird gerade ausgeführt.
Beim Senden oder Empfangen der ICMP-Meldungen wurde eine Ausnahme ausgelöst. Welche Ausnahme genau ausgelöst wurde, entnehmen Sie der internen Ausnahme.
address ist keine gültige IP-Adresse.
Dieses Objekt wurde verworfen.
Die Größe von buffer übersteigt 65.500 Bytes.
.NET 7 und höhere Versionen nur unter Linux: Der Prozess ist nicht privilegiert und buffer nicht leer.
Hinweise
Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult>> Objekt wird abgeschlossen, nachdem das ICMP-Paket gesendet und die Antwort empfangen wurde.
Gilt für:
SendPingAsync(String, Int32, Byte[])
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
Sendet eine ICMP (Internet Control Message Protocol)-Echomeldung mit dem angegebenen Datenpuffer an den angegebenen Computer und empfängt eine entsprechende ICMP-Echoantwortmeldung von diesem Computer als asynchronen Vorgang. Diese Überladung ermöglicht es Ihnen, einen Timeoutwert für den Vorgang und einen Puffer für Senden und Empfangen anzugeben.
public:
System::Threading::Tasks::Task<System::Net::NetworkInformation::PingReply ^> ^ SendPingAsync(System::String ^ hostNameOrAddress, int timeout, cli::array <System::Byte> ^ buffer);public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (string hostNameOrAddress, int timeout, byte[] buffer);member this.SendPingAsync : string * int * byte[] -> System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply>Public Function SendPingAsync (hostNameOrAddress As String, timeout As Integer, buffer As Byte()) As Task(Of PingReply)Parameter
- hostNameOrAddress
- String
Der Computer, der das Ziel für die ICMP-Echomeldung ist. Der für diesen Parameter angegebene Wert kann eine Hostname oder eine Zeichenfolgenentsprechung einer IP-Adresse sein.
- timeout
- Int32
Die maximale Anzahl von Millisekunden (nach dem Senden der Echomeldung), für die auf die ICMP-Echoantwortmeldung gewartet werden soll.
- buffer
- Byte[]
Ein Byte-Array, das Daten enthält, die mit der ICMP-Echomeldung gesendet und in der ICMP-Echoantwortmeldung zurückgegeben werden sollen. Das Array kann höchstens 65.500 Bytes enthalten.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
hostNameOrAddress ist null oder eine leere Zeichenfolge ("").
- oder -
buffer ist null.
timeout ist kleiner als Null.
Ein Aufruf von SendAsync wird gerade ausgeführt.
Beim Senden oder Empfangen der ICMP-Meldungen wurde eine Ausnahme ausgelöst. Welche Ausnahme genau ausgelöst wurde, entnehmen Sie der internen Ausnahme.
hostNameOrAddress konnte nicht in eine gültige IP-Adresse aufgelöst werden.
Dieses Objekt wurde verworfen.
Die Größe des buffer übersteigt 65.500 Bytes.
.NET 7 und höhere Versionen nur unter Linux: Der Prozess ist nicht privilegiert und buffer nicht leer.
Hinweise
Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult>> Objekt wird abgeschlossen, nachdem das ICMP-Paket gesendet und die Antwort empfangen wurde.
Gilt für:
SendPingAsync(IPAddress, Int32, Byte[], PingOptions)
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
Sendet eine ICMP-Echomeldung (Internet Control Message Protocol) mit dem angegebenen Datenpuffer an einen Computer mit der angegebenen IPAddress und empfängt eine entsprechende ICMP-Echoantwortmeldung von diesem Computer als asynchronen Vorgang. Mit dieser Überladung können Sie einen Timeoutwert für den Vorgang angeben, einen Puffer zum Senden und Empfangen und die Werte für Fragmentierung und Gültigkeitsdauer des ICMP-Echomeldungspakets steuern.
public:
System::Threading::Tasks::Task<System::Net::NetworkInformation::PingReply ^> ^ SendPingAsync(System::Net::IPAddress ^ address, int timeout, cli::array <System::Byte> ^ buffer, System::Net::NetworkInformation::PingOptions ^ options);public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (System.Net.IPAddress address, int timeout, byte[] buffer, System.Net.NetworkInformation.PingOptions? options);public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (System.Net.IPAddress address, int timeout, byte[] buffer, System.Net.NetworkInformation.PingOptions options);member this.SendPingAsync : System.Net.IPAddress * int * byte[] * System.Net.NetworkInformation.PingOptions -> System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply>Public Function SendPingAsync (address As IPAddress, timeout As Integer, buffer As Byte(), options As PingOptions) As Task(Of PingReply)Parameter
- address
- IPAddress
Eine IP-Adresse , die den Computer bezeichnet, der das Ziel für die ICMP-Echomeldung ist.
- timeout
- Int32
Die maximale Anzahl von Millisekunden (nach dem Senden der Echomeldung), für die auf die ICMP-Echoantwortmeldung gewartet werden soll.
- buffer
- Byte[]
Ein Byte-Array, das Daten enthält, die mit der ICMP-Echomeldung gesendet und in der ICMP-Echoantwortmeldung zurückgegeben werden sollen. Das Array kann höchstens 65.500 Bytes enthalten.
- options
- PingOptions
Ein PingOptions-Objekt, das verwendet wird, um die Werte für Fragmentierung und Gültigkeitsdauer des ICMP-Echomeldungspakets zu steuern.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
address oder buffer ist null.
timeout ist kleiner als Null.
Ein Aufruf von SendPingAsync wird gerade ausgeführt.
Beim Senden oder Empfangen der ICMP-Meldungen wurde eine Ausnahme ausgelöst. Welche Ausnahme genau ausgelöst wurde, entnehmen Sie der internen Ausnahme.
address ist keine gültige IP-Adresse.
Dieses Objekt wurde verworfen.
Die Größe von buffer übersteigt 65.500 Bytes.
.NET 7 und höhere Versionen nur unter Linux: Der Prozess ist nicht privilegiert und buffer nicht leer.
Hinweise
Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult>> Objekt wird abgeschlossen, nachdem das ICMP-Paket gesendet und die Antwort empfangen wurde.
Gilt für:
SendPingAsync(String, Int32, Byte[], PingOptions)
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
Sendet eine ICMP (Internet Control Message Protocol)-Echomeldung mit dem angegebenen Datenpuffer an den angegebenen Computer und empfängt eine entsprechende ICMP-Echoantwortmeldung von diesem Computer als asynchronen Vorgang. Mit dieser Überladung können Sie einen Timeoutwert für den Vorgang angeben, einen Puffer zum Senden und Empfangen und die Werte für Fragmentierung und Gültigkeitsdauer des ICMP-Echomeldungspakets steuern.
public:
System::Threading::Tasks::Task<System::Net::NetworkInformation::PingReply ^> ^ SendPingAsync(System::String ^ hostNameOrAddress, int timeout, cli::array <System::Byte> ^ buffer, System::Net::NetworkInformation::PingOptions ^ options);public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (string hostNameOrAddress, int timeout, byte[] buffer, System.Net.NetworkInformation.PingOptions? options);public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (string hostNameOrAddress, int timeout, byte[] buffer, System.Net.NetworkInformation.PingOptions options);member this.SendPingAsync : string * int * byte[] * System.Net.NetworkInformation.PingOptions -> System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply>Public Function SendPingAsync (hostNameOrAddress As String, timeout As Integer, buffer As Byte(), options As PingOptions) As Task(Of PingReply)Parameter
- hostNameOrAddress
- String
Der Computer, der das Ziel für die ICMP-Echomeldung ist. Der für diesen Parameter angegebene Wert kann eine Hostname oder eine Zeichenfolgenentsprechung einer IP-Adresse sein.
- timeout
- Int32
Die maximale Anzahl von Millisekunden (nach dem Senden der Echomeldung), für die auf die ICMP-Echoantwortmeldung gewartet werden soll.
- buffer
- Byte[]
Ein Byte-Array, das Daten enthält, die mit der ICMP-Echomeldung gesendet und in der ICMP-Echoantwortmeldung zurückgegeben werden sollen. Das Array kann höchstens 65.500 Bytes enthalten.
- options
- PingOptions
Ein PingOptions-Objekt, das verwendet wird, um die Werte für Fragmentierung und Gültigkeitsdauer des ICMP-Echomeldungspakets zu steuern.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
hostNameOrAddress ist null oder eine leere Zeichenfolge ("").
- oder -
buffer ist null.
timeout ist kleiner als Null.
Ein Aufruf von SendAsync wird gerade ausgeführt.
Beim Senden oder Empfangen der ICMP-Meldungen wurde eine Ausnahme ausgelöst. Welche Ausnahme genau ausgelöst wurde, entnehmen Sie der internen Ausnahme.
hostNameOrAddress konnte nicht in eine gültige IP-Adresse aufgelöst werden.
Dieses Objekt wurde verworfen.
Die Größe des buffer übersteigt 65.500 Bytes.
.NET 7 und höhere Versionen nur unter Linux: Der Prozess ist nicht privilegiert und buffer nicht leer.
Hinweise
Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult>> Objekt wird abgeschlossen, nachdem das ICMP-Paket gesendet und die Antwort empfangen wurde.
Gilt für:
SendPingAsync(IPAddress, TimeSpan, Byte[], PingOptions, CancellationToken)
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
Sendet eine ICMP-Echomeldung (Internet Control Message Protocol) mit dem angegebenen Datenpuffer an einen Computer mit der angegebenen IPAddress und empfängt eine entsprechende ICMP-Echoantwortmeldung von diesem Computer als asynchronen Vorgang. Mit dieser Überladung können Sie einen Timeoutwert für den Vorgang, einen Puffer zum Senden und Empfangen, die Fragmentierung und Time-to-Live-Werte und einen CancellationToken für das ICMP-Echonachrichtenpaket angeben.
public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (System.Net.IPAddress address, TimeSpan timeout, byte[]? buffer = default, System.Net.NetworkInformation.PingOptions? options = default, System.Threading.CancellationToken cancellationToken = default);member this.SendPingAsync : System.Net.IPAddress * TimeSpan * byte[] * System.Net.NetworkInformation.PingOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply>Public Function SendPingAsync (address As IPAddress, timeout As TimeSpan, Optional buffer As Byte() = Nothing, Optional options As PingOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of PingReply)Parameter
- address
- IPAddress
Eine IP-Adresse , die den Computer bezeichnet, der das Ziel für die ICMP-Echomeldung ist.
- timeout
- TimeSpan
Die Zeitspanne (nach dem Senden der Echonachricht), die auf die ICMP-Echoantwortnachricht gewartet werden soll.
- buffer
- Byte[]
Ein Byte-Array, das Daten enthält, die mit der ICMP-Echomeldung gesendet und in der ICMP-Echoantwortmeldung zurückgegeben werden sollen. Das Array kann höchstens 65.500 Bytes enthalten.
- options
- PingOptions
Ein PingOptions-Objekt, das verwendet wird, um die Werte für Fragmentierung und Gültigkeitsdauer des ICMP-Echomeldungspakets zu steuern.
- cancellationToken
- CancellationToken
Das Token zum Überwachen von Abbruchanforderungen. Der Standardwert ist None.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
