Ping.SendPingAsync Método
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 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.
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. |
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.
- 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 al 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
.NET 9 y .NET 8
Producto | Versiones |
---|---|
.NET | 8, 9 |
- 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 Task<TResult>> se completará después de que se haya enviado el paquete ICMP y se haya recibido la respuesta.
Se aplica a
.NET 9 y otras versiones
Producto | Versiones |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
- 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 Task<TResult>> se completará después de que se haya enviado el paquete ICMP y se haya recibido la respuesta.
Se aplica a
.NET 9 y otras versiones
Producto | Versiones |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
- 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 Task<TResult>> se completará después de que se haya enviado el paquete ICMP y se haya recibido la respuesta.
Se aplica a
.NET 9 y otras versiones
Producto | Versiones |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
- 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 Task<TResult>> se completará después de que se haya enviado el paquete ICMP y se haya recibido la respuesta.
Se aplica a
.NET 9 y otras versiones
Producto | Versiones |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
- 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 Task<TResult>> se completará después de que se haya enviado el paquete ICMP y se haya recibido la respuesta.
Se aplica a
.NET 9 y otras versiones
Producto | Versiones |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
- 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
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 Task<TResult>> se completará después de que se haya enviado el paquete ICMP y se haya recibido la respuesta.
Se aplica a
.NET 9 y otras versiones
Producto | Versiones |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
- 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 Task<TResult>> se completará después de que se haya enviado el paquete ICMP y se haya recibido la respuesta.
Se aplica a
.NET 9 y otras versiones
Producto | Versiones |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
- 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
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 Task<TResult>> se completará después de que se haya enviado el paquete ICMP y se haya recibido la respuesta.
Se aplica a
.NET 9 y otras versiones
Producto | Versiones |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
- 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 al 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
.NET 9 y .NET 8
Producto | Versiones |
---|---|
.NET | 8, 9 |
Comentarios de .NET
.NET es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: