Ping.SendPingAsync Metoda

Definicja

Wysyła do komputera komunikat echa protokołu ICMP (Internet Control Message Protocol) i odbiera odpowiedni komunikat odpowiedzi echa ICMP z tego komputera jako operację asynchroniczną.

Przeciążenia

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

Wysyła komunikat echa protokołu ICMP (Internet Control Message Protocol) z określonym buforem danych do określonego komputera i odbiera odpowiedni komunikat odpowiedzi echa ICMP z tego komputera jako operację asynchroniczną. To przeciążenie umożliwia określenie wartości limitu czasu dla operacji, buforu do użycia na potrzeby wysyłania i odbierania, fragmentacji sterowania i wartości czasu wygaśnięcia oraz CancellationToken pakietu komunikatów echa ICMP.

SendPingAsync(IPAddress)

Wyślij komunikat echa protokołu ICMP (Internet Control Message Protocol) z określonym buforem danych do komputera, który ma określony IPAddresselement , i odbiera odpowiedni komunikat odpowiedzi echa ICMP z tego komputera jako operację asynchroniczną.

SendPingAsync(String)

Wysyła komunikat echa protokołu ICMP (Internet Control Message Protocol) z określonym buforem danych do określonego komputera i odbiera odpowiedni komunikat odpowiedzi echa ICMP z tego komputera jako operację asynchroniczną.

SendPingAsync(IPAddress, Int32)

Wyślij komunikat echa protokołu ICMP (Internet Control Message Protocol) z określonym buforem danych do komputera, który ma określony IPAddresselement , i odbiera odpowiedni komunikat odpowiedzi echa ICMP z tego komputera jako operację asynchroniczną. To przeciążenie umożliwia określenie wartości limitu czasu dla operacji.

SendPingAsync(String, Int32)

Wysyła komunikat echa protokołu ICMP (Internet Control Message Protocol) z określonym buforem danych do określonego komputera i odbiera odpowiedni komunikat odpowiedzi echa ICMP z tego komputera jako operację asynchroniczną. To przeciążenie umożliwia określenie wartości limitu czasu dla operacji.

SendPingAsync(IPAddress, Int32, Byte[])

Wyślij komunikat echa protokołu ICMP (Internet Control Message Protocol) z określonym buforem danych do komputera, który ma określony IPAddresselement , i odbiera odpowiedni komunikat odpowiedzi echa ICMP z tego komputera jako operację asynchroniczną. To przeciążenie umożliwia określenie wartości limitu czasu dla operacji i buforu do użycia na potrzeby wysyłania i odbierania.

SendPingAsync(String, Int32, Byte[])

Wysyła komunikat echa protokołu ICMP (Internet Control Message Protocol) z określonym buforem danych do określonego komputera i odbiera odpowiedni komunikat odpowiedzi echa ICMP z tego komputera jako operację asynchroniczną. To przeciążenie umożliwia określenie wartości limitu czasu dla operacji i buforu do użycia na potrzeby wysyłania i odbierania.

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

Wysyła komunikat echa protokołu ICMP (Internet Control Message Protocol) z określonym buforem danych do komputera, który ma określony IPAddresselement , i odbiera odpowiedni komunikat odpowiedzi echa ICMP z tego komputera jako operację asynchroniczną. To przeciążenie umożliwia określenie wartości limitu czasu dla operacji, buforu do użycia na potrzeby wysyłania i odbierania oraz fragmentacji kontroli oraz wartości czasu wygaśnięcia dla pakietu komunikatów echa ICMP.

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

Wysyła komunikat echa protokołu ICMP (Internet Control Message Protocol) z określonym buforem danych do określonego komputera i odbiera odpowiedni komunikat odpowiedzi echa ICMP z tego komputera jako operację asynchroniczną. To przeciążenie umożliwia określenie wartości limitu czasu dla operacji, buforu do użycia na potrzeby wysyłania i odbierania oraz fragmentacji kontroli oraz wartości czasu wygaśnięcia dla pakietu komunikatów echa ICMP.

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

Wysyła komunikat echa protokołu ICMP (Internet Control Message Protocol) z określonym buforem danych do komputera, który ma określony IPAddresselement , i odbiera odpowiedni komunikat odpowiedzi echa ICMP z tego komputera jako operację asynchroniczną. To przeciążenie umożliwia określenie wartości limitu czasu dla operacji, buforu do użycia na potrzeby wysyłania i odbierania, fragmentacji sterowania i wartości czasu wygaśnięcia oraz CancellationToken pakietu komunikatów echa ICMP.

Uwagi

Adres IP zwracany przez dowolną z SendPingAsync metod może pochodzić ze złośliwego komputera zdalnego. Nie należy łączyć się z komputerem zdalnym przy użyciu tego polecenia. Użyj systemu DNS, aby określić adres IP maszyny, z którą chcesz nawiązać połączenie.

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

Źródło:
Ping.cs
Źródło:
Ping.cs

Wysyła komunikat echa protokołu ICMP (Internet Control Message Protocol) z określonym buforem danych do określonego komputera i odbiera odpowiedni komunikat odpowiedzi echa ICMP z tego komputera jako operację asynchroniczną. To przeciążenie umożliwia określenie wartości limitu czasu dla operacji, buforu do użycia na potrzeby wysyłania i odbierania, fragmentacji sterowania i wartości czasu wygaśnięcia oraz CancellationToken pakietu komunikatów echa 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)

Parametry

hostNameOrAddress
String

Komputer, który jest miejscem docelowym komunikatu echa ICMP. Wartość określona dla tego parametru może być nazwą hosta lub ciągiem reprezentującym adres IP.

timeout
TimeSpan

Czas (po wysłaniu wiadomości e-mail) na oczekiwanie na komunikat odpowiedzi echa ICMP.

buffer
Byte[]

Tablica zawierająca Byte dane do wysłania z komunikatem echa ICMP i zwrócona w komunikacie odpowiedzi echa ICMP. Tablica nie może zawierać więcej niż 65 500 bajtów.

options
PingOptions

PingOptions Obiekt służący do kontrolowania fragmentacji i wartości time-to-Live dla pakietu komunikatów echa ICMP.

cancellationToken
CancellationToken

Token do monitorowania żądań anulowania. Wartość domyślna to None.

Zwraca

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Dotyczy

SendPingAsync(IPAddress)

Źródło:
Ping.cs
Źródło:
Ping.cs
Źródło:
Ping.cs

Wyślij komunikat echa protokołu ICMP (Internet Control Message Protocol) z określonym buforem danych do komputera, który ma określony IPAddresselement , i odbiera odpowiedni komunikat odpowiedzi echa ICMP z tego komputera jako operację asynchroniczną.

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)

Parametry

address
IPAddress

Adres IP identyfikujący komputer docelowy komunikatu echa ICMP.

Zwraca

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

address to null.

Wywołanie metody SendPingAsync jest w toku.

Podczas wysyłania lub odbierania komunikatów ICMP został zgłoszony wyjątek. Zobacz wyjątek wewnętrzny, aby uzyskać dokładny wyjątek, który został zgłoszony.

address nie jest prawidłowym adresem IP.

Ten obiekt został usunięty.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult>> po wysłaniu pakietu ICMP i odebraniu odpowiedzi.

Dotyczy

SendPingAsync(String)

Źródło:
Ping.cs
Źródło:
Ping.cs
Źródło:
Ping.cs

Wysyła komunikat echa protokołu ICMP (Internet Control Message Protocol) z określonym buforem danych do określonego komputera i odbiera odpowiedni komunikat odpowiedzi echa ICMP z tego komputera jako operację asynchroniczną.

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)

Parametry

hostNameOrAddress
String

Komputer, który jest miejscem docelowym komunikatu echa ICMP. Wartość określona dla tego parametru może być nazwą hosta lub ciągiem reprezentującym adres IP.

Zwraca

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

hostNameOrAddress jest null ciągiem pustym ("").

Wywołanie SendAsync(String, Object) metody jest w toku.

Podczas wysyłania lub odbierania komunikatów ICMP został zgłoszony wyjątek. Zobacz wyjątek wewnętrzny, aby uzyskać dokładny wyjątek, który został zgłoszony.

hostNameOrAddress Nie można rozpoznać prawidłowego adresu IP.

Ten obiekt został usunięty.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult>> po wysłaniu pakietu ICMP i odebraniu odpowiedzi.

Dotyczy

SendPingAsync(IPAddress, Int32)

Źródło:
Ping.cs
Źródło:
Ping.cs
Źródło:
Ping.cs

Wyślij komunikat echa protokołu ICMP (Internet Control Message Protocol) z określonym buforem danych do komputera, który ma określony IPAddresselement , i odbiera odpowiedni komunikat odpowiedzi echa ICMP z tego komputera jako operację asynchroniczną. To przeciążenie umożliwia określenie wartości limitu czasu dla operacji.

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)

Parametry

address
IPAddress

Adres IP identyfikujący komputer docelowy komunikatu echa ICMP.

timeout
Int32

Maksymalna liczba milisekund (po wysłaniu wiadomości e-mail) do oczekiwania na komunikat odpowiedzi echa ICMP.

Zwraca

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

address to null.

Wywołanie SendAsync metody jest w toku.

Podczas wysyłania lub odbierania komunikatów ICMP został zgłoszony wyjątek. Zobacz wyjątek wewnętrzny, aby uzyskać dokładny wyjątek, który został zgłoszony.

address nie jest prawidłowym adresem IP.

Ten obiekt został usunięty.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult>> po wysłaniu pakietu ICMP i odebraniu odpowiedzi.

Dotyczy

SendPingAsync(String, Int32)

Źródło:
Ping.cs
Źródło:
Ping.cs
Źródło:
Ping.cs

Wysyła komunikat echa protokołu ICMP (Internet Control Message Protocol) z określonym buforem danych do określonego komputera i odbiera odpowiedni komunikat odpowiedzi echa ICMP z tego komputera jako operację asynchroniczną. To przeciążenie umożliwia określenie wartości limitu czasu dla operacji.

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)

Parametry

hostNameOrAddress
String

Komputer, który jest miejscem docelowym komunikatu echa ICMP. Wartość określona dla tego parametru może być nazwą hosta lub ciągiem reprezentującym adres IP.

timeout
Int32

Maksymalna liczba milisekund (po wysłaniu wiadomości e-mail) do oczekiwania na komunikat odpowiedzi echa ICMP.

Zwraca

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

address to null.

Parametr timeout ma wartość niższą niż zero.

Wywołanie SendAsync metody jest w toku.

Podczas wysyłania lub odbierania komunikatów ICMP został zgłoszony wyjątek. Zobacz wyjątek wewnętrzny, aby uzyskać dokładny wyjątek, który został zgłoszony.

address nie jest prawidłowym adresem IP.

Ten obiekt został usunięty.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult>> po wysłaniu pakietu ICMP i odebraniu odpowiedzi.

Dotyczy

SendPingAsync(IPAddress, Int32, Byte[])

Źródło:
Ping.cs
Źródło:
Ping.cs
Źródło:
Ping.cs

Wyślij komunikat echa protokołu ICMP (Internet Control Message Protocol) z określonym buforem danych do komputera, który ma określony IPAddresselement , i odbiera odpowiedni komunikat odpowiedzi echa ICMP z tego komputera jako operację asynchroniczną. To przeciążenie umożliwia określenie wartości limitu czasu dla operacji i buforu do użycia na potrzeby wysyłania i odbierania.

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)

Parametry

address
IPAddress

Adres IP identyfikujący komputer docelowy komunikatu echa ICMP.

timeout
Int32

Maksymalna liczba milisekund (po wysłaniu wiadomości e-mail) do oczekiwania na komunikat odpowiedzi echa ICMP.

buffer
Byte[]

Tablica zawierająca Byte dane do wysłania z komunikatem echa ICMP i zwrócona w komunikacie odpowiedzi echa ICMP. Tablica nie może zawierać więcej niż 65 500 bajtów.

Zwraca

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

address lub buffer ma wartość null.

Parametr timeout ma wartość niższą niż zero.

Wywołanie metody SendPingAsync jest w toku.

Podczas wysyłania lub odbierania komunikatów ICMP został zgłoszony wyjątek. Zobacz wyjątek wewnętrzny, aby uzyskać dokładny wyjątek, który został zgłoszony.

address nie jest prawidłowym adresem IP.

Ten obiekt został usunięty.

Rozmiar buffer przekracza 65 500 bajtów.

.NET 7 i nowsze wersje tylko w systemie Linux: proces jest nieuprzywilejowany i buffer nie jest pusty.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult>> po wysłaniu pakietu ICMP i odebraniu odpowiedzi.

Dotyczy

SendPingAsync(String, Int32, Byte[])

Źródło:
Ping.cs
Źródło:
Ping.cs
Źródło:
Ping.cs

Wysyła komunikat echa protokołu ICMP (Internet Control Message Protocol) z określonym buforem danych do określonego komputera i odbiera odpowiedni komunikat odpowiedzi echa ICMP z tego komputera jako operację asynchroniczną. To przeciążenie umożliwia określenie wartości limitu czasu dla operacji i buforu do użycia na potrzeby wysyłania i odbierania.

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)

Parametry

hostNameOrAddress
String

Komputer, który jest miejscem docelowym komunikatu echa ICMP. Wartość określona dla tego parametru może być nazwą hosta lub ciągiem reprezentującym adres IP.

timeout
Int32

Maksymalna liczba milisekund (po wysłaniu wiadomości e-mail) do oczekiwania na komunikat odpowiedzi echa ICMP.

buffer
Byte[]

Tablica zawierająca Byte dane do wysłania z komunikatem echa ICMP i zwrócona w komunikacie odpowiedzi echa ICMP. Tablica nie może zawierać więcej niż 65 500 bajtów.

Zwraca

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

hostNameOrAddress jest null ciągiem pustym ("").

-lub-

buffer to null.

Parametr timeout ma wartość niższą niż zero.

Wywołanie metody SendAsync jest w toku.

Podczas wysyłania lub odbierania komunikatów ICMP został zgłoszony wyjątek. Zobacz wyjątek wewnętrzny, aby uzyskać dokładny wyjątek, który został zgłoszony.

hostNameOrAddress Nie można rozpoznać prawidłowego adresu IP.

Ten obiekt został usunięty.

Rozmiar buffer przekracza 65500 bajtów.

.NET 7 i nowsze wersje tylko w systemie Linux: proces jest nieuprzywilejowany i buffer nie jest pusty.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult>> po wysłaniu pakietu ICMP i odebraniu odpowiedzi.

Dotyczy

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

Źródło:
Ping.cs
Źródło:
Ping.cs
Źródło:
Ping.cs

Wysyła komunikat echa protokołu ICMP (Internet Control Message Protocol) z określonym buforem danych do komputera, który ma określony IPAddresselement , i odbiera odpowiedni komunikat odpowiedzi echa ICMP z tego komputera jako operację asynchroniczną. To przeciążenie umożliwia określenie wartości limitu czasu dla operacji, buforu do użycia na potrzeby wysyłania i odbierania oraz fragmentacji kontroli oraz wartości czasu wygaśnięcia dla pakietu komunikatów echa 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)

Parametry

address
IPAddress

Adres IP identyfikujący komputer docelowy komunikatu echa ICMP.

timeout
Int32

Maksymalna liczba milisekund (po wysłaniu wiadomości e-mail) do oczekiwania na komunikat odpowiedzi echa ICMP.

buffer
Byte[]

Tablica zawierająca Byte dane do wysłania z komunikatem echa ICMP i zwrócona w komunikacie odpowiedzi echa ICMP. Tablica nie może zawierać więcej niż 65 500 bajtów.

options
PingOptions

PingOptions Obiekt służący do kontrolowania fragmentacji i wartości time-to-Live dla pakietu komunikatów echa ICMP.

Zwraca

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

address lub buffer ma wartość null.

Parametr timeout ma wartość niższą niż zero.

Wywołanie metody SendPingAsync jest w toku.

Podczas wysyłania lub odbierania komunikatów ICMP został zgłoszony wyjątek. Zobacz wyjątek wewnętrzny, aby uzyskać dokładny wyjątek, który został zgłoszony.

address nie jest prawidłowym adresem IP.

Ten obiekt został usunięty.

Rozmiar buffer przekracza 65 500 bajtów.

.NET 7 i nowsze wersje tylko w systemie Linux: proces jest nieuprzywilejowany i buffer nie jest pusty.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult>> po wysłaniu pakietu ICMP i odebraniu odpowiedzi.

Dotyczy

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

Źródło:
Ping.cs
Źródło:
Ping.cs
Źródło:
Ping.cs

Wysyła komunikat echa protokołu ICMP (Internet Control Message Protocol) z określonym buforem danych do określonego komputera i odbiera odpowiedni komunikat odpowiedzi echa ICMP z tego komputera jako operację asynchroniczną. To przeciążenie umożliwia określenie wartości limitu czasu dla operacji, buforu do użycia na potrzeby wysyłania i odbierania oraz fragmentacji kontroli oraz wartości czasu wygaśnięcia dla pakietu komunikatów echa 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)

Parametry

hostNameOrAddress
String

Komputer, który jest miejscem docelowym komunikatu echa ICMP. Wartość określona dla tego parametru może być nazwą hosta lub ciągiem reprezentującym adres IP.

timeout
Int32

Maksymalna liczba milisekund (po wysłaniu wiadomości e-mail) do oczekiwania na komunikat odpowiedzi echa ICMP.

buffer
Byte[]

Tablica zawierająca Byte dane do wysłania z komunikatem echa ICMP i zwrócona w komunikacie odpowiedzi echa ICMP. Tablica nie może zawierać więcej niż 65 500 bajtów.

options
PingOptions

PingOptions Obiekt służący do kontrolowania fragmentacji i wartości time-to-Live dla pakietu komunikatów echa ICMP.

Zwraca

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

hostNameOrAddress jest null ciągiem pustym ("").

-lub-

buffer to null.

Parametr timeout ma wartość niższą niż zero.

Wywołanie metody SendAsync jest w toku.

Podczas wysyłania lub odbierania komunikatów ICMP został zgłoszony wyjątek. Zobacz wyjątek wewnętrzny, aby uzyskać dokładny wyjątek, który został zgłoszony.

hostNameOrAddress Nie można rozpoznać prawidłowego adresu IP.

Ten obiekt został usunięty.

Rozmiar buffer przekracza 65500 bajtów.

.NET 7 i nowsze wersje tylko w systemie Linux: proces jest nieuprzywilejowany i buffer nie jest pusty.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult>> po wysłaniu pakietu ICMP i odebraniu odpowiedzi.

Dotyczy

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

Źródło:
Ping.cs
Źródło:
Ping.cs

Wysyła komunikat echa protokołu ICMP (Internet Control Message Protocol) z określonym buforem danych do komputera, który ma określony IPAddresselement , i odbiera odpowiedni komunikat odpowiedzi echa ICMP z tego komputera jako operację asynchroniczną. To przeciążenie umożliwia określenie wartości limitu czasu dla operacji, buforu do użycia na potrzeby wysyłania i odbierania, fragmentacji sterowania i wartości czasu wygaśnięcia oraz CancellationToken pakietu komunikatów echa 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)

Parametry

address
IPAddress

Adres IP identyfikujący komputer docelowy komunikatu echa ICMP.

timeout
TimeSpan

Czas (po wysłaniu wiadomości e-mail) na oczekiwanie na komunikat odpowiedzi echa ICMP.

buffer
Byte[]

Tablica zawierająca Byte dane do wysłania z komunikatem echa ICMP i zwrócona w komunikacie odpowiedzi echa ICMP. Tablica nie może zawierać więcej niż 65 500 bajtów.

options
PingOptions

PingOptions Obiekt służący do kontrolowania fragmentacji i wartości time-to-Live dla pakietu komunikatów echa ICMP.

cancellationToken
CancellationToken

Token do monitorowania żądań anulowania. Wartość domyślna to None.

Zwraca

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Dotyczy