Ping.SendPingAsync Metod

Definition

Skickar ett ICMP-ekomeddelande (Internet Control Message Protocol) till en dator och tar emot ett motsvarande ICMP-ekosvarsmeddelande från datorn som en asynkron åtgärd.

Överlagringar

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

Skickar ett ICMP-ekomeddelande (Internet Control Message Protocol) med den angivna databufferten till den angivna datorn och tar emot ett motsvarande ICMP-ekosvarsmeddelande från datorn som en asynkron åtgärd. Med den här överlagringen kan du ange ett timeout-värde för åtgärden, en buffert som ska användas för att skicka och ta emot, kontrollera fragmentering och Time-to-Live-värden och ett CancellationToken för ICMP-ekomeddelandepaketet.

SendPingAsync(IPAddress)

Skicka ett ICMP-ekomeddelande (Internet Control Message Protocol) med den angivna databufferten till datorn som har angivet IPAddressoch tar emot ett motsvarande ICMP-ekosvarsmeddelande från datorn som en asynkron åtgärd.

SendPingAsync(String)

Skickar ett ICMP-ekomeddelande (Internet Control Message Protocol) med den angivna databufferten till den angivna datorn och får ett motsvarande ICMP-ekosvarsmeddelande från datorn som en asynkron åtgärd.

SendPingAsync(IPAddress, Int32)

Skicka ett ICMP-ekomeddelande (Internet Control Message Protocol) med den angivna databufferten till datorn som har angivet IPAddressoch tar emot ett motsvarande ICMP-ekosvarsmeddelande från datorn som en asynkron åtgärd. Med den här överlagringen kan du ange ett timeout-värde för åtgärden.

SendPingAsync(String, Int32)

Skickar ett ICMP-ekomeddelande (Internet Control Message Protocol) med den angivna databufferten till den angivna datorn och får ett motsvarande ICMP-ekosvarsmeddelande från datorn som en asynkron åtgärd. Med den här överlagringen kan du ange ett timeout-värde för åtgärden.

SendPingAsync(IPAddress, Int32, Byte[])

Skicka ett ICMP-ekomeddelande (Internet Control Message Protocol) med den angivna databufferten till datorn som har angivet IPAddressoch tar emot ett motsvarande ICMP-ekosvarsmeddelande från datorn som en asynkron åtgärd. Med den här överlagringen kan du ange ett timeout-värde för åtgärden och en buffert som ska användas för att skicka och ta emot.

SendPingAsync(String, Int32, Byte[])

Skickar ett ICMP-ekomeddelande (Internet Control Message Protocol) med den angivna databufferten till den angivna datorn och får ett motsvarande ICMP-ekosvarsmeddelande från datorn som en asynkron åtgärd. Med den här överlagringen kan du ange ett timeout-värde för åtgärden och en buffert som ska användas för att skicka och ta emot.

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

Skickar ett ICMP-ekomeddelande (Internet Control Message Protocol) med den angivna databufferten till datorn som har angivet IPAddressoch tar emot ett motsvarande ICMP-ekosvarsmeddelande från datorn som en asynkron åtgärd. Med den här överlagringen kan du ange ett timeout-värde för åtgärden, en buffert som ska användas för att skicka och ta emot samt styra fragmentering och Time-to-Live-värden för ICMP-ekomeddelandepaketet.

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

Skickar ett ICMP-ekomeddelande (Internet Control Message Protocol) med den angivna databufferten till den angivna datorn och får ett motsvarande ICMP-ekosvarsmeddelande från datorn som en asynkron åtgärd. Med den här överlagringen kan du ange ett timeout-värde för åtgärden, en buffert som ska användas för att skicka och ta emot samt styra fragmentering och Time-to-Live-värden för ICMP-ekomeddelandepaketet.

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

Skickar ett ICMP-ekomeddelande (Internet Control Message Protocol) med den angivna databufferten till datorn som har angivet IPAddressoch tar emot ett motsvarande ICMP-ekosvarsmeddelande från datorn som en asynkron åtgärd. Med den här överlagringen kan du ange ett timeout-värde för åtgärden, en buffert som ska användas för att skicka och ta emot, kontrollera fragmentering och Time-to-Live-värden och ett CancellationToken för ICMP-ekomeddelandepaketet.

Kommentarer

IP-adressen som returneras av någon av SendPingAsync metoderna kan komma från en skadlig fjärrdator. Anslut inte till fjärrdatorn med hjälp av detta. Använd DNS för att fastställa IP-adressen för den dator som du vill ansluta till.

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

Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs

Skickar ett ICMP-ekomeddelande (Internet Control Message Protocol) med den angivna databufferten till den angivna datorn och tar emot ett motsvarande ICMP-ekosvarsmeddelande från datorn som en asynkron åtgärd. Med den här överlagringen kan du ange ett timeout-värde för åtgärden, en buffert som ska användas för att skicka och ta emot, kontrollera fragmentering och Time-to-Live-värden och ett CancellationToken för ICMP-ekomeddelandepaketet.

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)

Parametrar

hostNameOrAddress
String

Den dator som är målet för ICMP-ekomeddelandet. Värdet som anges för den här parametern kan vara ett värdnamn eller en strängrepresentation av en IP-adress.

timeout
TimeSpan

Hur lång tid (efter att ekomeddelandet har skickats) att vänta på ICMP-ekosvarsmeddelandet.

buffer
Byte[]

En Byte matris som innehåller data som ska skickas med ICMP-ekomeddelandet och som returneras i ICMP-ekosvarsmeddelandet. Matrisen får inte innehålla mer än 65 500 byte.

options
PingOptions

Ett PingOptions objekt som används för att kontrollera fragmentering och Time-to-Live-värden för ICMP-ekomeddelandepaketet.

cancellationToken
CancellationToken

Token som ska övervakas för annulleringsbegäranden. Standardvärdet är None.

Returer

Aktivitetsobjektet som representerar den asynkrona åtgärden.

Undantag

Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.

Gäller för

SendPingAsync(IPAddress)

Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs

Skicka ett ICMP-ekomeddelande (Internet Control Message Protocol) med den angivna databufferten till datorn som har angivet IPAddressoch tar emot ett motsvarande ICMP-ekosvarsmeddelande från datorn som en asynkron åtgärd.

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)

Parametrar

address
IPAddress

En IP-adress som identifierar den dator som är målet för ICMP-ekomeddelandet.

Returer

Aktivitetsobjektet som representerar den asynkrona åtgärden.

Undantag

address är null.

Ett anrop till SendPingAsync pågår.

Ett undantag utlöstes när ICMP-meddelandena skickades eller togs emot. Se det inre undantaget för det exakta undantaget som utlöstes.

address är inte en giltig IP-adress.

Det här objektet har tagits bort.

Kommentarer

Den här åtgärden kommer inte att blockeras. Det returnerade objektet slutförs Task<TResult>> när ICMP-paketet har skickats och svaret har tagits emot.

Gäller för

SendPingAsync(String)

Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs

Skickar ett ICMP-ekomeddelande (Internet Control Message Protocol) med den angivna databufferten till den angivna datorn och får ett motsvarande ICMP-ekosvarsmeddelande från datorn som en asynkron åtgärd.

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)

Parametrar

hostNameOrAddress
String

Den dator som är målet för ICMP-ekomeddelandet. Värdet som anges för den här parametern kan vara ett värdnamn eller en strängrepresentation av en IP-adress.

Returer

Aktivitetsobjektet som representerar den asynkrona åtgärden.

Undantag

hostNameOrAddress är null eller är en tom sträng ("").

Ett anrop till SendAsync(String, Object) metoden pågår.

Ett undantag utlöstes när ICMP-meddelandena skickades eller togs emot. Se det inre undantaget för det exakta undantaget som utlöstes.

hostNameOrAddress kunde inte matchas till en giltig IP-adress.

Det här objektet har tagits bort.

Kommentarer

Den här åtgärden kommer inte att blockeras. Det returnerade objektet slutförs Task<TResult>> när ICMP-paketet har skickats och svaret har tagits emot.

Gäller för

SendPingAsync(IPAddress, Int32)

Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs

Skicka ett ICMP-ekomeddelande (Internet Control Message Protocol) med den angivna databufferten till datorn som har angivet IPAddressoch tar emot ett motsvarande ICMP-ekosvarsmeddelande från datorn som en asynkron åtgärd. Med den här överlagringen kan du ange ett timeout-värde för åtgärden.

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)

Parametrar

address
IPAddress

En IP-adress som identifierar den dator som är målet för ICMP-ekomeddelandet.

timeout
Int32

Det maximala antalet millisekunder (efter att ekomeddelandet har skickats) för att vänta på ICMP-ekosvarsmeddelandet.

Returer

Aktivitetsobjektet som representerar den asynkrona åtgärden.

Undantag

address är null.

Ett anrop till SendAsync metoden pågår.

Ett undantag utlöstes när ICMP-meddelandena skickades eller togs emot. Se det inre undantaget för det exakta undantaget som utlöstes.

address är inte en giltig IP-adress.

Det här objektet har tagits bort.

Kommentarer

Den här åtgärden kommer inte att blockeras. Det returnerade objektet slutförs Task<TResult>> när ICMP-paketet har skickats och svaret har tagits emot.

Gäller för

SendPingAsync(String, Int32)

Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs

Skickar ett ICMP-ekomeddelande (Internet Control Message Protocol) med den angivna databufferten till den angivna datorn och får ett motsvarande ICMP-ekosvarsmeddelande från datorn som en asynkron åtgärd. Med den här överlagringen kan du ange ett timeout-värde för åtgärden.

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)

Parametrar

hostNameOrAddress
String

Den dator som är målet för ICMP-ekomeddelandet. Värdet som anges för den här parametern kan vara ett värdnamn eller en strängrepresentation av en IP-adress.

timeout
Int32

Det maximala antalet millisekunder (efter att ekomeddelandet har skickats) för att vänta på ICMP-ekosvarsmeddelandet.

Returer

Aktivitetsobjektet som representerar den asynkrona åtgärden.

Undantag

hostNameOrAddress är null.

timeout är mindre än noll.

Ett anrop till SendAsync metoden pågår.

Ett undantag utlöstes när ICMP-meddelandena skickades eller togs emot. Se det inre undantaget för det exakta undantaget som utlöstes.

hostNameOrAddress är inte en giltig IP-adress.

Det här objektet har tagits bort.

Kommentarer

Den här åtgärden kommer inte att blockeras. Det returnerade objektet slutförs Task<TResult>> när ICMP-paketet har skickats och svaret har tagits emot.

Gäller för

SendPingAsync(IPAddress, Int32, Byte[])

Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs

Skicka ett ICMP-ekomeddelande (Internet Control Message Protocol) med den angivna databufferten till datorn som har angivet IPAddressoch tar emot ett motsvarande ICMP-ekosvarsmeddelande från datorn som en asynkron åtgärd. Med den här överlagringen kan du ange ett timeout-värde för åtgärden och en buffert som ska användas för att skicka och ta emot.

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)

Parametrar

address
IPAddress

En IP-adress som identifierar den dator som är målet för ICMP-ekomeddelandet.

timeout
Int32

Det maximala antalet millisekunder (efter att ekomeddelandet har skickats) för att vänta på ICMP-ekosvarsmeddelandet.

buffer
Byte[]

En Byte matris som innehåller data som ska skickas med ICMP-ekomeddelandet och som returneras i ICMP-ekosvarsmeddelandet. Matrisen får inte innehålla mer än 65 500 byte.

Returer

Aktivitetsobjektet som representerar den asynkrona åtgärden.

Undantag

address eller buffer är null.

timeout är mindre än noll.

Ett anrop till SendPingAsync pågår.

Ett undantag utlöstes när ICMP-meddelandena skickades eller togs emot. Se det inre undantaget för det exakta undantaget som utlöstes.

address är inte en giltig IP-adress.

Det här objektet har tagits bort.

Storleken på buffer överstiger 65 500 byte.

.NET 7 och senare versioner endast i Linux: Processen är inte privilegierad och buffer är inte tom.

Kommentarer

Den här åtgärden kommer inte att blockeras. Det returnerade objektet slutförs Task<TResult>> när ICMP-paketet har skickats och svaret har tagits emot.

Gäller för

SendPingAsync(String, Int32, Byte[])

Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs

Skickar ett ICMP-ekomeddelande (Internet Control Message Protocol) med den angivna databufferten till den angivna datorn och får ett motsvarande ICMP-ekosvarsmeddelande från datorn som en asynkron åtgärd. Med den här överlagringen kan du ange ett timeout-värde för åtgärden och en buffert som ska användas för att skicka och ta emot.

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)

Parametrar

hostNameOrAddress
String

Den dator som är målet för ICMP-ekomeddelandet. Värdet som anges för den här parametern kan vara ett värdnamn eller en strängrepresentation av en IP-adress.

timeout
Int32

Det maximala antalet millisekunder (efter att ekomeddelandet har skickats) för att vänta på ICMP-ekosvarsmeddelandet.

buffer
Byte[]

En Byte matris som innehåller data som ska skickas med ICMP-ekomeddelandet och som returneras i ICMP-ekosvarsmeddelandet. Matrisen får inte innehålla mer än 65 500 byte.

Returer

Aktivitetsobjektet som representerar den asynkrona åtgärden.

Undantag

hostNameOrAddress är null eller är en tom sträng ("").

-eller-

buffer är null.

timeout är mindre än noll.

Ett anrop till SendAsync pågår.

Ett undantag utlöstes när ICMP-meddelandena skickades eller togs emot. Se det inre undantaget för det exakta undantaget som utlöstes.

hostNameOrAddress kunde inte matchas till en giltig IP-adress.

Det här objektet har tagits bort.

Storleken på buffer överskrider 65500 byte.

.NET 7 och senare versioner endast i Linux: Processen är inte privilegierad och buffer är inte tom.

Kommentarer

Den här åtgärden kommer inte att blockeras. Det returnerade objektet slutförs Task<TResult>> när ICMP-paketet har skickats och svaret har tagits emot.

Gäller för

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

Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs

Skickar ett ICMP-ekomeddelande (Internet Control Message Protocol) med den angivna databufferten till datorn som har angivet IPAddressoch tar emot ett motsvarande ICMP-ekosvarsmeddelande från datorn som en asynkron åtgärd. Med den här överlagringen kan du ange ett timeout-värde för åtgärden, en buffert som ska användas för att skicka och ta emot samt styra fragmentering och Time-to-Live-värden för ICMP-ekomeddelandepaketet.

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)

Parametrar

address
IPAddress

En IP-adress som identifierar den dator som är målet för ICMP-ekomeddelandet.

timeout
Int32

Det maximala antalet millisekunder (efter att ekomeddelandet har skickats) för att vänta på ICMP-ekosvarsmeddelandet.

buffer
Byte[]

En Byte matris som innehåller data som ska skickas med ICMP-ekomeddelandet och som returneras i ICMP-ekosvarsmeddelandet. Matrisen får inte innehålla mer än 65 500 byte.

options
PingOptions

Ett PingOptions objekt som används för att kontrollera fragmentering och Time-to-Live-värden för ICMP-ekomeddelandepaketet.

Returer

Aktivitetsobjektet som representerar den asynkrona åtgärden.

Undantag

address eller buffer är null.

timeout är mindre än noll.

Ett anrop till SendPingAsync pågår.

Ett undantag utlöstes när ICMP-meddelandena skickades eller togs emot. Se det inre undantaget för det exakta undantaget som utlöstes.

address är inte en giltig IP-adress.

Det här objektet har tagits bort.

Storleken på buffer överstiger 65 500 byte.

.NET 7 och senare versioner endast i Linux: Processen är inte privilegierad och buffer är inte tom.

Kommentarer

Den här åtgärden kommer inte att blockeras. Det returnerade objektet slutförs Task<TResult>> när ICMP-paketet har skickats och svaret har tagits emot.

Gäller för

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

Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs

Skickar ett ICMP-ekomeddelande (Internet Control Message Protocol) med den angivna databufferten till den angivna datorn och får ett motsvarande ICMP-ekosvarsmeddelande från datorn som en asynkron åtgärd. Med den här överlagringen kan du ange ett timeout-värde för åtgärden, en buffert som ska användas för att skicka och ta emot samt styra fragmentering och Time-to-Live-värden för ICMP-ekomeddelandepaketet.

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)

Parametrar

hostNameOrAddress
String

Den dator som är målet för ICMP-ekomeddelandet. Värdet som anges för den här parametern kan vara ett värdnamn eller en strängrepresentation av en IP-adress.

timeout
Int32

Det maximala antalet millisekunder (efter att ekomeddelandet har skickats) för att vänta på ICMP-ekosvarsmeddelandet.

buffer
Byte[]

En Byte matris som innehåller data som ska skickas med ICMP-ekomeddelandet och som returneras i ICMP-ekosvarsmeddelandet. Matrisen får inte innehålla mer än 65 500 byte.

options
PingOptions

Ett PingOptions objekt som används för att kontrollera fragmentering och Time-to-Live-värden för ICMP-ekomeddelandepaketet.

Returer

Aktivitetsobjektet som representerar den asynkrona åtgärden.

Undantag

hostNameOrAddress är null eller är en tom sträng ("").

-eller-

buffer är null.

timeout är mindre än noll.

Ett anrop till SendAsync pågår.

Ett undantag utlöstes när ICMP-meddelandena skickades eller togs emot. Se det inre undantaget för det exakta undantaget som utlöstes.

hostNameOrAddress kunde inte matchas till en giltig IP-adress.

Det här objektet har tagits bort.

Storleken på buffer överskrider 65500 byte.

.NET 7 och senare versioner endast i Linux: Processen är inte privilegierad och buffer är inte tom.

Kommentarer

Den här åtgärden kommer inte att blockeras. Det returnerade objektet slutförs Task<TResult>> när ICMP-paketet har skickats och svaret har tagits emot.

Gäller för

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

Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs
Källa:
Ping.cs

Skickar ett ICMP-ekomeddelande (Internet Control Message Protocol) med den angivna databufferten till datorn som har angivet IPAddressoch tar emot ett motsvarande ICMP-ekosvarsmeddelande från datorn som en asynkron åtgärd. Med den här överlagringen kan du ange ett timeout-värde för åtgärden, en buffert som ska användas för att skicka och ta emot, kontrollera fragmentering och Time-to-Live-värden och ett CancellationToken för ICMP-ekomeddelandepaketet.

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)

Parametrar

address
IPAddress

En IP-adress som identifierar den dator som är målet för ICMP-ekomeddelandet.

timeout
TimeSpan

Hur lång tid (efter att ekomeddelandet har skickats) att vänta på ICMP-ekosvarsmeddelandet.

buffer
Byte[]

En Byte matris som innehåller data som ska skickas med ICMP-ekomeddelandet och som returneras i ICMP-ekosvarsmeddelandet. Matrisen får inte innehålla mer än 65 500 byte.

options
PingOptions

Ett PingOptions objekt som används för att kontrollera fragmentering och Time-to-Live-värden för ICMP-ekomeddelandepaketet.

cancellationToken
CancellationToken

Token som ska övervakas för annulleringsbegäranden. Standardvärdet är None.

Returer

Aktivitetsobjektet som representerar den asynkrona åtgärden.

Undantag

Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.

Gäller för