Ping.SendPingAsync Metoda

Definicja

Przestrzeń nazw:: System.Net.NetworkInformation

Zestawy:: netstandard.dll, System.Net.Ping.dll

Zestaw:: System.Net.Ping.dll

Zestaw:: System.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

Przeciążenia

Nazwa	Opis
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 kontrolek i wartości time-to-Live oraz dla 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 do 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 do 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 używanego do wysyłania i odbierania oraz fragmentacji kontrolek oraz wartości time-to-Live 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 używanego do wysyłania i odbierania oraz fragmentacji kontrolek oraz wartości time-to-Live 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 kontrolek i wartości time-to-Live oraz dla 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

Ź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 kontrolek i wartości time-to-Live oraz dla 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 echo) oczekiwania na wiadomość e-mail protokołu ICMP.

buffer: Byte[]

Tablica zawierająca Byte dane do wysłania z komunikatem echo 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 komunikatu echa ICMP.

cancellationToken: CancellationToken

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

Zwraca

Task<PingReply>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

OperationCanceledException

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

Źródło:: Ping.cs

Źródło:: Ping.cs

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, który jest miejscem docelowym komunikatu echa ICMP.

Zwraca

Task<PingReply>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

ArgumentNullException

Parametr address ma wartość null.

InvalidOperationException

Trwa wywołanie metody SendPingAsync .

PingException

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

SocketException

address jest nieprawidłowym adresem IP.

ObjectDisposedException

Ten obiekt został usunięty.

Uwagi

Ta operacja nie zostanie zablokowana. 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

Źródło:: Ping.cs

Źródło:: Ping.cs

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

Task<PingReply>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

ArgumentNullException

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

InvalidOperationException

Trwa wywołanie SendAsync(String, Object) metody .

PingException

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

SocketException

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

ObjectDisposedException

Ten obiekt został usunięty.

Uwagi

Ta operacja nie zostanie zablokowana. 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

Ź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, który jest miejscem docelowym komunikatu echa ICMP.

timeout: Int32

Maksymalna liczba milisekund (po wysłaniu wiadomości echa) w celu oczekiwania na komunikat odpowiedzi echa ICMP.

Zwraca

Task<PingReply>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

ArgumentNullException

Parametr address ma wartość null.

InvalidOperationException

Trwa wywołanie SendAsync metody .

PingException

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

SocketException

address jest nieprawidłowym adresem IP.

ObjectDisposedException

Ten obiekt został usunięty.

Uwagi

Ta operacja nie zostanie zablokowana. 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

Źródło:: Ping.cs

Źródło:: Ping.cs

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 echa) w celu oczekiwania na komunikat odpowiedzi echa ICMP.

Zwraca

Task<PingReply>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

ArgumentNullException

Parametr hostNameOrAddress ma wartość null.

ArgumentOutOfRangeException

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

InvalidOperationException

Trwa wywołanie SendAsync metody .

PingException

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

SocketException

hostNameOrAddress jest nieprawidłowym adresem IP.

ObjectDisposedException

Ten obiekt został usunięty.

Uwagi

Ta operacja nie zostanie zablokowana. 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

Źródło:: Ping.cs

Źródło:: Ping.cs

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, który jest miejscem docelowym komunikatu echa ICMP.

timeout: Int32

Maksymalna liczba milisekund (po wysłaniu wiadomości echa) w celu oczekiwania na komunikat odpowiedzi echa ICMP.

buffer: Byte[]

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

Zwraca

Task<PingReply>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

ArgumentNullException

address lub buffer ma wartość null.

ArgumentOutOfRangeException

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

InvalidOperationException

Trwa wywołanie metody SendPingAsync .

PingException

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

SocketException

address jest nieprawidłowym adresem IP.

ObjectDisposedException

Ten obiekt został usunięty.

ArgumentException

Rozmiar buffer przekracza 65 500 bajtów.

PlatformNotSupportedException

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

Uwagi

Ta operacja nie zostanie zablokowana. 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

Źródło:: Ping.cs

Źródło:: Ping.cs

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 echa) w celu oczekiwania na komunikat odpowiedzi echa ICMP.

buffer: Byte[]

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

Zwraca

Task<PingReply>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

ArgumentNullException

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

— lub —

Parametr buffer ma wartość null.

ArgumentOutOfRangeException

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

InvalidOperationException

Trwa wywołanie metody SendAsync .

PingException

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

SocketException

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

ObjectDisposedException

Ten obiekt został usunięty.

ArgumentException

Rozmiar buffer przekracza 65500 bajtów.

PlatformNotSupportedException

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

Uwagi

Ta operacja nie zostanie zablokowana. 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

Ź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 używanego do wysyłania i odbierania oraz fragmentacji kontrolek oraz wartości time-to-Live 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, który jest miejscem docelowym komunikatu echa ICMP.

timeout: Int32

Maksymalna liczba milisekund (po wysłaniu wiadomości echa) w celu oczekiwania na komunikat odpowiedzi echa ICMP.

buffer: Byte[]

Tablica zawierająca Byte dane do wysłania z komunikatem echo 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 komunikatu echa ICMP.

Zwraca

Task<PingReply>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

ArgumentNullException

address lub buffer ma wartość null.

ArgumentOutOfRangeException

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

InvalidOperationException

Trwa wywołanie metody SendPingAsync .

PingException

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

SocketException

address jest nieprawidłowym adresem IP.

ObjectDisposedException

Ten obiekt został usunięty.

ArgumentException

Rozmiar buffer przekracza 65 500 bajtów.

PlatformNotSupportedException

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

Uwagi

Ta operacja nie zostanie zablokowana. 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

Ź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 używanego do wysyłania i odbierania oraz fragmentacji kontrolek oraz wartości time-to-Live 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 echa) w celu oczekiwania na komunikat odpowiedzi echa ICMP.

buffer: Byte[]

Tablica zawierająca Byte dane do wysłania z komunikatem echo 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 komunikatu echa ICMP.

Zwraca

Task<PingReply>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

ArgumentNullException

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

— lub —

Parametr buffer ma wartość null.

ArgumentOutOfRangeException

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

InvalidOperationException

Trwa wywołanie metody SendAsync .

PingException

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

SocketException

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

ObjectDisposedException

Ten obiekt został usunięty.

ArgumentException

Rozmiar buffer przekracza 65500 bajtów.

PlatformNotSupportedException

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

Uwagi

Ta operacja nie zostanie zablokowana. 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

Ź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 kontrolek i wartości time-to-Live oraz dla 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, który jest miejscem docelowym komunikatu echa ICMP.

timeout: TimeSpan

Czas (po wysłaniu wiadomości echo) oczekiwania na wiadomość e-mail protokołu ICMP.

buffer: Byte[]

Tablica zawierająca Byte dane do wysłania z komunikatem echo 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 komunikatu echa ICMP.

cancellationToken: CancellationToken

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

Zwraca

Task<PingReply>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

OperationCanceledException

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

Dotyczy

Opinia

Czy ta strona była pomocna?