Ping.SendPingAsync Methode

Definition

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-Echoantwortnachricht 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.

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 zum Senden und Empfangen, die 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)

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 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 (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), 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.

Gilt für:

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.

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)

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)

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)

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[])

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[])

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)

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)

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)

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.

Gilt für: