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 do protocolo ICMP a um computador e recebe uma mensagem de resposta de eco ICMP correspondente daquele computador como uma operação assíncrona.
Sobrecargas
SendPingAsync(String, TimeSpan, Byte[], PingOptions, CancellationToken) |
Envia uma mensagem de eco do protocolo ICMP 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 especificar um valor de tempo limite para a operação, um buffer a ser usado para envio e recebimento, fragmentação de controle e valores de vida útil e um CancellationToken para o pacote de mensagem de eco ICMP. |
SendPingAsync(IPAddress) |
Envia uma mensagem de eco do protocolo ICMP com o buffer de dados especificado para o computador que tem o IPAddress especificado e recebe uma mensagem de resposta de eco do ICMP correspondente do computador como uma operação assíncrona. |
SendPingAsync(String) |
Envia uma mensagem de eco do protocolo ICMP com o buffer de dados especificado para o computador especificado e recebe uma mensagem de resposta de eco do ICMP do computador como uma operação assíncrona. |
SendPingAsync(IPAddress, Int32) |
Envia uma mensagem de eco do protocolo ICMP com o buffer de dados especificado para o computador que tem o IPAddress especificado e recebe uma mensagem de resposta de eco do ICMP correspondente do 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 do protocolo ICMP com o buffer de dados especificado para o computador especificado e recebe uma mensagem de resposta de eco do ICMP do 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[]) |
Envia uma mensagem de eco do protocolo ICMP com o buffer de dados especificado para o computador que tem o IPAddress especificado e recebe uma mensagem de resposta de eco do ICMP correspondente do 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 enviar e receber. |
SendPingAsync(String, Int32, Byte[]) |
Envia uma mensagem de eco do protocolo ICMP com o buffer de dados especificado para o computador especificado e recebe uma mensagem de resposta de eco do ICMP do 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 enviar e receber. |
SendPingAsync(IPAddress, Int32, Byte[], PingOptions) |
Envia uma mensagem de eco do protocolo ICMP com o buffer de dados especificado para o computador que tem o IPAddress especificado e recebe uma mensagem de resposta de eco do ICMP correspondente do 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 enviar e receber e controlar a fragmentação e valores de vida útil para o pacote de mensagens de eco ICMP. |
SendPingAsync(String, Int32, Byte[], PingOptions) |
Envia uma mensagem de eco do protocolo ICMP com o buffer de dados especificado para o computador especificado e recebe uma mensagem de resposta de eco do ICMP do 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 enviar e receber e controlar a fragmentação e valores de vida útil para o pacote de mensagens de eco ICMP. |
SendPingAsync(IPAddress, TimeSpan, Byte[], PingOptions, CancellationToken) |
Envia uma mensagem de eco do protocolo ICMP com o buffer de dados especificado para o computador que tem o IPAddress especificado e recebe uma mensagem de resposta de eco do ICMP correspondente do computador como uma operação assíncrona. Essa sobrecarga permite especificar um valor de tempo limite para a operação, um buffer a ser usado para envio e recebimento, fragmentação de controle e valores de vida útil e um CancellationToken para o pacote de mensagem de eco ICMP. |
Comentários
O endereço IP retornado por qualquer um dos SendPingAsync métodos pode ser originado 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, TimeSpan, Byte[], PingOptions, CancellationToken)
- Origem:
- Ping.cs
- Origem:
- Ping.cs
Envia uma mensagem de eco do protocolo ICMP 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 especificar um valor de tempo limite para a operação, um buffer a ser usado para envio e recebimento, fragmentação de controle e valores de vida útil e um CancellationToken para o pacote de mensagem 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
O computador de destino da mensagem de eco do ICMP. O valor especificado para esse parâmetro pode ser um nome do host ou uma representação de cadeia de caracteres de um endereço IP.
- timeout
- TimeSpan
A quantidade de tempo (depois de enviar a mensagem de eco) para aguardar a mensagem de resposta de eco ICMP.
- buffer
- Byte[]
Uma matriz Byte que contém dados a serem enviados com a mensagem de eco de ICMP e retornados na mensagem de resposta de eco de ICMP. A matriz não pode conter mais de 65.500 bytes.
- options
- PingOptions
Um objeto PingOptions usado para controlar a fragmentação e valores de vida útil para o pacote de mensagens de eco ICMP.
- cancellationToken
- CancellationToken
O token a se monitorar para solicitações de cancelamento. O valor padrão é None.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Aplica-se a
SendPingAsync(IPAddress)
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
Envia uma mensagem de eco do protocolo ICMP com o buffer de dados especificado para o computador que tem o IPAddress especificado e recebe uma mensagem de resposta de eco do ICMP correspondente do 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 de destino para a mensagem de eco do ICMP.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
address
é null
.
Uma chamada para SendPingAsync está em andamento.
Uma exceção foi gerada durante o envio ou recebimento de mensagens do ICMP. Consulte a exceção interna para obter a exceção exata gerada.
address
não é um endereço IP válido.
O objeto foi descartado.
Comentários
Esta 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)
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
Envia uma mensagem de eco do protocolo ICMP com o buffer de dados especificado para o computador especificado e recebe uma mensagem de resposta de eco do ICMP do 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 de destino da mensagem de eco do ICMP. O valor especificado para esse parâmetro pode ser um nome do 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 para o método SendAsync(String, Object) está em andamento.
Uma exceção foi gerada durante o envio ou recebimento de mensagens do ICMP. Consulte a exceção interna para obter a exceção exata gerada.
O hostNameOrAddress
não pôde ser resolvido para um endereço IP válido.
O objeto foi descartado.
Comentários
Esta 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)
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
Envia uma mensagem de eco do protocolo ICMP com o buffer de dados especificado para o computador que tem o IPAddress especificado e recebe uma mensagem de resposta de eco do ICMP correspondente do 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 de destino para a mensagem de eco do ICMP.
- timeout
- Int32
O número máximo de milissegundos (após o envio da mensagem de eco) de espera pela mensagem de resposta de eco de ICMP.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
address
é null
.
Uma chamada ao SendAsync método está em andamento.
Uma exceção foi gerada durante o envio ou recebimento de mensagens do ICMP. Consulte a exceção interna para obter a exceção exata gerada.
address
não é um endereço IP válido.
O objeto foi descartado.
Comentários
Esta 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)
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
Envia uma mensagem de eco do protocolo ICMP com o buffer de dados especificado para o computador especificado e recebe uma mensagem de resposta de eco do ICMP do 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 de destino da mensagem de eco do ICMP. O valor especificado para esse parâmetro pode ser um nome do host ou uma representação de cadeia de caracteres de um endereço IP.
- timeout
- Int32
O número máximo de milissegundos (após o envio da mensagem de eco) de espera pela mensagem de resposta de eco de ICMP.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
address
é null
.
timeout
é menor que zero.
Uma chamada ao SendAsync método está em andamento.
Uma exceção foi gerada durante o envio ou recebimento de mensagens do ICMP. Consulte a exceção interna para obter a exceção exata gerada.
address
não é um endereço IP válido.
O objeto foi descartado.
Comentários
Esta 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[])
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
Envia uma mensagem de eco do protocolo ICMP com o buffer de dados especificado para o computador que tem o IPAddress especificado e recebe uma mensagem de resposta de eco do ICMP correspondente do 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 enviar e receber.
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 de destino para a mensagem de eco do ICMP.
- timeout
- Int32
O número máximo de milissegundos (após o envio da mensagem de eco) de espera pela mensagem de resposta de eco de ICMP.
- buffer
- Byte[]
Uma matriz Byte que contém dados a serem enviados com a mensagem de eco de ICMP e retornados na mensagem de resposta de eco de 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 para SendPingAsync está em andamento.
Uma exceção foi gerada durante o envio ou recebimento de mensagens do ICMP. Consulte a exceção interna para obter a exceção exata gerada.
address
não é um endereço IP válido.
O objeto foi descartado.
O tamanho de buffer
excede 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
Esta 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[])
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
Envia uma mensagem de eco do protocolo ICMP com o buffer de dados especificado para o computador especificado e recebe uma mensagem de resposta de eco do ICMP do 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 enviar e receber.
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 de destino da mensagem de eco do ICMP. O valor especificado para esse parâmetro pode ser um nome do host ou uma representação de cadeia de caracteres de um endereço IP.
- timeout
- Int32
O número máximo de milissegundos (após o envio da mensagem de eco) de espera pela mensagem de resposta de eco de ICMP.
- buffer
- Byte[]
Uma matriz Byte que contém dados a serem enviados com a mensagem de eco de ICMP e retornados na mensagem de resposta de eco de 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 para SendAsync está em andamento.
Uma exceção foi gerada durante o envio ou recebimento de mensagens do ICMP. Consulte a exceção interna para obter a exceção exata gerada.
O hostNameOrAddress
não pôde ser resolvido para um endereço IP válido.
O objeto foi descartado.
O tamanho do buffer
excede 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
Esta 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)
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
Envia uma mensagem de eco do protocolo ICMP com o buffer de dados especificado para o computador que tem o IPAddress especificado e recebe uma mensagem de resposta de eco do ICMP correspondente do 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 enviar e receber e controlar a fragmentação e valores 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);
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 de destino para a mensagem de eco do ICMP.
- timeout
- Int32
O número máximo de milissegundos (após o envio da mensagem de eco) de espera pela mensagem de resposta de eco de ICMP.
- buffer
- Byte[]
Uma matriz Byte que contém dados a serem enviados com a mensagem de eco de ICMP e retornados na mensagem de resposta de eco de ICMP. A matriz não pode conter mais de 65.500 bytes.
- options
- PingOptions
Um objeto PingOptions 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 para SendPingAsync está em andamento.
Uma exceção foi gerada durante o envio ou recebimento de mensagens do ICMP. Consulte a exceção interna para obter a exceção exata gerada.
address
não é um endereço IP válido.
O objeto foi descartado.
O tamanho de buffer
excede 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
Esta 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[], PingOptions)
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
Envia uma mensagem de eco do protocolo ICMP com o buffer de dados especificado para o computador especificado e recebe uma mensagem de resposta de eco do ICMP do 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 enviar e receber e controlar a fragmentação e valores 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);
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 de destino da mensagem de eco do ICMP. O valor especificado para esse parâmetro pode ser um nome do host ou uma representação de cadeia de caracteres de um endereço IP.
- timeout
- Int32
O número máximo de milissegundos (após o envio da mensagem de eco) de espera pela mensagem de resposta de eco de ICMP.
- buffer
- Byte[]
Uma matriz Byte que contém dados a serem enviados com a mensagem de eco de ICMP e retornados na mensagem de resposta de eco de ICMP. A matriz não pode conter mais de 65.500 bytes.
- options
- PingOptions
Um objeto PingOptions 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 para SendAsync está em andamento.
Uma exceção foi gerada durante o envio ou recebimento de mensagens do ICMP. Consulte a exceção interna para obter a exceção exata gerada.
O hostNameOrAddress
não pôde ser resolvido para um endereço IP válido.
O objeto foi descartado.
O tamanho do buffer
excede 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
Esta 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, TimeSpan, Byte[], PingOptions, CancellationToken)
- Origem:
- Ping.cs
- Origem:
- Ping.cs
Envia uma mensagem de eco do protocolo ICMP com o buffer de dados especificado para o computador que tem o IPAddress especificado e recebe uma mensagem de resposta de eco do ICMP correspondente do computador como uma operação assíncrona. Essa sobrecarga permite especificar um valor de tempo limite para a operação, um buffer a ser usado para envio e recebimento, fragmentação de controle e valores de vida útil e um CancellationToken para o pacote de mensagem 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
Um endereço IP que identifica o computador de destino para a mensagem de eco do ICMP.
- timeout
- TimeSpan
A quantidade de tempo (depois de enviar a mensagem de eco) para aguardar a mensagem de resposta de eco ICMP.
- buffer
- Byte[]
Uma matriz Byte que contém dados a serem enviados com a mensagem de eco de ICMP e retornados na mensagem de resposta de eco de ICMP. A matriz não pode conter mais de 65.500 bytes.
- options
- PingOptions
Um objeto PingOptions usado para controlar a fragmentação e valores de vida útil para o pacote de mensagens de eco ICMP.
- cancellationToken
- CancellationToken
O token a se monitorar para solicitações de cancelamento. O valor padrão é None.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.