Ping.SendPingAsync Método
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.
| 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. |
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.
- 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
.NET 9 e .NET 8
| Produto | Versões |
|---|---|
| .NET | 8, 9 |
- 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
.NET 9 e outras versões
| Produto | Versões |
|---|---|
| .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 |
- 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
.NET 9 e outras versões
| Produto | Versões |
|---|---|
| .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 |
- 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
.NET 9 e outras versões
| Produto | Versões |
|---|---|
| .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 |
- 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
.NET 9 e outras versões
| Produto | Versões |
|---|---|
| .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 |
- 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
.NET 9 e outras versões
| Produto | Versões |
|---|---|
| .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 |
- 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
.NET 9 e outras versões
| Produto | Versões |
|---|---|
| .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 |
- 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
.NET 9 e outras versões
| Produto | Versões |
|---|---|
| .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 |
- 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
.NET 9 e outras versões
| Produto | Versões |
|---|---|
| .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 |
- 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.
Aplica-se a
.NET 9 e .NET 8
| Produto | Versões |
|---|---|
| .NET | 8, 9 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: