Ping.SendPingAsync Método

Definición

Envía un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) al equipo especificado y recibe un mensaje de respuesta de eco ICMP correspondiente de dicho equipo como una operación asincrónica.

Sobrecargas

SendPingAsync(String, TimeSpan, Byte[], PingOptions, CancellationToken)

Envía un mensaje de eco del Protocolo de mensajes de control de Internet (ICMP) con el búfer de datos especificado al equipo especificado y recibe un mensaje de respuesta de eco ICMP correspondiente de ese equipo como una operación asincrónica. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación, un búfer que se usará para enviar y recibir, controlar la fragmentación y los valores de período de vida, y un CancellationToken para el paquete de mensajes de eco ICMP.

SendPingAsync(IPAddress)

Envía un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo que tiene la IPAddress especificada, y recibe el correspondiente mensaje de respuesta de eco ICMP de ese equipo como una operación asincrónica.

SendPingAsync(String)

Envía un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo especificado, y recibe el correspondiente mensaje de respuesta de eco ICMP de ese equipo como una operación asincrónica.

SendPingAsync(IPAddress, Int32)

Envía un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo que tiene la IPAddress especificada, y recibe el correspondiente mensaje de respuesta de eco ICMP de ese equipo como una operación asincrónica. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación.

SendPingAsync(String, Int32)

Envía un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo especificado, y recibe el correspondiente mensaje de respuesta de eco ICMP de ese equipo como una operación asincrónica. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación.

SendPingAsync(IPAddress, Int32, Byte[])

Envía un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo que tiene la IPAddress especificada, y recibe el correspondiente mensaje de respuesta de eco ICMP de ese equipo como una operación asincrónica. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación y un búfer para enviar y recibir.

SendPingAsync(String, Int32, Byte[])

Envía un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo especificado, y recibe el correspondiente mensaje de respuesta de eco ICMP de ese equipo como una operación asincrónica. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación y un búfer para enviar y recibir.

SendPingAsync(IPAddress, Int32, Byte[], PingOptions)

Envía un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo que tiene el elemento IPAddress especificado y recibe el correspondiente mensaje de respuesta de eco ICMP de ese equipo como una operación asincrónica. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación y un búfer para enviar y recibir y controlar los valores de Período de vida y fragmentación para el paquete del mensaje de eco ICMP.

SendPingAsync(String, Int32, Byte[], PingOptions)

Envía un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo especificado, y recibe el correspondiente mensaje de respuesta de eco ICMP de ese equipo como una operación asincrónica. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación y un búfer para enviar y recibir y controlar los valores de Período de vida y fragmentación para el paquete del mensaje de eco ICMP.

SendPingAsync(IPAddress, TimeSpan, Byte[], PingOptions, CancellationToken)

Envía un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo que tiene el elemento IPAddress especificado y recibe el correspondiente mensaje de respuesta de eco ICMP de ese equipo como una operación asincrónica. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación, un búfer que se usará para enviar y recibir, controlar la fragmentación y los valores de período de vida, y un CancellationToken para el paquete de mensajes de eco ICMP.

Comentarios

La dirección IP devuelta por cualquiera de los SendPingAsync métodos puede originarse en un equipo remoto malintencionado. No se conecte al equipo remoto con esto. Use DNS para determinar la dirección IP de la máquina a la que desea conectarse.

SendPingAsync(String, TimeSpan, Byte[], PingOptions, CancellationToken)

Source:
Ping.cs
Source:
Ping.cs

Envía un mensaje de eco del Protocolo de mensajes de control de Internet (ICMP) con el búfer de datos especificado al equipo especificado y recibe un mensaje de respuesta de eco ICMP correspondiente de ese equipo como una operación asincrónica. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación, un búfer que se usará para enviar y recibir, controlar la fragmentación y los valores de período de vida, y un CancellationToken para el paquete de mensajes de eco ICMP.

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)

Parámetros

hostNameOrAddress
String

El equipo que es el destino del mensaje de la generación de repetición de ICMP. El valor especificado para este parámetro puede ser un nombre de host o una representación de cadena de una dirección IP.

timeout
TimeSpan

Cantidad de tiempo (después de enviar el mensaje de eco) para esperar el mensaje de respuesta de eco ICMP.

buffer
Byte[]

Matriz de Byte que contiene los datos que se envían con el mensaje de eco ICMP y se devuelven en el mensaje de respuesta de eco ICMP. La matriz no puede contener más de 65.500 bytes.

options
PingOptions

Objeto PingOptions que se usa para controlar los valores de Período de vida y fragmentación del paquete de mensaje de eco ICMP.

cancellationToken
CancellationToken

Token para supervisar solicitudes de cancelación. El valor predeterminado es None.

Devoluciones

Objeto de tarea que representa la operación asincrónica.

Excepciones

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Se aplica a

SendPingAsync(IPAddress)

Source:
Ping.cs
Source:
Ping.cs
Source:
Ping.cs

Envía un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo que tiene la IPAddress especificada, y recibe el correspondiente mensaje de respuesta de eco ICMP de ese equipo como una operación asincrónica.

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)

Parámetros

address
IPAddress

Dirección IP que identifica el equipo de destino para el mensaje de eco ICMP.

Devoluciones

Objeto de tarea que representa la operación asincrónica.

Excepciones

address es null.

Se está realizando una llamada a SendPingAsync.

Se ha producido una excepción al enviar o recibir los mensajes ICMP. Para conocer la excepción exacta que se produjo, vea la excepción interna.

El valor de address no es una dirección IP válida.

Este objeto se ha eliminado.

Comentarios

Esta operación no se bloqueará. El objeto devuelto se completará una vez enviado Task<TResult>> el paquete ICMP y se haya recibido la respuesta.

Se aplica a

SendPingAsync(String)

Source:
Ping.cs
Source:
Ping.cs
Source:
Ping.cs

Envía un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo especificado, y recibe el correspondiente mensaje de respuesta de eco ICMP de ese equipo como una operación asincrónica.

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)

Parámetros

hostNameOrAddress
String

El equipo que es el destino del mensaje de la generación de repetición de ICMP. El valor especificado para este parámetro puede ser un nombre de host o una representación de cadena de una dirección IP.

Devoluciones

Objeto de tarea que representa la operación asincrónica.

Excepciones

hostNameOrAddress es null o una cadena vacía ("").

Se está realizando una llamada al método SendAsync(String, Object).

Se ha producido una excepción al enviar o recibir los mensajes ICMP. Para conocer la excepción exacta que se produjo, vea la excepción interna.

hostNameOrAddress no pudo resolverse en una dirección IP válida.

Este objeto se ha eliminado.

Comentarios

Esta operación no se bloqueará. El objeto devuelto se completará una vez enviado Task<TResult>> el paquete ICMP y se haya recibido la respuesta.

Se aplica a

SendPingAsync(IPAddress, Int32)

Source:
Ping.cs
Source:
Ping.cs
Source:
Ping.cs

Envía un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo que tiene la IPAddress especificada, y recibe el correspondiente mensaje de respuesta de eco ICMP de ese equipo como una operación asincrónica. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación.

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)

Parámetros

address
IPAddress

Dirección IP que identifica el equipo de destino para el mensaje de eco ICMP.

timeout
Int32

El número máximo de milisegundos (después de enviar el mensaje de eco) que hay que esperar hasta recibir el mensaje de respuesta de eco ICMP.

Devoluciones

Objeto de tarea que representa la operación asincrónica.

Excepciones

address es null.

Se está realizando una llamada a SendAsync.

Se ha producido una excepción al enviar o recibir los mensajes ICMP. Para conocer la excepción exacta que se produjo, vea la excepción interna.

El valor de address no es una dirección IP válida.

Este objeto se ha eliminado.

Comentarios

Esta operación no se bloqueará. El objeto devuelto se completará una vez enviado Task<TResult>> el paquete ICMP y se haya recibido la respuesta.

Se aplica a

SendPingAsync(String, Int32)

Source:
Ping.cs
Source:
Ping.cs
Source:
Ping.cs

Envía un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo especificado, y recibe el correspondiente mensaje de respuesta de eco ICMP de ese equipo como una operación asincrónica. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación.

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)

Parámetros

hostNameOrAddress
String

El equipo que es el destino del mensaje de la generación de repetición de ICMP. El valor especificado para este parámetro puede ser un nombre de host o una representación de cadena de una dirección IP.

timeout
Int32

El número máximo de milisegundos (después de enviar el mensaje de eco) que hay que esperar hasta recibir el mensaje de respuesta de eco ICMP.

Devoluciones

Objeto de tarea que representa la operación asincrónica.

Excepciones

address es null.

timeout es menor que cero.

Se está realizando una llamada a SendAsync.

Se ha producido una excepción al enviar o recibir los mensajes ICMP. Para conocer la excepción exacta que se produjo, vea la excepción interna.

El valor de address no es una dirección IP válida.

Este objeto se ha eliminado.

Comentarios

Esta operación no se bloqueará. El objeto devuelto se completará una vez enviado Task<TResult>> el paquete ICMP y se haya recibido la respuesta.

Se aplica a

SendPingAsync(IPAddress, Int32, Byte[])

Source:
Ping.cs
Source:
Ping.cs
Source:
Ping.cs

Envía un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo que tiene la IPAddress especificada, y recibe el correspondiente mensaje de respuesta de eco ICMP de ese equipo como una operación asincrónica. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación y un búfer para enviar y recibir.

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)

Parámetros

address
IPAddress

Dirección IP que identifica el equipo de destino para el mensaje de eco ICMP.

timeout
Int32

El número máximo de milisegundos (después de enviar el mensaje de eco) que hay que esperar hasta recibir el mensaje de respuesta de eco ICMP.

buffer
Byte[]

Matriz de Byte que contiene los datos que se envían con el mensaje de eco ICMP y se devuelven en el mensaje de respuesta de eco ICMP. La matriz no puede contener más de 65.500 bytes.

Devoluciones

Objeto de tarea que representa la operación asincrónica.

Excepciones

address o buffer es null.

timeout es menor que cero.

Se está realizando una llamada a SendPingAsync.

Se ha producido una excepción al enviar o recibir los mensajes ICMP. Para conocer la excepción exacta que se produjo, vea la excepción interna.

El valor de address no es una dirección IP válida.

Este objeto se ha eliminado.

El tamaño de buffer supera los 65.500 bytes.

.NET 7 y versiones posteriores solo en Linux: el proceso no tiene privilegios y buffer no está vacío.

Comentarios

Esta operación no se bloqueará. El objeto devuelto se completará una vez enviado Task<TResult>> el paquete ICMP y se haya recibido la respuesta.

Se aplica a

SendPingAsync(String, Int32, Byte[])

Source:
Ping.cs
Source:
Ping.cs
Source:
Ping.cs

Envía un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo especificado, y recibe el correspondiente mensaje de respuesta de eco ICMP de ese equipo como una operación asincrónica. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación y un búfer para enviar y recibir.

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)

Parámetros

hostNameOrAddress
String

El equipo que es el destino del mensaje de la generación de repetición de ICMP. El valor especificado para este parámetro puede ser un nombre de host o una representación de cadena de una dirección IP.

timeout
Int32

El número máximo de milisegundos (después de enviar el mensaje de eco) que hay que esperar hasta recibir el mensaje de respuesta de eco ICMP.

buffer
Byte[]

Matriz de Byte que contiene los datos que se envían con el mensaje de eco ICMP y se devuelven en el mensaje de respuesta de eco ICMP. La matriz no puede contener más de 65.500 bytes.

Devoluciones

Objeto de tarea que representa la operación asincrónica.

Excepciones

hostNameOrAddress es null o una cadena vacía ("").

O bien

buffer es null.

timeout es menor que cero.

Se está realizando una llamada a SendAsync.

Se ha producido una excepción al enviar o recibir los mensajes ICMP. Para conocer la excepción exacta que se produjo, vea la excepción interna.

hostNameOrAddress no pudo resolverse en una dirección IP válida.

Este objeto se ha eliminado.

El tamaño de buffer es superior a 65.500 bytes.

.NET 7 y versiones posteriores solo en Linux: el proceso no tiene privilegios y buffer no está vacío.

Comentarios

Esta operación no se bloqueará. El objeto devuelto se completará una vez enviado Task<TResult>> el paquete ICMP y se haya recibido la respuesta.

Se aplica a

SendPingAsync(IPAddress, Int32, Byte[], PingOptions)

Source:
Ping.cs
Source:
Ping.cs
Source:
Ping.cs

Envía un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo que tiene el elemento IPAddress especificado y recibe el correspondiente mensaje de respuesta de eco ICMP de ese equipo como una operación asincrónica. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación y un búfer para enviar y recibir y controlar los valores de Período de vida y fragmentación para el paquete del mensaje de eco ICMP.

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)

Parámetros

address
IPAddress

Dirección IP que identifica el equipo de destino para el mensaje de eco ICMP.

timeout
Int32

El número máximo de milisegundos (después de enviar el mensaje de eco) que hay que esperar hasta recibir el mensaje de respuesta de eco ICMP.

buffer
Byte[]

Matriz de Byte que contiene los datos que se envían con el mensaje de eco ICMP y se devuelven en el mensaje de respuesta de eco ICMP. La matriz no puede contener más de 65.500 bytes.

options
PingOptions

Objeto PingOptions que se usa para controlar los valores de Período de vida y fragmentación del paquete de mensaje de eco ICMP.

Devoluciones

Objeto de tarea que representa la operación asincrónica.

Excepciones

address o buffer es null.

timeout es menor que cero.

Se está realizando una llamada a SendPingAsync.

Se ha producido una excepción al enviar o recibir los mensajes ICMP. Para conocer la excepción exacta que se produjo, vea la excepción interna.

El valor de address no es una dirección IP válida.

Este objeto se ha eliminado.

El tamaño de buffer supera los 65.500 bytes.

.NET 7 y versiones posteriores solo en Linux: el proceso no tiene privilegios y buffer no está vacío.

Comentarios

Esta operación no se bloqueará. El objeto devuelto se completará una vez enviado Task<TResult>> el paquete ICMP y se haya recibido la respuesta.

Se aplica a

SendPingAsync(String, Int32, Byte[], PingOptions)

Source:
Ping.cs
Source:
Ping.cs
Source:
Ping.cs

Envía un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo especificado, y recibe el correspondiente mensaje de respuesta de eco ICMP de ese equipo como una operación asincrónica. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación y un búfer para enviar y recibir y controlar los valores de Período de vida y fragmentación para el paquete del mensaje de eco ICMP.

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)

Parámetros

hostNameOrAddress
String

El equipo que es el destino del mensaje de la generación de repetición de ICMP. El valor especificado para este parámetro puede ser un nombre de host o una representación de cadena de una dirección IP.

timeout
Int32

El número máximo de milisegundos (después de enviar el mensaje de eco) que hay que esperar hasta recibir el mensaje de respuesta de eco ICMP.

buffer
Byte[]

Matriz de Byte que contiene los datos que se envían con el mensaje de eco ICMP y se devuelven en el mensaje de respuesta de eco ICMP. La matriz no puede contener más de 65.500 bytes.

options
PingOptions

Objeto PingOptions que se usa para controlar los valores de Período de vida y fragmentación del paquete de mensaje de eco ICMP.

Devoluciones

Objeto de tarea que representa la operación asincrónica.

Excepciones

hostNameOrAddress es null o una cadena vacía ("").

O bien

buffer es null.

timeout es menor que cero.

Se está realizando una llamada a SendAsync.

Se ha producido una excepción al enviar o recibir los mensajes ICMP. Para conocer la excepción exacta que se produjo, vea la excepción interna.

hostNameOrAddress no pudo resolverse en una dirección IP válida.

Este objeto se ha eliminado.

El tamaño de buffer es superior a 65.500 bytes.

.NET 7 y versiones posteriores solo en Linux: el proceso no tiene privilegios y buffer no está vacío.

Comentarios

Esta operación no se bloqueará. El objeto devuelto se completará una vez enviado Task<TResult>> el paquete ICMP y se haya recibido la respuesta.

Se aplica a

SendPingAsync(IPAddress, TimeSpan, Byte[], PingOptions, CancellationToken)

Source:
Ping.cs
Source:
Ping.cs

Envía un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo que tiene el elemento IPAddress especificado y recibe el correspondiente mensaje de respuesta de eco ICMP de ese equipo como una operación asincrónica. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación, un búfer que se usará para enviar y recibir, controlar la fragmentación y los valores de período de vida, y un CancellationToken para el paquete de mensajes de eco ICMP.

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)

Parámetros

address
IPAddress

Dirección IP que identifica el equipo de destino para el mensaje de eco ICMP.

timeout
TimeSpan

Cantidad de tiempo (después de enviar el mensaje de eco) para esperar el mensaje de respuesta de eco ICMP.

buffer
Byte[]

Matriz de Byte que contiene los datos que se envían con el mensaje de eco ICMP y se devuelven en el mensaje de respuesta de eco ICMP. La matriz no puede contener más de 65.500 bytes.

options
PingOptions

Objeto PingOptions que se usa para controlar los valores de Período de vida y fragmentación del paquete de mensaje de eco ICMP.

cancellationToken
CancellationToken

Token para supervisar solicitudes de cancelación. El valor predeterminado es None.

Devoluciones

Objeto de tarea que representa la operación asincrónica.

Excepciones

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Se aplica a