Condividi tramite

Ping.SendPingAsync Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Net.NetworkInformation
Assembly:
System.Net.Ping.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Invia un messaggio echo ICMP (Internet Control Message Protocol) a un computer remoto e riceve il messaggio di risposta echo ICMP corrispondente dal quel computer come operazione asincrona.

Overload

SendPingAsync(String, TimeSpan, Byte[], PingOptions, CancellationToken)

Invia un messaggio echo ICMP (Internet Control Message Protocol) con il buffer di dati specificato nel computer specificato e riceve un messaggio di risposta echo ICMP corrispondente da tale computer come operazione asincrona. Questo overload consente di specificare un valore di timeout per l'operazione, un buffer da usare per l'invio e la ricezione, la frammentazione del controllo e i valori time-to-Live e un CancellationToken per il pacchetto di messaggi echo ICMP.
SendPingAsync(IPAddress)

Invia un messaggio echo ICMP (Internet Control Message Protocol) con il buffer di dati specificato al computer con il IPAddress specificato e riceve il messaggio di risposta echo ICMP corrispondente da quel computer come operazione asincrona.
SendPingAsync(String)

Invia un messaggio echo ICMP (Internet Control Message Protocol) con il buffer di dati specificato al computer remoto specificato e riceve il messaggio di risposta echo ICMP corrispondente da quest'ultimo come operazione asincrona.
SendPingAsync(IPAddress, Int32)

Invia un messaggio echo ICMP (Internet Control Message Protocol) con il buffer di dati specificato al computer con il IPAddress specificato e riceve il messaggio di risposta echo ICMP corrispondente da quel computer come operazione asincrona. Questo overload consente di specificare un valore di timeout per l'operazione.
SendPingAsync(String, Int32)

Invia un messaggio echo ICMP (Internet Control Message Protocol) con il buffer di dati specificato al computer remoto specificato e riceve il messaggio di risposta echo ICMP corrispondente da quest'ultimo come operazione asincrona. Questo overload consente di specificare un valore di timeout per l'operazione.
SendPingAsync(IPAddress, Int32, Byte[])

Invia un messaggio echo ICMP (Internet Control Message Protocol) con il buffer di dati specificato al computer con il IPAddress specificato e riceve il messaggio di risposta echo ICMP corrispondente da quel computer come operazione asincrona. Questo overload consente di specificare un valore di timeout per l'operazione e un buffer da utilizzare per inviare e ricevere.
SendPingAsync(String, Int32, Byte[])

Invia un messaggio echo ICMP (Internet Control Message Protocol) con il buffer di dati specificato al computer remoto specificato e riceve il messaggio di risposta echo ICMP corrispondente da quest'ultimo come operazione asincrona. Questo overload consente di specificare un valore di timeout per l'operazione e un buffer da utilizzare per inviare e ricevere.
SendPingAsync(IPAddress, Int32, Byte[], PingOptions)

Invia un messaggio echo ICMP (Internet Control Message Protocol) con il buffer di dati specificato al computer con il IPAddress specificato e riceve il messaggio di risposta echo ICMP corrispondente da quel computer come operazione asincrona. Questo overload consente di specificare un valore di timeout per l'operazione, un buffer da utilizzare per inviare, ricevere e controllare la frammentazione e i valori TTL (Time-to-Live) per il pacchetto del messaggio echo ICMP.
SendPingAsync(String, Int32, Byte[], PingOptions)

Invia un messaggio echo ICMP (Internet Control Message Protocol) con il buffer di dati specificato al computer remoto specificato e riceve il messaggio di risposta echo ICMP corrispondente da quest'ultimo come operazione asincrona. Questo overload consente di specificare un valore di timeout per l'operazione, un buffer da utilizzare per inviare, ricevere e controllare la frammentazione e i valori TTL (Time-to-Live) per il pacchetto del messaggio echo ICMP.
SendPingAsync(IPAddress, TimeSpan, Byte[], PingOptions, CancellationToken)

Invia un messaggio echo ICMP (Internet Control Message Protocol) con il buffer di dati specificato al computer con il IPAddress specificato e riceve il messaggio di risposta echo ICMP corrispondente da quel computer come operazione asincrona. Questo overload consente di specificare un valore di timeout per l'operazione, un buffer da usare per l'invio e la ricezione, la frammentazione del controllo e i valori time-to-Live e un CancellationToken per il pacchetto di messaggi echo ICMP.

Commenti

L'indirizzo IP restituito da uno dei SendPingAsync metodi può originarsi da un computer remoto dannoso. Non connettersi al computer remoto usando questa operazione. Usare DNS per determinare l'indirizzo IP del computer a cui si vuole connettersi.

SendPingAsync(String, TimeSpan, Byte[], PingOptions, CancellationToken)

Origine:
Ping.cs
Origine:
Ping.cs

Invia un messaggio echo ICMP (Internet Control Message Protocol) con il buffer di dati specificato nel computer specificato e riceve un messaggio di risposta echo ICMP corrispondente da tale computer come operazione asincrona. Questo overload consente di specificare un valore di timeout per l'operazione, un buffer da usare per l'invio e la ricezione, la frammentazione del controllo e i valori time-to-Live e un CancellationToken per il pacchetto di messaggi echo 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)

Parametri

hostNameOrAddress
String

Computer che è la destinazione del messaggio echo ICMP. Il valore specificato per il parametro può essere un nome host o una rappresentazione in forma di stringa di un indirizzo IP.

timeout
TimeSpan

Tempo (dopo l'invio del messaggio echo) per attendere il messaggio di risposta echo ICMP.

buffer
Byte[]

Matrice Byte contenente i dati da inviare con il messaggio echo ICMP e restituiti nel messaggio di risposta echo ICMP. La matrice non può contenere più di 65.500 byte.

options
PingOptions

Oggetto PingOptions utilizzato per controllare la frammentazione e i valori TTL (Time-to-Live) per il pacchetto del messaggio echo ICMP.

cancellationToken
CancellationToken

Token da monitorare per le richieste di annullamento. Il valore predefinito è None.

Restituisce

Task<PingReply>

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Si applica a

SendPingAsync(IPAddress)

Origine:
Ping.cs
Origine:
Ping.cs
Origine:
Ping.cs

Invia un messaggio echo ICMP (Internet Control Message Protocol) con il buffer di dati specificato al computer con il IPAddress specificato e riceve il messaggio di risposta echo ICMP corrispondente da quel computer come operazione asincrona.

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)

Parametri

address
IPAddress

Indirizzo IP che identifica il computer di destinazione del messaggio echo ICMP.

Restituisce

Task<PingReply>

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

ArgumentNullException

address è null.

InvalidOperationException

È in corso una chiamata a SendPingAsync.

PingException

È stata generata un'eccezione durante l'invio o la ricezione di messaggi ICMP. Per conoscere l'eccezione esatta generata, vedere l'eccezione interna.

SocketException

address non è un indirizzo IP valido.

ObjectDisposedException

L'oggetto è stato eliminato.

Commenti

Questa operazione non verrà bloccata. L'oggetto restituito verrà completato dopo l'invio del pacchetto ICMP e la risposta è stata ricevuta Task<TResult>> .

Si applica a

SendPingAsync(String)

Origine:
Ping.cs
Origine:
Ping.cs
Origine:
Ping.cs

Invia un messaggio echo ICMP (Internet Control Message Protocol) con il buffer di dati specificato al computer remoto specificato e riceve il messaggio di risposta echo ICMP corrispondente da quest'ultimo come operazione asincrona.

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)

Parametri

hostNameOrAddress
String

Computer che è la destinazione del messaggio echo ICMP. Il valore specificato per il parametro può essere un nome host o una rappresentazione in forma di stringa di un indirizzo IP.

Restituisce

Task<PingReply>

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

ArgumentNullException

hostNameOrAddress è null o è una stringa vuota ("").

InvalidOperationException

È in corso una chiamata al metodo SendAsync(String, Object).

PingException

È stata generata un'eccezione durante l'invio o la ricezione di messaggi ICMP. Per conoscere l'eccezione esatta generata, vedere l'eccezione interna.

SocketException

Non è possibile risolvere hostNameOrAddress in un indirizzo IP valido.

ObjectDisposedException

L'oggetto è stato eliminato.

Commenti

Questa operazione non verrà bloccata. L'oggetto restituito verrà completato dopo l'invio del pacchetto ICMP e la risposta è stata ricevuta Task<TResult>> .

Si applica a

SendPingAsync(IPAddress, Int32)

Origine:
Ping.cs
Origine:
Ping.cs
Origine:
Ping.cs

Invia un messaggio echo ICMP (Internet Control Message Protocol) con il buffer di dati specificato al computer con il IPAddress specificato e riceve il messaggio di risposta echo ICMP corrispondente da quel computer come operazione asincrona. Questo overload consente di specificare un valore di timeout per l'operazione.

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)

Parametri

address
IPAddress

Indirizzo IP che identifica il computer di destinazione del messaggio echo ICMP.

timeout
Int32

Numero massimo di millisecondi durante i quali attendere il messaggio di risposta echo ICMP dopo l'invio del messaggio echo.

Restituisce

Task<PingReply>

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

ArgumentNullException

address è null.

InvalidOperationException

È in corso una chiamata al metodo SendAsync.

PingException

È stata generata un'eccezione durante l'invio o la ricezione di messaggi ICMP. Per conoscere l'eccezione esatta generata, vedere l'eccezione interna.

SocketException

address non è un indirizzo IP valido.

ObjectDisposedException

L'oggetto è stato eliminato.

Commenti

Questa operazione non verrà bloccata. L'oggetto restituito verrà completato dopo l'invio del pacchetto ICMP e la risposta è stata ricevuta Task<TResult>> .

Si applica a

SendPingAsync(String, Int32)

Origine:
Ping.cs
Origine:
Ping.cs
Origine:
Ping.cs

Invia un messaggio echo ICMP (Internet Control Message Protocol) con il buffer di dati specificato al computer remoto specificato e riceve il messaggio di risposta echo ICMP corrispondente da quest'ultimo come operazione asincrona. Questo overload consente di specificare un valore di timeout per l'operazione.

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)

Parametri

hostNameOrAddress
String

Computer che è la destinazione del messaggio echo ICMP. Il valore specificato per il parametro può essere un nome host o una rappresentazione in forma di stringa di un indirizzo IP.

timeout
Int32

Numero massimo di millisecondi durante i quali attendere il messaggio di risposta echo ICMP dopo l'invio del messaggio echo.

Restituisce

Task<PingReply>

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

ArgumentNullException

address è null.

ArgumentOutOfRangeException

timeout è minore di zero.

InvalidOperationException

È in corso una chiamata al metodo SendAsync.

PingException

È stata generata un'eccezione durante l'invio o la ricezione di messaggi ICMP. Per conoscere l'eccezione esatta generata, vedere l'eccezione interna.

SocketException

address non è un indirizzo IP valido.

ObjectDisposedException

L'oggetto è stato eliminato.

Commenti

Questa operazione non verrà bloccata. L'oggetto restituito verrà completato dopo l'invio del pacchetto ICMP e la risposta è stata ricevuta Task<TResult>> .

Si applica a

SendPingAsync(IPAddress, Int32, Byte[])

Origine:
Ping.cs
Origine:
Ping.cs
Origine:
Ping.cs

Invia un messaggio echo ICMP (Internet Control Message Protocol) con il buffer di dati specificato al computer con il IPAddress specificato e riceve il messaggio di risposta echo ICMP corrispondente da quel computer come operazione asincrona. Questo overload consente di specificare un valore di timeout per l'operazione e un buffer da utilizzare per inviare e ricevere.

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)

Parametri

address
IPAddress

Indirizzo IP che identifica il computer di destinazione del messaggio echo ICMP.

timeout
Int32

Numero massimo di millisecondi durante i quali attendere il messaggio di risposta echo ICMP dopo l'invio del messaggio echo.

buffer
Byte[]

Matrice Byte contenente i dati da inviare con il messaggio echo ICMP e restituiti nel messaggio di risposta echo ICMP. La matrice non può contenere più di 65.500 byte.

Restituisce

Task<PingReply>

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

ArgumentNullException

address o buffer è null.

ArgumentOutOfRangeException

timeout è minore di zero.

InvalidOperationException

È in corso una chiamata a SendPingAsync.

PingException

È stata generata un'eccezione durante l'invio o la ricezione di messaggi ICMP. Per conoscere l'eccezione esatta generata, vedere l'eccezione interna.

SocketException

address non è un indirizzo IP valido.

ObjectDisposedException

L'oggetto è stato eliminato.

ArgumentException

Le dimensioni di buffer superano 65.500 byte.

PlatformNotSupportedException

.NET 7 e versioni successive solo in Linux: il processo non è con privilegi e buffer non è vuoto.

Commenti

Questa operazione non verrà bloccata. L'oggetto restituito verrà completato dopo l'invio del pacchetto ICMP e la risposta è stata ricevuta Task<TResult>> .

Si applica a

SendPingAsync(String, Int32, Byte[])

Origine:
Ping.cs
Origine:
Ping.cs
Origine:
Ping.cs

Invia un messaggio echo ICMP (Internet Control Message Protocol) con il buffer di dati specificato al computer remoto specificato e riceve il messaggio di risposta echo ICMP corrispondente da quest'ultimo come operazione asincrona. Questo overload consente di specificare un valore di timeout per l'operazione e un buffer da utilizzare per inviare e ricevere.

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)

Parametri

hostNameOrAddress
String

Computer che è la destinazione del messaggio echo ICMP. Il valore specificato per il parametro può essere un nome host o una rappresentazione in forma di stringa di un indirizzo IP.

timeout
Int32

Numero massimo di millisecondi durante i quali attendere il messaggio di risposta echo ICMP dopo l'invio del messaggio echo.

buffer
Byte[]

Matrice Byte contenente i dati da inviare con il messaggio echo ICMP e restituiti nel messaggio di risposta echo ICMP. La matrice non può contenere più di 65.500 byte.

Restituisce

Task<PingReply>

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

ArgumentNullException

hostNameOrAddress è null o è una stringa vuota ("").

-oppure-

buffer è null.

ArgumentOutOfRangeException

timeout è minore di zero.

InvalidOperationException

È in corso una chiamata a SendAsync.

PingException

È stata generata un'eccezione durante l'invio o la ricezione di messaggi ICMP. Per conoscere l'eccezione esatta generata, vedere l'eccezione interna.

SocketException

Non è possibile risolvere hostNameOrAddress in un indirizzo IP valido.

ObjectDisposedException

L'oggetto è stato eliminato.

ArgumentException

Le dimensioni di buffer superano i 65.500 byte.

PlatformNotSupportedException

.NET 7 e versioni successive solo in Linux: il processo non è con privilegi e buffer non è vuoto.

Commenti

Questa operazione non verrà bloccata. L'oggetto restituito verrà completato dopo l'invio del pacchetto ICMP e la risposta è stata ricevuta Task<TResult>> .

Si applica a

SendPingAsync(IPAddress, Int32, Byte[], PingOptions)

Origine:
Ping.cs
Origine:
Ping.cs
Origine:
Ping.cs

Invia un messaggio echo ICMP (Internet Control Message Protocol) con il buffer di dati specificato al computer con il IPAddress specificato e riceve il messaggio di risposta echo ICMP corrispondente da quel computer come operazione asincrona. Questo overload consente di specificare un valore di timeout per l'operazione, un buffer da utilizzare per inviare, ricevere e controllare la frammentazione e i valori TTL (Time-to-Live) per il pacchetto del messaggio echo 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)

Parametri

address
IPAddress

Indirizzo IP che identifica il computer di destinazione del messaggio echo ICMP.

timeout
Int32

Numero massimo di millisecondi durante i quali attendere il messaggio di risposta echo ICMP dopo l'invio del messaggio echo.

buffer
Byte[]

Matrice Byte contenente i dati da inviare con il messaggio echo ICMP e restituiti nel messaggio di risposta echo ICMP. La matrice non può contenere più di 65.500 byte.

options
PingOptions

Oggetto PingOptions utilizzato per controllare la frammentazione e i valori TTL (Time-to-Live) per il pacchetto del messaggio echo ICMP.

Restituisce

Task<PingReply>

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

ArgumentNullException

address o buffer è null.

ArgumentOutOfRangeException

timeout è minore di zero.

InvalidOperationException

È in corso una chiamata a SendPingAsync.

PingException

È stata generata un'eccezione durante l'invio o la ricezione di messaggi ICMP. Per conoscere l'eccezione esatta generata, vedere l'eccezione interna.

SocketException

address non è un indirizzo IP valido.

ObjectDisposedException

L'oggetto è stato eliminato.

ArgumentException

Le dimensioni di buffer superano 65.500 byte.

PlatformNotSupportedException

.NET 7 e versioni successive solo in Linux: il processo non è con privilegi e buffer non è vuoto.

Commenti

Questa operazione non verrà bloccata. L'oggetto restituito verrà completato dopo l'invio del pacchetto ICMP e la risposta è stata ricevuta Task<TResult>> .

Si applica a

SendPingAsync(String, Int32, Byte[], PingOptions)

Origine:
Ping.cs
Origine:
Ping.cs
Origine:
Ping.cs

Invia un messaggio echo ICMP (Internet Control Message Protocol) con il buffer di dati specificato al computer remoto specificato e riceve il messaggio di risposta echo ICMP corrispondente da quest'ultimo come operazione asincrona. Questo overload consente di specificare un valore di timeout per l'operazione, un buffer da utilizzare per inviare, ricevere e controllare la frammentazione e i valori TTL (Time-to-Live) per il pacchetto del messaggio echo 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)

Parametri

hostNameOrAddress
String

Computer che è la destinazione del messaggio echo ICMP. Il valore specificato per il parametro può essere un nome host o una rappresentazione in forma di stringa di un indirizzo IP.

timeout
Int32

Numero massimo di millisecondi durante i quali attendere il messaggio di risposta echo ICMP dopo l'invio del messaggio echo.

buffer
Byte[]

Matrice Byte contenente i dati da inviare con il messaggio echo ICMP e restituiti nel messaggio di risposta echo ICMP. La matrice non può contenere più di 65.500 byte.

options
PingOptions

Oggetto PingOptions utilizzato per controllare la frammentazione e i valori TTL (Time-to-Live) per il pacchetto del messaggio echo ICMP.

Restituisce

Task<PingReply>

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

ArgumentNullException

hostNameOrAddress è null o è una stringa vuota ("").

-oppure-

buffer è null.

ArgumentOutOfRangeException

timeout è minore di zero.

InvalidOperationException

È in corso una chiamata a SendAsync.

PingException

È stata generata un'eccezione durante l'invio o la ricezione di messaggi ICMP. Per conoscere l'eccezione esatta generata, vedere l'eccezione interna.

SocketException

Non è possibile risolvere hostNameOrAddress in un indirizzo IP valido.

ObjectDisposedException

L'oggetto è stato eliminato.

ArgumentException

Le dimensioni di buffer superano i 65.500 byte.

PlatformNotSupportedException

.NET 7 e versioni successive solo in Linux: il processo non è con privilegi e buffer non è vuoto.

Commenti

Questa operazione non verrà bloccata. L'oggetto restituito verrà completato dopo l'invio del pacchetto ICMP e la risposta è stata ricevuta Task<TResult>> .

Si applica a

SendPingAsync(IPAddress, TimeSpan, Byte[], PingOptions, CancellationToken)

Origine:
Ping.cs
Origine:
Ping.cs

Invia un messaggio echo ICMP (Internet Control Message Protocol) con il buffer di dati specificato al computer con il IPAddress specificato e riceve il messaggio di risposta echo ICMP corrispondente da quel computer come operazione asincrona. Questo overload consente di specificare un valore di timeout per l'operazione, un buffer da usare per l'invio e la ricezione, la frammentazione del controllo e i valori time-to-Live e un CancellationToken per il pacchetto di messaggi echo 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)

Parametri

address
IPAddress

Indirizzo IP che identifica il computer di destinazione del messaggio echo ICMP.

timeout
TimeSpan

Tempo (dopo l'invio del messaggio echo) per attendere il messaggio di risposta echo ICMP.

buffer
Byte[]

Matrice Byte contenente i dati da inviare con il messaggio echo ICMP e restituiti nel messaggio di risposta echo ICMP. La matrice non può contenere più di 65.500 byte.

options
PingOptions

Oggetto PingOptions utilizzato per controllare la frammentazione e i valori TTL (Time-to-Live) per il pacchetto del messaggio echo ICMP.

cancellationToken
CancellationToken

Token da monitorare per le richieste di annullamento. Il valore predefinito è None.

Restituisce

Task<PingReply>

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Si applica a