Ping.SendPingAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Envia uma mensagem de eco ICMP (Protocolo de Mensagem de Controle de Internet) para um computador e recebe uma mensagem de resposta de eco ICMP correspondente desse computador como uma operação assíncrona.
Sobrecargas
| Nome | Description |
|---|---|
| SendPingAsync(String, Int32, Byte[], PingOptions) |
Envia uma mensagem de eco ICMP (Protocolo de Mensagem de Controle de Internet) com o buffer de dados especificado para o computador especificado e recebe uma mensagem de resposta de eco ICMP correspondente desse computador como uma operação assíncrona. Essa sobrecarga permite que você especifique um valor de tempo limite para a operação, um buffer a ser usado para envio e recebimento e controle a fragmentação e valores de tempo de vida útil para o pacote de mensagens de eco ICMP. |
| SendPingAsync(IPAddress) |
Envie uma mensagem de eco ICMP (Protocolo de Mensagem de Controle de Internet) com o buffer de dados especificado para o computador que tem o especificado IPAddresse recebe uma mensagem de resposta de eco ICMP correspondente desse computador como uma operação assíncrona. |
| SendPingAsync(String) |
Envia uma mensagem de eco ICMP (Protocolo de Mensagem de Controle de Internet) com o buffer de dados especificado para o computador especificado e recebe uma mensagem de resposta de eco ICMP correspondente desse computador como uma operação assíncrona. |
| SendPingAsync(IPAddress, Int32) |
Envie uma mensagem de eco ICMP (Protocolo de Mensagem de Controle de Internet) com o buffer de dados especificado para o computador que tem o especificado IPAddresse recebe uma mensagem de resposta de eco ICMP correspondente desse computador como uma operação assíncrona. Essa sobrecarga permite que você especifique um valor de tempo limite para a operação. |
| SendPingAsync(String, Int32) |
Envia uma mensagem de eco ICMP (Protocolo de Mensagem de Controle de Internet) com o buffer de dados especificado para o computador especificado e recebe uma mensagem de resposta de eco ICMP correspondente desse computador como uma operação assíncrona. Essa sobrecarga permite que você especifique um valor de tempo limite para a operação. |
| SendPingAsync(IPAddress, Int32, Byte[]) |
Envie uma mensagem de eco ICMP (Protocolo de Mensagem de Controle de Internet) com o buffer de dados especificado para o computador que tem o especificado IPAddresse recebe uma mensagem de resposta de eco ICMP correspondente desse computador como uma operação assíncrona. Essa sobrecarga permite que você especifique um valor de tempo limite para a operação e um buffer a ser usado para envio e recebimento. |
| SendPingAsync(String, Int32, Byte[]) |
Envia uma mensagem de eco ICMP (Protocolo de Mensagem de Controle de Internet) com o buffer de dados especificado para o computador especificado e recebe uma mensagem de resposta de eco ICMP correspondente desse computador como uma operação assíncrona. Essa sobrecarga permite que você especifique um valor de tempo limite para a operação e um buffer a ser usado para envio e recebimento. |
| SendPingAsync(IPAddress, Int32, Byte[], PingOptions) |
Envia uma mensagem de eco ICMP (Protocolo de Mensagem de Controle de Internet) com o buffer de dados especificado para o computador que tem o especificado IPAddresse recebe uma mensagem de resposta de eco ICMP correspondente desse computador como uma operação assíncrona. Essa sobrecarga permite que você especifique um valor de tempo limite para a operação, um buffer a ser usado para envio e recebimento e controle a fragmentação e valores de tempo de vida útil para o pacote de mensagens de eco ICMP. |
Comentários
O endereço IP retornado por qualquer um dos SendPingAsync métodos pode se originar de um computador remoto mal-intencionado. Não se conecte ao computador remoto usando isso. Use o DNS para determinar o endereço IP do computador ao qual você deseja se conectar.
SendPingAsync(String, Int32, Byte[], PingOptions)
Envia uma mensagem de eco ICMP (Protocolo de Mensagem de Controle de Internet) com o buffer de dados especificado para o computador especificado e recebe uma mensagem de resposta de eco ICMP correspondente desse computador como uma operação assíncrona. Essa sobrecarga permite que você especifique um valor de tempo limite para a operação, um buffer a ser usado para envio e recebimento e controle a fragmentação e valores de tempo de vida útil para o pacote de mensagens 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);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
O computador que é o destino da mensagem de eco ICMP. O valor especificado para esse parâmetro pode ser um nome de host ou uma representação de cadeia de caracteres de um endereço IP.
- timeout
- Int32
O número máximo de milissegundos (depois de enviar a mensagem de eco) para aguardar a mensagem de resposta de eco ICMP.
- buffer
- Byte[]
Uma Byte matriz que contém dados a serem enviados com a mensagem de eco ICMP e retornados na mensagem de resposta de eco ICMP. A matriz não pode conter mais de 65.500 bytes.
- options
- PingOptions
Um PingOptions objeto usado para controlar a fragmentação e valores de vida útil para o pacote de mensagens de eco ICMP.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
hostNameOrAddress é null ou é uma cadeia de caracteres vazia ("").
-ou-
buffer é null.
timeout é menor que zero.
Uma chamada está SendAsync em andamento.
Uma exceção foi gerada ao enviar ou receber as mensagens ICMP. Consulte a exceção interna para obter a exceção exata que foi gerada.
hostNameOrAddress não foi possível resolver um endereço IP válido.
Este objeto foi descartado.
O tamanho excede buffer 65500 bytes.
.NET 7 e versões posteriores somente no Linux: o processo não tem privilégios e buffer não está vazio.
Comentários
Essa operação não será bloqueada. O objeto retornado Task<TResult>> será concluído depois que o pacote ICMP tiver sido enviado e a resposta tiver sido recebida.
Aplica-se a
SendPingAsync(IPAddress)
Envie uma mensagem de eco ICMP (Protocolo de Mensagem de Controle de Internet) com o buffer de dados especificado para o computador que tem o especificado IPAddresse recebe uma mensagem de resposta de eco ICMP correspondente desse computador como uma operação assíncrona.
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
Um endereço IP que identifica o computador que é o destino da mensagem de eco ICMP.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
address é null.
Uma chamada está SendPingAsync em andamento.
Uma exceção foi gerada ao enviar ou receber as mensagens ICMP. Consulte a exceção interna para obter a exceção exata que foi gerada.
address não é um endereço IP válido.
Este objeto foi descartado.
Comentários
Essa operação não será bloqueada. O objeto retornado Task<TResult>> será concluído depois que o pacote ICMP tiver sido enviado e a resposta tiver sido recebida.
Aplica-se a
SendPingAsync(String)
Envia uma mensagem de eco ICMP (Protocolo de Mensagem de Controle de Internet) com o buffer de dados especificado para o computador especificado e recebe uma mensagem de resposta de eco ICMP correspondente desse computador como uma operação assíncrona.
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
O computador que é o destino da mensagem de eco ICMP. O valor especificado para esse parâmetro pode ser um nome de host ou uma representação de cadeia de caracteres de um endereço IP.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
hostNameOrAddress é null ou é uma cadeia de caracteres vazia ("").
Uma chamada ao SendAsync(String, Object) método está em andamento.
Uma exceção foi gerada ao enviar ou receber as mensagens ICMP. Consulte a exceção interna para obter a exceção exata que foi gerada.
hostNameOrAddress não foi possível resolver um endereço IP válido.
Este objeto foi descartado.
Comentários
Essa operação não será bloqueada. O objeto retornado Task<TResult>> será concluído depois que o pacote ICMP tiver sido enviado e a resposta tiver sido recebida.
Aplica-se a
SendPingAsync(IPAddress, Int32)
Envie uma mensagem de eco ICMP (Protocolo de Mensagem de Controle de Internet) com o buffer de dados especificado para o computador que tem o especificado IPAddresse recebe uma mensagem de resposta de eco ICMP correspondente desse computador como uma operação assíncrona. Essa sobrecarga permite que você especifique um valor de tempo limite para a operação.
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
Um endereço IP que identifica o computador que é o destino da mensagem de eco ICMP.
- timeout
- Int32
O número máximo de milissegundos (depois de enviar a mensagem de eco) para aguardar a mensagem de resposta de eco ICMP.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
address é null.
Uma chamada para o SendAsync método está em andamento.
Uma exceção foi gerada ao enviar ou receber as mensagens ICMP. Consulte a exceção interna para obter a exceção exata que foi gerada.
address não é um endereço IP válido.
Este objeto foi descartado.
Comentários
Essa operação não será bloqueada. O objeto retornado Task<TResult>> será concluído depois que o pacote ICMP tiver sido enviado e a resposta tiver sido recebida.
Aplica-se a
SendPingAsync(String, Int32)
Envia uma mensagem de eco ICMP (Protocolo de Mensagem de Controle de Internet) com o buffer de dados especificado para o computador especificado e recebe uma mensagem de resposta de eco ICMP correspondente desse computador como uma operação assíncrona. Essa sobrecarga permite que você especifique um valor de tempo limite para a operação.
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
O computador que é o destino da mensagem de eco ICMP. O valor especificado para esse parâmetro pode ser um nome de host ou uma representação de cadeia de caracteres de um endereço IP.
- timeout
- Int32
O número máximo de milissegundos (depois de enviar a mensagem de eco) para aguardar a mensagem de resposta de eco ICMP.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
hostNameOrAddress é null.
timeout é menor que zero.
Uma chamada para o SendAsync método está em andamento.
Uma exceção foi gerada ao enviar ou receber as mensagens ICMP. Consulte a exceção interna para obter a exceção exata que foi gerada.
hostNameOrAddress não é um endereço IP válido.
Este objeto foi descartado.
Comentários
Essa operação não será bloqueada. O objeto retornado Task<TResult>> será concluído depois que o pacote ICMP tiver sido enviado e a resposta tiver sido recebida.
Aplica-se a
SendPingAsync(IPAddress, Int32, Byte[])
Envie uma mensagem de eco ICMP (Protocolo de Mensagem de Controle de Internet) com o buffer de dados especificado para o computador que tem o especificado IPAddresse recebe uma mensagem de resposta de eco ICMP correspondente desse computador como uma operação assíncrona. Essa sobrecarga permite que você especifique um valor de tempo limite para a operação e um buffer a ser usado para envio e recebimento.
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
Um endereço IP que identifica o computador que é o destino da mensagem de eco ICMP.
- timeout
- Int32
O número máximo de milissegundos (depois de enviar a mensagem de eco) para aguardar a mensagem de resposta de eco ICMP.
- buffer
- Byte[]
Uma Byte matriz que contém dados a serem enviados com a mensagem de eco ICMP e retornados na mensagem de resposta de eco ICMP. A matriz não pode conter mais de 65.500 bytes.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
address ou buffer é null.
timeout é menor que zero.
Uma chamada está SendPingAsync em andamento.
Uma exceção foi gerada ao enviar ou receber as mensagens ICMP. Consulte a exceção interna para obter a exceção exata que foi gerada.
address não é um endereço IP válido.
Este objeto foi descartado.
O tamanho excede buffer 65.500 bytes.
.NET 7 e versões posteriores somente no Linux: o processo não tem privilégios e buffer não está vazio.
Comentários
Essa operação não será bloqueada. O objeto retornado Task<TResult>> será concluído depois que o pacote ICMP tiver sido enviado e a resposta tiver sido recebida.
Aplica-se a
SendPingAsync(String, Int32, Byte[])
Envia uma mensagem de eco ICMP (Protocolo de Mensagem de Controle de Internet) com o buffer de dados especificado para o computador especificado e recebe uma mensagem de resposta de eco ICMP correspondente desse computador como uma operação assíncrona. Essa sobrecarga permite que você especifique um valor de tempo limite para a operação e um buffer a ser usado para envio e recebimento.
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
O computador que é o destino da mensagem de eco ICMP. O valor especificado para esse parâmetro pode ser um nome de host ou uma representação de cadeia de caracteres de um endereço IP.
- timeout
- Int32
O número máximo de milissegundos (depois de enviar a mensagem de eco) para aguardar a mensagem de resposta de eco ICMP.
- buffer
- Byte[]
Uma Byte matriz que contém dados a serem enviados com a mensagem de eco ICMP e retornados na mensagem de resposta de eco ICMP. A matriz não pode conter mais de 65.500 bytes.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
hostNameOrAddress é null ou é uma cadeia de caracteres vazia ("").
-ou-
buffer é null.
timeout é menor que zero.
Uma chamada está SendAsync em andamento.
Uma exceção foi gerada ao enviar ou receber as mensagens ICMP. Consulte a exceção interna para obter a exceção exata que foi gerada.
hostNameOrAddress não foi possível resolver um endereço IP válido.
Este objeto foi descartado.
O tamanho excede buffer 65500 bytes.
.NET 7 e versões posteriores somente no Linux: o processo não tem privilégios e buffer não está vazio.
Comentários
Essa operação não será bloqueada. O objeto retornado Task<TResult>> será concluído depois que o pacote ICMP tiver sido enviado e a resposta tiver sido recebida.
Aplica-se a
SendPingAsync(IPAddress, Int32, Byte[], PingOptions)
Envia uma mensagem de eco ICMP (Protocolo de Mensagem de Controle de Internet) com o buffer de dados especificado para o computador que tem o especificado IPAddresse recebe uma mensagem de resposta de eco ICMP correspondente desse computador como uma operação assíncrona. Essa sobrecarga permite que você especifique um valor de tempo limite para a operação, um buffer a ser usado para envio e recebimento e controle a fragmentação e valores de tempo de vida útil para o pacote de mensagens 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);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
Um endereço IP que identifica o computador que é o destino da mensagem de eco ICMP.
- timeout
- Int32
O número máximo de milissegundos (depois de enviar a mensagem de eco) para aguardar a mensagem de resposta de eco ICMP.
- buffer
- Byte[]
Uma Byte matriz que contém dados a serem enviados com a mensagem de eco ICMP e retornados na mensagem de resposta de eco ICMP. A matriz não pode conter mais de 65.500 bytes.
- options
- PingOptions
Um PingOptions objeto usado para controlar a fragmentação e valores de vida útil para o pacote de mensagens de eco ICMP.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
address ou buffer é null.
timeout é menor que zero.
Uma chamada está SendPingAsync em andamento.
Uma exceção foi gerada ao enviar ou receber as mensagens ICMP. Consulte a exceção interna para obter a exceção exata que foi gerada.
address não é um endereço IP válido.
Este objeto foi descartado.
O tamanho excede buffer 65.500 bytes.
.NET 7 e versões posteriores somente no Linux: o processo não tem privilégios e buffer não está vazio.
Comentários
Essa operação não será bloqueada. O objeto retornado Task<TResult>> será concluído depois que o pacote ICMP tiver sido enviado e a resposta tiver sido recebida.