Ping.SendPingAsync Metoda
Definicja
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 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 zwrócony 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 usługi 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 echo 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 echo 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.
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 echo) do oczekiwania na komunikat odpowiedzi echa ICMP.
- buffer
- Byte[]
Tablica Byte zawierająca dane do wysłania za pomocą komunikatu 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
to null
.
Parametr timeout
ma wartość niższą niż zero.
Wywołanie metody jest SendPingAsync 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 echo 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.
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 echo) do oczekiwania na komunikat odpowiedzi echa ICMP.
- buffer
- Byte[]
Tablica Byte zawierająca dane do wysłania za pomocą komunikatu 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
Parametr timeout
ma wartość niższą niż zero.
Wywołanie metody jest SendAsync 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 echo 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 do wysyłania i odbierania oraz fragmentacji kontrolek i 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, który jest miejscem docelowym komunikatu echa ICMP.
- timeout
- Int32
Maksymalna liczba milisekund (po wysłaniu wiadomości echo) do oczekiwania na komunikat odpowiedzi echa ICMP.
- buffer
- Byte[]
Tablica Byte zawierająca dane do wysłania za pomocą komunikatu 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
to null
.
Parametr timeout
ma wartość niższą niż zero.
Wywołanie metody jest SendPingAsync 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 echo 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 do wysyłania i odbierania oraz fragmentacji kontrolek i 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 echo) do oczekiwania na komunikat odpowiedzi echa ICMP.
- buffer
- Byte[]
Tablica Byte zawierająca dane do wysłania za pomocą komunikatu 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
Parametr timeout
ma wartość niższą niż zero.
Wywołanie metody jest SendAsync 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 echo 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, który ma być używany do wysyłania i odbierania, fragmentacji kontroli 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, który jest miejscem docelowym komunikatu echa ICMP.
- timeout
- TimeSpan
Ilość czasu (po wysłaniu wiadomości echo) na oczekiwanie na wiadomość e-mail protokołu ICMP.
- buffer
- Byte[]
Tablica Byte zawierająca dane do wysłania za pomocą komunikatu 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 zwróconym zadaniu.