Ping.SendPingAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Envia uma mensagem de eco do Protocolo de Mensagens de Controlo da Internet (ICMP) para um computador e recebe uma correspondente mensagem de resposta de eco ICMP desse computador como uma operação assíncrona.
Sobrecargas
| Name | Description |
|---|---|
| SendPingAsync(String, TimeSpan, Byte[], PingOptions, CancellationToken) |
Envia uma mensagem de eco do Internet Control Message Protocol (ICMP) com o buffer de dados especificado para o computador especificado, e recebe uma correspondente mensagem de resposta de eco ICMP desse computador como uma operação assíncrona. Esta sobrecarga permite especificar um valor de time-out para a operação, um buffer para enviar e receber, valores de fragmentação de controlo e Time-to-Live, e um CancellationToken para o pacote de mensagens de eco ICMP. |
| SendPingAsync(IPAddress) |
Envie uma mensagem de eco do Protocolo de Mensagens de Controlo da Internet (ICMP) com o buffer de dados especificado para o computador que tenha o especificado IPAddress, e que receba uma correspondente mensagem de resposta de eco ICMP desse computador como uma operação assíncrona. |
| SendPingAsync(String) |
Envia uma mensagem de eco do Protocolo de Mensagens de Controlo da Internet (ICMP) com o buffer de dados especificado para o computador especificado, e recebe uma correspondente mensagem de resposta de eco ICMP desse computador como uma operação assíncrona. |
| SendPingAsync(IPAddress, Int32) |
Envie uma mensagem de eco do Protocolo de Mensagens de Controlo da Internet (ICMP) com o buffer de dados especificado para o computador que tenha o especificado IPAddress, e que receba uma correspondente mensagem de resposta de eco ICMP desse computador como uma operação assíncrona. Esta sobrecarga permite-lhe especificar um valor de time-out para a operação. |
| SendPingAsync(String, Int32) |
Envia uma mensagem de eco do Protocolo de Mensagens de Controlo da Internet (ICMP) com o buffer de dados especificado para o computador especificado, e recebe uma correspondente mensagem de resposta de eco ICMP desse computador como uma operação assíncrona. Esta sobrecarga permite-lhe especificar um valor de time-out para a operação. |
| SendPingAsync(IPAddress, Int32, Byte[]) |
Envie uma mensagem de eco do Protocolo de Mensagens de Controlo da Internet (ICMP) com o buffer de dados especificado para o computador que tenha o especificado IPAddress, e que receba uma correspondente mensagem de resposta de eco ICMP desse computador como uma operação assíncrona. Esta sobrecarga permite especificar um valor de time-out para a operação e um buffer para enviar e receber. |
| SendPingAsync(String, Int32, Byte[]) |
Envia uma mensagem de eco do Protocolo de Mensagens de Controlo da Internet (ICMP) com o buffer de dados especificado para o computador especificado, e recebe uma correspondente mensagem de resposta de eco ICMP desse computador como uma operação assíncrona. Esta sobrecarga permite especificar um valor de time-out para a operação e um buffer para enviar e receber. |
| SendPingAsync(IPAddress, Int32, Byte[], PingOptions) |
Envia uma mensagem de eco do Protocolo de Mensagens de Controlo da Internet (ICMP) com o buffer de dados especificado para o computador que tem o especificado IPAddress, e recebe uma correspondente mensagem de resposta de eco ICMP desse computador como uma operação assíncrona. Esta sobrecarga permite especificar um valor de time-out para a operação, um buffer para enviar e receber, e controlar a fragmentação e os valores Time-to-Live para o pacote de mensagens de eco ICMP. |
| SendPingAsync(String, Int32, Byte[], PingOptions) |
Envia uma mensagem de eco do Protocolo de Mensagens de Controlo da Internet (ICMP) com o buffer de dados especificado para o computador especificado, e recebe uma correspondente mensagem de resposta de eco ICMP desse computador como uma operação assíncrona. Esta sobrecarga permite especificar um valor de time-out para a operação, um buffer para enviar e receber, e controlar a fragmentação e os valores Time-to-Live para o pacote de mensagens de eco ICMP. |
| SendPingAsync(IPAddress, TimeSpan, Byte[], PingOptions, CancellationToken) |
Envia uma mensagem de eco do Protocolo de Mensagens de Controlo da Internet (ICMP) com o buffer de dados especificado para o computador que tem o especificado IPAddress, e recebe uma correspondente mensagem de resposta de eco ICMP desse computador como uma operação assíncrona. Esta sobrecarga permite especificar um valor de time-out para a operação, um buffer para enviar e receber, valores de fragmentação de controlo e Time-to-Live, e um CancellationToken para o pacote de mensagens de eco ICMP. |
Observações
O endereço IP devolvido por qualquer um dos SendPingAsync métodos pode originar-se de um computador remoto malicioso. Não se ligue ao computador remoto usando isto. Usa o DNS para determinar o endereço IP da máquina à qual queres ligar-te.
SendPingAsync(String, TimeSpan, Byte[], PingOptions, CancellationToken)
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
Envia uma mensagem de eco do Internet Control Message Protocol (ICMP) com o buffer de dados especificado para o computador especificado, e recebe uma correspondente mensagem de resposta de eco ICMP desse computador como uma operação assíncrona. Esta sobrecarga permite especificar um valor de time-out para a operação, um buffer para enviar e receber, valores de fragmentação de controlo e Time-to-Live, e um CancellationToken para o pacote de mensagens 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 que é o destino da mensagem de eco ICMP. O valor especificado para este parâmetro pode ser um nome de host ou uma representação em cadeia de um endereço IP.
- timeout
- TimeSpan
O tempo necessário (após enviar a mensagem de eco) para esperar pela mensagem de resposta do eco ICMP.
- buffer
- Byte[]
Um Byte array que contém dados a serem enviados com a mensagem de eco ICMP e devolvidos na mensagem de resposta de eco ICMP. O array não pode conter mais de 65.500 bytes.
- options
- PingOptions
Um PingOptions objeto usado para controlar a fragmentação e os valores Time-to-Live para o pacote de mensagens de eco ICMP.
- cancellationToken
- CancellationToken
O token para monitorizar pedidos de cancelamento. O valor predefinido é None.
Devoluções
O objeto tarefa que representa a operação assíncrona.
Exceções
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Aplica-se a
SendPingAsync(IPAddress)
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
Envie uma mensagem de eco do Protocolo de Mensagens de Controlo da Internet (ICMP) com o buffer de dados especificado para o computador que tenha o especificado IPAddress, e que receba uma correspondente mensagem de resposta de eco ICMP 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.
Devoluções
O objeto tarefa que representa a operação assíncrona.
Exceções
address é null.
Está em curso uma chamada para SendPingAsync .
Foi lançada uma exceção durante o envio ou receção das mensagens ICMP. Veja a exceção interna para a exceção exata que foi lançada.
address não é um endereço IP válido.
Este objeto foi descartado.
Observações
Esta operação não vai bloquear. O objeto devolvido Task<TResult>> será concluído depois de o pacote ICMP ter sido enviado e a resposta recebida.
Aplica-se a
SendPingAsync(String)
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
Envia uma mensagem de eco do Protocolo de Mensagens de Controlo da Internet (ICMP) com o buffer de dados especificado para o computador especificado, e recebe uma correspondente mensagem de resposta de eco ICMP 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 este parâmetro pode ser um nome de host ou uma representação em cadeia de um endereço IP.
Devoluções
O objeto tarefa que representa a operação assíncrona.
Exceções
hostNameOrAddress é null ou é uma cadeia vazia ("").
Está em curso um apelo ao SendAsync(String, Object) método.
Foi lançada uma exceção durante o envio ou receção das mensagens ICMP. Veja a exceção interna para a exceção exata que foi lançada.
hostNameOrAddress não foi possível resolver para um endereço IP válido.
Este objeto foi descartado.
Observações
Esta operação não vai bloquear. O objeto devolvido Task<TResult>> será concluído depois de o pacote ICMP ter sido enviado e a resposta recebida.
Aplica-se a
SendPingAsync(IPAddress, Int32)
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
Envie uma mensagem de eco do Protocolo de Mensagens de Controlo da Internet (ICMP) com o buffer de dados especificado para o computador que tenha o especificado IPAddress, e que receba uma correspondente mensagem de resposta de eco ICMP desse computador como uma operação assíncrona. Esta sobrecarga permite-lhe especificar um valor de time-out 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 (após enviar a mensagem eco) para esperar pela mensagem de resposta eco ICMP.
Devoluções
O objeto tarefa que representa a operação assíncrona.
Exceções
address é null.
Está em curso uma chamada para o SendAsync método.
Foi lançada uma exceção durante o envio ou receção das mensagens ICMP. Veja a exceção interna para a exceção exata que foi lançada.
address não é um endereço IP válido.
Este objeto foi descartado.
Observações
Esta operação não vai bloquear. O objeto devolvido Task<TResult>> será concluído depois de o pacote ICMP ter sido enviado e a resposta recebida.
Aplica-se a
SendPingAsync(String, Int32)
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
Envia uma mensagem de eco do Protocolo de Mensagens de Controlo da Internet (ICMP) com o buffer de dados especificado para o computador especificado, e recebe uma correspondente mensagem de resposta de eco ICMP desse computador como uma operação assíncrona. Esta sobrecarga permite-lhe especificar um valor de time-out 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 este parâmetro pode ser um nome de host ou uma representação em cadeia de um endereço IP.
- timeout
- Int32
O número máximo de milissegundos (após enviar a mensagem eco) para esperar pela mensagem de resposta eco ICMP.
Devoluções
O objeto tarefa que representa a operação assíncrona.
Exceções
hostNameOrAddress é null.
timeout é inferior a zero.
Está em curso uma chamada para o SendAsync método.
Foi lançada uma exceção durante o envio ou receção das mensagens ICMP. Veja a exceção interna para a exceção exata que foi lançada.
hostNameOrAddress não é um endereço IP válido.
Este objeto foi descartado.
Observações
Esta operação não vai bloquear. O objeto devolvido Task<TResult>> será concluído depois de o pacote ICMP ter sido enviado e a resposta recebida.
Aplica-se a
SendPingAsync(IPAddress, Int32, Byte[])
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
Envie uma mensagem de eco do Protocolo de Mensagens de Controlo da Internet (ICMP) com o buffer de dados especificado para o computador que tenha o especificado IPAddress, e que receba uma correspondente mensagem de resposta de eco ICMP desse computador como uma operação assíncrona. Esta sobrecarga permite especificar um valor de time-out para a operação e um buffer 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 que é o destino da mensagem de eco ICMP.
- timeout
- Int32
O número máximo de milissegundos (após enviar a mensagem eco) para esperar pela mensagem de resposta eco ICMP.
- buffer
- Byte[]
Um Byte array que contém dados a serem enviados com a mensagem de eco ICMP e devolvidos na mensagem de resposta de eco ICMP. O array não pode conter mais de 65.500 bytes.
Devoluções
O objeto tarefa que representa a operação assíncrona.
Exceções
address ou buffer é null.
timeout é inferior a zero.
Está em curso uma chamada para SendPingAsync .
Foi lançada uma exceção durante o envio ou receção das mensagens ICMP. Veja a exceção interna para a exceção exata que foi lançada.
address não é um endereço IP válido.
Este objeto foi descartado.
O tamanho de buffer ultrapassa os 65.500 bytes.
.NET versões 7 e posteriores apenas em Linux: O processo não tem privilégios e buffer não está vazio.
Observações
Esta operação não vai bloquear. O objeto devolvido Task<TResult>> será concluído depois de o pacote ICMP ter sido enviado e a resposta recebida.
Aplica-se a
SendPingAsync(String, Int32, Byte[])
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
Envia uma mensagem de eco do Protocolo de Mensagens de Controlo da Internet (ICMP) com o buffer de dados especificado para o computador especificado, e recebe uma correspondente mensagem de resposta de eco ICMP desse computador como uma operação assíncrona. Esta sobrecarga permite especificar um valor de time-out para a operação e um buffer 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 que é o destino da mensagem de eco ICMP. O valor especificado para este parâmetro pode ser um nome de host ou uma representação em cadeia de um endereço IP.
- timeout
- Int32
O número máximo de milissegundos (após enviar a mensagem eco) para esperar pela mensagem de resposta eco ICMP.
- buffer
- Byte[]
Um Byte array que contém dados a serem enviados com a mensagem de eco ICMP e devolvidos na mensagem de resposta de eco ICMP. O array não pode conter mais de 65.500 bytes.
Devoluções
O objeto tarefa que representa a operação assíncrona.
Exceções
timeout é inferior a zero.
Está em curso uma chamada para SendAsync .
Foi lançada uma exceção durante o envio ou receção das mensagens ICMP. Veja a exceção interna para a exceção exata que foi lançada.
hostNameOrAddress não foi possível resolver para um endereço IP válido.
Este objeto foi descartado.
O tamanho de buffer ultrapassa os 65500 bytes.
.NET versões 7 e posteriores apenas em Linux: O processo não tem privilégios e buffer não está vazio.
Observações
Esta operação não vai bloquear. O objeto devolvido Task<TResult>> será concluído depois de o pacote ICMP ter sido enviado e a resposta recebida.
Aplica-se a
SendPingAsync(IPAddress, Int32, Byte[], PingOptions)
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
Envia uma mensagem de eco do Protocolo de Mensagens de Controlo da Internet (ICMP) com o buffer de dados especificado para o computador que tem o especificado IPAddress, e recebe uma correspondente mensagem de resposta de eco ICMP desse computador como uma operação assíncrona. Esta sobrecarga permite especificar um valor de time-out para a operação, um buffer para enviar e receber, e controlar a fragmentação e os valores Time-to-Live 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 que é o destino da mensagem de eco ICMP.
- timeout
- Int32
O número máximo de milissegundos (após enviar a mensagem eco) para esperar pela mensagem de resposta eco ICMP.
- buffer
- Byte[]
Um Byte array que contém dados a serem enviados com a mensagem de eco ICMP e devolvidos na mensagem de resposta de eco ICMP. O array não pode conter mais de 65.500 bytes.
- options
- PingOptions
Um PingOptions objeto usado para controlar a fragmentação e os valores Time-to-Live para o pacote de mensagens de eco ICMP.
Devoluções
O objeto tarefa que representa a operação assíncrona.
Exceções
address ou buffer é null.
timeout é inferior a zero.
Está em curso uma chamada para SendPingAsync .
Foi lançada uma exceção durante o envio ou receção das mensagens ICMP. Veja a exceção interna para a exceção exata que foi lançada.
address não é um endereço IP válido.
Este objeto foi descartado.
O tamanho de buffer ultrapassa os 65.500 bytes.
.NET versões 7 e posteriores apenas em Linux: O processo não tem privilégios e buffer não está vazio.
Observações
Esta operação não vai bloquear. O objeto devolvido Task<TResult>> será concluído depois de o pacote ICMP ter sido enviado e a resposta recebida.
Aplica-se a
SendPingAsync(String, Int32, Byte[], PingOptions)
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
Envia uma mensagem de eco do Protocolo de Mensagens de Controlo da Internet (ICMP) com o buffer de dados especificado para o computador especificado, e recebe uma correspondente mensagem de resposta de eco ICMP desse computador como uma operação assíncrona. Esta sobrecarga permite especificar um valor de time-out para a operação, um buffer para enviar e receber, e controlar a fragmentação e os valores Time-to-Live 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 que é o destino da mensagem de eco ICMP. O valor especificado para este parâmetro pode ser um nome de host ou uma representação em cadeia de um endereço IP.
- timeout
- Int32
O número máximo de milissegundos (após enviar a mensagem eco) para esperar pela mensagem de resposta eco ICMP.
- buffer
- Byte[]
Um Byte array que contém dados a serem enviados com a mensagem de eco ICMP e devolvidos na mensagem de resposta de eco ICMP. O array não pode conter mais de 65.500 bytes.
- options
- PingOptions
Um PingOptions objeto usado para controlar a fragmentação e os valores Time-to-Live para o pacote de mensagens de eco ICMP.
Devoluções
O objeto tarefa que representa a operação assíncrona.
Exceções
timeout é inferior a zero.
Está em curso uma chamada para SendAsync .
Foi lançada uma exceção durante o envio ou receção das mensagens ICMP. Veja a exceção interna para a exceção exata que foi lançada.
hostNameOrAddress não foi possível resolver para um endereço IP válido.
Este objeto foi descartado.
O tamanho de buffer ultrapassa os 65500 bytes.
.NET versões 7 e posteriores apenas em Linux: O processo não tem privilégios e buffer não está vazio.
Observações
Esta operação não vai bloquear. O objeto devolvido Task<TResult>> será concluído depois de o pacote ICMP ter sido enviado e a resposta recebida.
Aplica-se a
SendPingAsync(IPAddress, TimeSpan, Byte[], PingOptions, CancellationToken)
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
- Origem:
- Ping.cs
Envia uma mensagem de eco do Protocolo de Mensagens de Controlo da Internet (ICMP) com o buffer de dados especificado para o computador que tem o especificado IPAddress, e recebe uma correspondente mensagem de resposta de eco ICMP desse computador como uma operação assíncrona. Esta sobrecarga permite especificar um valor de time-out para a operação, um buffer para enviar e receber, valores de fragmentação de controlo e Time-to-Live, e um CancellationToken para o pacote de mensagens 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 que é o destino da mensagem de eco ICMP.
- timeout
- TimeSpan
O tempo necessário (após enviar a mensagem de eco) para esperar pela mensagem de resposta do eco ICMP.
- buffer
- Byte[]
Um Byte array que contém dados a serem enviados com a mensagem de eco ICMP e devolvidos na mensagem de resposta de eco ICMP. O array não pode conter mais de 65.500 bytes.
- options
- PingOptions
Um PingOptions objeto usado para controlar a fragmentação e os valores Time-to-Live para o pacote de mensagens de eco ICMP.
- cancellationToken
- CancellationToken
O token para monitorizar pedidos de cancelamento. O valor predefinido é None.
Devoluções
O objeto tarefa que representa a operação assíncrona.
Exceções
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
