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-Echonachricht (Internet Control Message Protocol) an einen Computer und empfängt eine entsprechende ICMP-Echoantwortnachricht von diesem Computer als asynchronen Vorgang.
Überlädt
| Name | Beschreibung |
|---|---|
| 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-Echoantwortnachricht von diesem Computer als asynchronen Vorgang. Mit dieser Überladung können Sie einen Timeoutwert für den Vorgang, einen Puffer angeben, der zum Senden und Empfangen verwendet werden soll, die Fragmentierung und Time-to-Live-Werte sowie ein CancellationToken Für das ICMP-Echonachrichtenpaket. |
| SendPingAsync(IPAddress) |
Senden Sie eine ICMP-Echonachricht (Internet Control Message Protocol) mit dem angegebenen Datenpuffer an den Computer, auf dem der angegebene Datenpuffer angegeben IPAddressist, und empfängt eine entsprechende ICMP-Echoantwortnachricht von diesem Computer als asynchronen Vorgang. |
| SendPingAsync(String) |
Sendet eine ICMP-Echonachricht (Internet Control Message Protocol) mit dem angegebenen Datenpuffer an den angegebenen Computer und empfängt eine entsprechende ICMP-Echoantwortnachricht von diesem Computer als asynchronen Vorgang. |
| SendPingAsync(IPAddress, Int32) |
Senden Sie eine ICMP-Echonachricht (Internet Control Message Protocol) mit dem angegebenen Datenpuffer an den Computer, auf dem der angegebene Datenpuffer angegeben IPAddressist, und empfängt eine entsprechende ICMP-Echoantwortnachricht von diesem Computer als asynchronen Vorgang. Mit dieser Überladung können Sie einen Timeoutwert für den Vorgang angeben. |
| SendPingAsync(String, Int32) |
Sendet eine ICMP-Echonachricht (Internet Control Message Protocol) mit dem angegebenen Datenpuffer an den angegebenen Computer und empfängt eine entsprechende ICMP-Echoantwortnachricht von diesem Computer als asynchronen Vorgang. Mit dieser Überladung können Sie einen Timeoutwert für den Vorgang angeben. |
| SendPingAsync(IPAddress, Int32, Byte[]) |
Senden Sie eine ICMP-Echonachricht (Internet Control Message Protocol) mit dem angegebenen Datenpuffer an den Computer, auf dem der angegebene Datenpuffer angegeben IPAddressist, und empfängt eine entsprechende ICMP-Echoantwortnachricht von diesem Computer als asynchronen Vorgang. Mit dieser Überladung können Sie einen Timeoutwert für den Vorgang und einen Puffer angeben, der zum Senden und Empfangen verwendet werden soll. |
| SendPingAsync(String, Int32, Byte[]) |
Sendet eine ICMP-Echonachricht (Internet Control Message Protocol) mit dem angegebenen Datenpuffer an den angegebenen Computer und empfängt eine entsprechende ICMP-Echoantwortnachricht von diesem Computer als asynchronen Vorgang. Mit dieser Überladung können Sie einen Timeoutwert für den Vorgang und einen Puffer angeben, der zum Senden und Empfangen verwendet werden soll. |
| SendPingAsync(IPAddress, Int32, Byte[], PingOptions) |
Sendet eine ICMP-Echonachricht (Internet Control Message Protocol) mit dem angegebenen Datenpuffer an den Computer, auf dem der angegebene Datenpuffer angegeben IPAddressist, und empfängt eine entsprechende ICMP-Echoantwortnachricht von diesem Computer als asynchronen Vorgang. Mit dieser Überladung können Sie einen Timeoutwert für den Vorgang, einen Puffer angeben, der zum Senden und Empfangen verwendet werden soll, sowie Fragmentierung und Time-to-Live-Werte für das ICMP-Echonachrichtenpaket steuern. |
| SendPingAsync(String, Int32, Byte[], PingOptions) |
Sendet eine ICMP-Echonachricht (Internet Control Message Protocol) mit dem angegebenen Datenpuffer an den angegebenen Computer und empfängt eine entsprechende ICMP-Echoantwortnachricht von diesem Computer als asynchronen Vorgang. Mit dieser Überladung können Sie einen Timeoutwert für den Vorgang, einen Puffer angeben, der zum Senden und Empfangen verwendet werden soll, sowie Fragmentierung und Time-to-Live-Werte für das ICMP-Echonachrichtenpaket steuern. |
| SendPingAsync(IPAddress, TimeSpan, Byte[], PingOptions, CancellationToken) |
Sendet eine ICMP-Echonachricht (Internet Control Message Protocol) mit dem angegebenen Datenpuffer an den Computer, auf dem der angegebene Datenpuffer angegeben IPAddressist, und empfängt eine entsprechende ICMP-Echoantwortnachricht von diesem Computer als asynchronen Vorgang. Mit dieser Überladung können Sie einen Timeoutwert für den Vorgang, einen Puffer angeben, der zum Senden und Empfangen verwendet werden soll, die Fragmentierung und Time-to-Live-Werte sowie ein CancellationToken Für das ICMP-Echonachrichtenpaket. |
Hinweise
Die von einer der SendPingAsync Methoden zurückgegebene IP-Adresse kann von einem schädlichen Remotecomputer stammen. Stellen Sie keine Verbindung mit dem Remotecomputer her, indem Sie dies verwenden. 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
- 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-Echoantwortnachricht von diesem Computer als asynchronen Vorgang. Mit dieser Überladung können Sie einen Timeoutwert für den Vorgang, einen Puffer angeben, der zum Senden und Empfangen verwendet werden soll, die Fragmentierung und Time-to-Live-Werte sowie ein CancellationToken Für das ICMP-Echonachrichtenpaket.
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-Echonachricht ist. Der für diesen Parameter angegebene Wert kann ein Hostname oder eine Zeichenfolgendarstellung 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-Echonachricht gesendet und in der ICMP-Echoantwortnachricht zurückgegeben werden sollen. Das Array darf nicht mehr als 65.500 Bytes enthalten.
- options
- PingOptions
Ein PingOptions Objekt, das verwendet wird, um Fragmentierung und Time-to-Live-Werte für das ICMP-Echonachrichtenpaket zu steuern.
- cancellationToken
- CancellationToken
Das Token, das auf Abbruchanforderungen überwacht werden soll. 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
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
Senden Sie eine ICMP-Echonachricht (Internet Control Message Protocol) mit dem angegebenen Datenpuffer an den Computer, auf dem der angegebene Datenpuffer angegeben IPAddressist, und empfängt eine entsprechende ICMP-Echoantwortnachricht 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 identifiziert, der das Ziel für die ICMP-Echonachricht ist.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
address ist null.
Ein Aufruf SendPingAsync wird ausgeführt.
Beim Senden oder Empfangen der ICMP-Nachrichten wurde eine Ausnahme ausgelöst. Sehen Sie sich die innere Ausnahme für die genaue Ausnahme an, die ausgelöst wurde.
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 wurde und die Antwort empfangen wurde.
Gilt für:
SendPingAsync(String)
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
- 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-Echoantwortnachricht 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-Echonachricht ist. Der für diesen Parameter angegebene Wert kann ein Hostname oder eine Zeichenfolgendarstellung einer IP-Adresse sein.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
hostNameOrAddress ist null oder ist eine leere Zeichenfolge ("").
Ein Aufruf der SendAsync(String, Object) Methode wird ausgeführt.
Beim Senden oder Empfangen der ICMP-Nachrichten wurde eine Ausnahme ausgelöst. Sehen Sie sich die innere Ausnahme für die genaue Ausnahme an, die ausgelöst wurde.
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 wurde und die Antwort empfangen wurde.
Gilt für:
SendPingAsync(IPAddress, Int32)
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
Senden Sie eine ICMP-Echonachricht (Internet Control Message Protocol) mit dem angegebenen Datenpuffer an den Computer, auf dem der angegebene Datenpuffer angegeben IPAddressist, und empfängt eine entsprechende ICMP-Echoantwortnachricht von diesem Computer als asynchronen Vorgang. Mit dieser Überladung können Sie einen Timeoutwert für den Vorgang angeben.
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 identifiziert, der das Ziel für die ICMP-Echonachricht ist.
- timeout
- Int32
Die maximale Anzahl von Millisekunden (nach dem Senden der Echonachricht), um auf die ICMP-Echoantwortnachricht zu warten.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
address ist null.
Ein Aufruf der SendAsync Methode wird ausgeführt.
Beim Senden oder Empfangen der ICMP-Nachrichten wurde eine Ausnahme ausgelöst. Sehen Sie sich die innere Ausnahme für die genaue Ausnahme an, die ausgelöst wurde.
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 wurde und die Antwort empfangen wurde.
Gilt für:
SendPingAsync(String, Int32)
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
- 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-Echoantwortnachricht von diesem Computer als asynchronen Vorgang. Mit dieser Überladung können Sie einen Timeoutwert für den Vorgang angeben.
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-Echonachricht ist. Der für diesen Parameter angegebene Wert kann ein Hostname oder eine Zeichenfolgendarstellung einer IP-Adresse sein.
- timeout
- Int32
Die maximale Anzahl von Millisekunden (nach dem Senden der Echonachricht), um auf die ICMP-Echoantwortnachricht zu warten.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
hostNameOrAddress ist null.
timeout ist kleiner als 0 (null).
Ein Aufruf der SendAsync Methode wird ausgeführt.
Beim Senden oder Empfangen der ICMP-Nachrichten wurde eine Ausnahme ausgelöst. Sehen Sie sich die innere Ausnahme für die genaue Ausnahme an, die ausgelöst wurde.
hostNameOrAddress 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 wurde und die Antwort empfangen wurde.
Gilt für:
SendPingAsync(IPAddress, Int32, Byte[])
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
Senden Sie eine ICMP-Echonachricht (Internet Control Message Protocol) mit dem angegebenen Datenpuffer an den Computer, auf dem der angegebene Datenpuffer angegeben IPAddressist, und empfängt eine entsprechende ICMP-Echoantwortnachricht von diesem Computer als asynchronen Vorgang. Mit dieser Überladung können Sie einen Timeoutwert für den Vorgang und einen Puffer angeben, der zum Senden und Empfangen verwendet werden soll.
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 identifiziert, der das Ziel für die ICMP-Echonachricht ist.
- timeout
- Int32
Die maximale Anzahl von Millisekunden (nach dem Senden der Echonachricht), um auf die ICMP-Echoantwortnachricht zu warten.
- buffer
- Byte[]
Ein Byte Array, das Daten enthält, die mit der ICMP-Echonachricht gesendet und in der ICMP-Echoantwortnachricht zurückgegeben werden sollen. Das Array darf nicht mehr als 65.500 Bytes enthalten.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
address oder buffer ist null.
timeout ist kleiner als 0 (null).
Ein Aufruf SendPingAsync wird ausgeführt.
Beim Senden oder Empfangen der ICMP-Nachrichten wurde eine Ausnahme ausgelöst. Sehen Sie sich die innere Ausnahme für die genaue Ausnahme an, die ausgelöst wurde.
address ist keine gültige IP-Adresse.
Dieses Objekt wurde verworfen.
Die Größe von buffer 65.500 Bytes überschreitet.
.NET 7 und höhere Versionen nur unter Linux: Der Prozess ist nicht privilegierter Und buffer nicht leer.
Hinweise
Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult>> Objekt wird abgeschlossen, nachdem das ICMP-Paket gesendet wurde und die Antwort empfangen wurde.
Gilt für:
SendPingAsync(String, Int32, Byte[])
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
- 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-Echoantwortnachricht von diesem Computer als asynchronen Vorgang. Mit dieser Überladung können Sie einen Timeoutwert für den Vorgang und einen Puffer angeben, der zum Senden und Empfangen verwendet werden soll.
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-Echonachricht ist. Der für diesen Parameter angegebene Wert kann ein Hostname oder eine Zeichenfolgendarstellung einer IP-Adresse sein.
- timeout
- Int32
Die maximale Anzahl von Millisekunden (nach dem Senden der Echonachricht), um auf die ICMP-Echoantwortnachricht zu warten.
- buffer
- Byte[]
Ein Byte Array, das Daten enthält, die mit der ICMP-Echonachricht gesendet und in der ICMP-Echoantwortnachricht zurückgegeben werden sollen. Das Array darf nicht mehr als 65.500 Bytes enthalten.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
hostNameOrAddress ist null oder ist eine leere Zeichenfolge ("").
-oder-
buffer ist null.
timeout ist kleiner als 0 (null).
Ein Aufruf SendAsync wird ausgeführt.
Beim Senden oder Empfangen der ICMP-Nachrichten wurde eine Ausnahme ausgelöst. Sehen Sie sich die innere Ausnahme für die genaue Ausnahme an, die ausgelöst wurde.
hostNameOrAddress konnte nicht in eine gültige IP-Adresse aufgelöst werden.
Dieses Objekt wurde verworfen.
Die Größe von buffer 65500 Bytes überschreitet.
.NET 7 und höhere Versionen nur unter Linux: Der Prozess ist nicht privilegierter Und buffer nicht leer.
Hinweise
Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult>> Objekt wird abgeschlossen, nachdem das ICMP-Paket gesendet wurde und die Antwort empfangen wurde.
Gilt für:
SendPingAsync(IPAddress, Int32, Byte[], PingOptions)
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
Sendet eine ICMP-Echonachricht (Internet Control Message Protocol) mit dem angegebenen Datenpuffer an den Computer, auf dem der angegebene Datenpuffer angegeben IPAddressist, und empfängt eine entsprechende ICMP-Echoantwortnachricht von diesem Computer als asynchronen Vorgang. Mit dieser Überladung können Sie einen Timeoutwert für den Vorgang, einen Puffer angeben, der zum Senden und Empfangen verwendet werden soll, sowie Fragmentierung und Time-to-Live-Werte für das ICMP-Echonachrichtenpaket 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 identifiziert, der das Ziel für die ICMP-Echonachricht ist.
- timeout
- Int32
Die maximale Anzahl von Millisekunden (nach dem Senden der Echonachricht), um auf die ICMP-Echoantwortnachricht zu warten.
- buffer
- Byte[]
Ein Byte Array, das Daten enthält, die mit der ICMP-Echonachricht gesendet und in der ICMP-Echoantwortnachricht zurückgegeben werden sollen. Das Array darf nicht mehr als 65.500 Bytes enthalten.
- options
- PingOptions
Ein PingOptions Objekt, das verwendet wird, um Fragmentierung und Time-to-Live-Werte für das ICMP-Echonachrichtenpaket zu steuern.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
address oder buffer ist null.
timeout ist kleiner als 0 (null).
Ein Aufruf SendPingAsync wird ausgeführt.
Beim Senden oder Empfangen der ICMP-Nachrichten wurde eine Ausnahme ausgelöst. Sehen Sie sich die innere Ausnahme für die genaue Ausnahme an, die ausgelöst wurde.
address ist keine gültige IP-Adresse.
Dieses Objekt wurde verworfen.
Die Größe von buffer 65.500 Bytes überschreitet.
.NET 7 und höhere Versionen nur unter Linux: Der Prozess ist nicht privilegierter Und buffer nicht leer.
Hinweise
Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult>> Objekt wird abgeschlossen, nachdem das ICMP-Paket gesendet wurde und die Antwort empfangen wurde.
Gilt für:
SendPingAsync(String, Int32, Byte[], PingOptions)
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
- 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-Echoantwortnachricht von diesem Computer als asynchronen Vorgang. Mit dieser Überladung können Sie einen Timeoutwert für den Vorgang, einen Puffer angeben, der zum Senden und Empfangen verwendet werden soll, sowie Fragmentierung und Time-to-Live-Werte für das ICMP-Echonachrichtenpaket 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-Echonachricht ist. Der für diesen Parameter angegebene Wert kann ein Hostname oder eine Zeichenfolgendarstellung einer IP-Adresse sein.
- timeout
- Int32
Die maximale Anzahl von Millisekunden (nach dem Senden der Echonachricht), um auf die ICMP-Echoantwortnachricht zu warten.
- buffer
- Byte[]
Ein Byte Array, das Daten enthält, die mit der ICMP-Echonachricht gesendet und in der ICMP-Echoantwortnachricht zurückgegeben werden sollen. Das Array darf nicht mehr als 65.500 Bytes enthalten.
- options
- PingOptions
Ein PingOptions Objekt, das verwendet wird, um Fragmentierung und Time-to-Live-Werte für das ICMP-Echonachrichtenpaket zu steuern.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
hostNameOrAddress ist null oder ist eine leere Zeichenfolge ("").
-oder-
buffer ist null.
timeout ist kleiner als 0 (null).
Ein Aufruf SendAsync wird ausgeführt.
Beim Senden oder Empfangen der ICMP-Nachrichten wurde eine Ausnahme ausgelöst. Sehen Sie sich die innere Ausnahme für die genaue Ausnahme an, die ausgelöst wurde.
hostNameOrAddress konnte nicht in eine gültige IP-Adresse aufgelöst werden.
Dieses Objekt wurde verworfen.
Die Größe von buffer 65500 Bytes überschreitet.
.NET 7 und höhere Versionen nur unter Linux: Der Prozess ist nicht privilegierter Und buffer nicht leer.
Hinweise
Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult>> Objekt wird abgeschlossen, nachdem das ICMP-Paket gesendet wurde und die Antwort empfangen wurde.
Gilt für:
SendPingAsync(IPAddress, TimeSpan, Byte[], PingOptions, CancellationToken)
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
- Quelle:
- Ping.cs
Sendet eine ICMP-Echonachricht (Internet Control Message Protocol) mit dem angegebenen Datenpuffer an den Computer, auf dem der angegebene Datenpuffer angegeben IPAddressist, und empfängt eine entsprechende ICMP-Echoantwortnachricht von diesem Computer als asynchronen Vorgang. Mit dieser Überladung können Sie einen Timeoutwert für den Vorgang, einen Puffer angeben, der zum Senden und Empfangen verwendet werden soll, die Fragmentierung und Time-to-Live-Werte sowie ein CancellationToken Für das ICMP-Echonachrichtenpaket.
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 identifiziert, der das Ziel für die ICMP-Echonachricht ist.
- 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-Echonachricht gesendet und in der ICMP-Echoantwortnachricht zurückgegeben werden sollen. Das Array darf nicht mehr als 65.500 Bytes enthalten.
- options
- PingOptions
Ein PingOptions Objekt, das verwendet wird, um Fragmentierung und Time-to-Live-Werte für das ICMP-Echonachrichtenpaket zu steuern.
- cancellationToken
- CancellationToken
Das Token, das auf Abbruchanforderungen überwacht werden soll. 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.
