Ping.SendPingAsync Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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.