Ping.SendPingAsync Método

Definición

Espacio de nombres:: System.Net.NetworkInformation

Ensamblados:: netstandard.dll, System.Net.Ping.dll

Ensamblado:: System.Net.Ping.dll

Ensamblado:: System.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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

Sobrecargas

Nombre	Description
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íe un mensaje de eco del Protocolo de mensajes de control de Internet (ICMP) con el búfer de datos especificado al equipo que tiene el especificado IPAddressy reciba un mensaje de respuesta de eco ICMP correspondiente de ese equipo como una operación asincrónica.
SendPingAsync(String)	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.
SendPingAsync(IPAddress, Int32)	Envíe un mensaje de eco del Protocolo de mensajes de control de Internet (ICMP) con el búfer de datos especificado al equipo que tiene el especificado IPAddressy reciba 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.
SendPingAsync(String, Int32)	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.
SendPingAsync(IPAddress, Int32, Byte[])	Envíe un mensaje de eco del Protocolo de mensajes de control de Internet (ICMP) con el búfer de datos especificado al equipo que tiene el especificado IPAddressy reciba 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 y un búfer que se va a usar para enviar y recibir.
SendPingAsync(String, Int32, Byte[])	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 y un búfer que se va a usar para enviar y recibir.
SendPingAsync(IPAddress, Int32, Byte[], PingOptions)	Envía un mensaje de eco del Protocolo de mensajes de control de Internet (ICMP) con el búfer de datos especificado al equipo que tiene el especificado IPAddressy recibe un mensaje de respuesta de eco ICMP correspondiente de ese equipo como una operación asincrónica. Esta sobrecarga le permite especificar un valor de tiempo de espera para la operación, un búfer que se usará para enviar y recibir, y controlar la fragmentación y los valores de período de vida para el paquete de mensajes de eco ICMP.
SendPingAsync(String, Int32, Byte[], PingOptions)	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 le permite especificar un valor de tiempo de espera para la operación, un búfer que se usará para enviar y recibir, y controlar la fragmentación y los valores de período de vida para el paquete de mensajes de eco ICMP.
SendPingAsync(IPAddress, 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 que tiene el especificado IPAddressy 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.

Comentarios

La dirección IP devuelta por cualquiera de los SendPingAsync métodos puede originarse desde 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

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

Equipo que es el destino del mensaje de eco 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 al mensaje de respuesta de eco ICMP.

buffer: Byte[]

Matriz Byte que contiene datos que se van a enviar con el mensaje de eco ICMP y que se devuelve en el mensaje de respuesta de eco ICMP. La matriz no puede contener más de 65 500 bytes.

options: PingOptions

Objeto PingOptions utilizado para controlar la fragmentación y los valores de período de vida para el paquete de mensajes de eco ICMP.

cancellationToken: CancellationToken

Token que se va a supervisar para las solicitudes de cancelación. El valor por defecto es None.

Devoluciones

Task<PingReply>

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

Excepciones

OperationCanceledException

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

Source:: Ping.cs

Source:: Ping.cs

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 que es el destino del mensaje de eco ICMP.

Devoluciones

Task<PingReply>

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

Excepciones

ArgumentNullException

address es null.

InvalidOperationException

Hay una llamada a SendPingAsync en curso.

PingException

Se produjo una excepción al enviar o recibir los mensajes ICMP. Consulte la excepción interna para obtener la excepción exacta que se produjo.

SocketException

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

ObjectDisposedException

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

Source:: Ping.cs

Source:: Ping.cs

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

Equipo que es el destino del mensaje de eco 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

Task<PingReply>

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

Excepciones

ArgumentNullException

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

InvalidOperationException

Hay una llamada al SendAsync(String, Object) método en curso.

PingException

Se produjo una excepción al enviar o recibir los mensajes ICMP. Consulte la excepción interna para obtener la excepción exacta que se produjo.

SocketException

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

ObjectDisposedException

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

Source:: Ping.cs

Source:: Ping.cs

Envíe un mensaje de eco del Protocolo de mensajes de control de Internet (ICMP) con el búfer de datos especificado al equipo que tiene el especificado IPAddressy reciba 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.

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 que es el destino del mensaje de eco ICMP.

timeout: Int32

Número máximo de milisegundos (después de enviar el mensaje de eco) para esperar al mensaje de respuesta de eco ICMP.

Devoluciones

Task<PingReply>

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

Excepciones

ArgumentNullException

address es null.

InvalidOperationException

Hay una llamada al SendAsync método en curso.

PingException

Se produjo una excepción al enviar o recibir los mensajes ICMP. Consulte la excepción interna para obtener la excepción exacta que se produjo.

SocketException

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

ObjectDisposedException

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

Source:: Ping.cs

Source:: Ping.cs

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

Equipo que es el destino del mensaje de eco 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

Número máximo de milisegundos (después de enviar el mensaje de eco) para esperar al mensaje de respuesta de eco ICMP.

Devoluciones

Task<PingReply>

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

Excepciones

ArgumentNullException

hostNameOrAddress es null.

ArgumentOutOfRangeException

timeout es menor que cero.

InvalidOperationException

Hay una llamada al SendAsync método en curso.

PingException

Se produjo una excepción al enviar o recibir los mensajes ICMP. Consulte la excepción interna para obtener la excepción exacta que se produjo.

SocketException

hostNameOrAddress no es una dirección IP válida.

ObjectDisposedException

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

Source:: Ping.cs

Source:: Ping.cs

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 que es el destino del mensaje de eco ICMP.

timeout: Int32

Número máximo de milisegundos (después de enviar el mensaje de eco) para esperar al mensaje de respuesta de eco ICMP.

buffer: Byte[]

Matriz Byte que contiene datos que se van a enviar con el mensaje de eco ICMP y que se devuelve en el mensaje de respuesta de eco ICMP. La matriz no puede contener más de 65 500 bytes.

Devoluciones

Task<PingReply>

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

Excepciones

ArgumentNullException

address o buffer es null.

ArgumentOutOfRangeException

timeout es menor que cero.

InvalidOperationException

Hay una llamada a SendPingAsync en curso.

PingException

Se produjo una excepción al enviar o recibir los mensajes ICMP. Consulte la excepción interna para obtener la excepción exacta que se produjo.

SocketException

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

ObjectDisposedException

Este objeto se ha eliminado.

ArgumentException

El tamaño de buffer supera los 65 500 bytes.

PlatformNotSupportedException

.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

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 y un búfer que se va a usar 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

Equipo que es el destino del mensaje de eco 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

Número máximo de milisegundos (después de enviar el mensaje de eco) para esperar al mensaje de respuesta de eco ICMP.

buffer: Byte[]

Matriz Byte que contiene datos que se van a enviar con el mensaje de eco ICMP y que se devuelve en el mensaje de respuesta de eco ICMP. La matriz no puede contener más de 65 500 bytes.

Devoluciones

Task<PingReply>

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

Excepciones

ArgumentNullException

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

O bien

buffer es null.

ArgumentOutOfRangeException

timeout es menor que cero.

InvalidOperationException

Hay una llamada a SendAsync en curso.

PingException

Se produjo una excepción al enviar o recibir los mensajes ICMP. Consulte la excepción interna para obtener la excepción exacta que se produjo.

SocketException

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

ObjectDisposedException

Este objeto se ha eliminado.

ArgumentException

El tamaño de buffer supera los 65500 bytes.

PlatformNotSupportedException

.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

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 que tiene el especificado IPAddressy recibe un mensaje de respuesta de eco ICMP correspondiente de ese equipo como una operación asincrónica. Esta sobrecarga le permite especificar un valor de tiempo de espera para la operación, un búfer que se usará para enviar y recibir, y controlar la fragmentación y los valores de período de vida para el paquete de mensajes 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 que es el destino del mensaje de eco ICMP.

timeout: Int32

Número máximo de milisegundos (después de enviar el mensaje de eco) para esperar al mensaje de respuesta de eco ICMP.

buffer: Byte[]

Matriz Byte que contiene datos que se van a enviar con el mensaje de eco ICMP y que se devuelve en el mensaje de respuesta de eco ICMP. La matriz no puede contener más de 65 500 bytes.

options: PingOptions

Objeto PingOptions utilizado para controlar la fragmentación y los valores de período de vida para el paquete de mensajes de eco ICMP.

Devoluciones

Task<PingReply>

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

Excepciones

ArgumentNullException

address o buffer es null.

ArgumentOutOfRangeException

timeout es menor que cero.

InvalidOperationException

Hay una llamada a SendPingAsync en curso.

PingException

Se produjo una excepción al enviar o recibir los mensajes ICMP. Consulte la excepción interna para obtener la excepción exacta que se produjo.

SocketException

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

ObjectDisposedException

Este objeto se ha eliminado.

ArgumentException

El tamaño de buffer supera los 65 500 bytes.

PlatformNotSupportedException

.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

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 le permite especificar un valor de tiempo de espera para la operación, un búfer que se usará para enviar y recibir, y controlar la fragmentación y los valores de período de vida para el paquete de mensajes 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

Equipo que es el destino del mensaje de eco 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

Número máximo de milisegundos (después de enviar el mensaje de eco) para esperar al mensaje de respuesta de eco ICMP.

buffer: Byte[]

Matriz Byte que contiene datos que se van a enviar con el mensaje de eco ICMP y que se devuelve en el mensaje de respuesta de eco ICMP. La matriz no puede contener más de 65 500 bytes.

options: PingOptions

Objeto PingOptions utilizado para controlar la fragmentación y los valores de período de vida para el paquete de mensajes de eco ICMP.

Devoluciones

Task<PingReply>

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

Excepciones

ArgumentNullException

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

O bien

buffer es null.

ArgumentOutOfRangeException

timeout es menor que cero.

InvalidOperationException

Hay una llamada a SendAsync en curso.

PingException

Se produjo una excepción al enviar o recibir los mensajes ICMP. Consulte la excepción interna para obtener la excepción exacta que se produjo.

SocketException

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

ObjectDisposedException

Este objeto se ha eliminado.

ArgumentException

El tamaño de buffer supera los 65500 bytes.

PlatformNotSupportedException

.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

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 que tiene el especificado IPAddressy 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(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 que es el destino del mensaje de eco ICMP.

timeout: TimeSpan

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

buffer: Byte[]

Matriz Byte que contiene datos que se van a enviar con el mensaje de eco ICMP y que se devuelve en el mensaje de respuesta de eco ICMP. La matriz no puede contener más de 65 500 bytes.

options: PingOptions

Objeto PingOptions utilizado para controlar la fragmentación y los valores de período de vida para el paquete de mensajes de eco ICMP.

cancellationToken: CancellationToken

Token que se va a supervisar para las solicitudes de cancelación. El valor por defecto es None.

Devoluciones

Task<PingReply>

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

Excepciones

OperationCanceledException

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

Se aplica a

Comentarios

¿Le ha resultado útil esta página?