Ping.SendPingAsync Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Odešle do počítače zprávu o odezvě protokolu ICMP (Internet Control Message Protocol) a přijme odpovídající zprávu odezvy protokolu ICMP z tohoto počítače jako asynchronní operaci.
Přetížení
| SendPingAsync(String, TimeSpan, Byte[], PingOptions, CancellationToken) |
Odešle zprávu odezvy protokolu ICMP (Internet Control Message Protocol) se zadanou datovou vyrovnávací pamětí do zadaného počítače a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače jako asynchronní operaci. Toto přetížení umožňuje zadat hodnotu časového limitu pro operaci, vyrovnávací paměť, která se má použít pro odesílání a příjem, řízení fragmentace a hodnoty Time-to-Live a CancellationToken pro paket zpráv odezvy PROTOKOLU ICMP. |
| SendPingAsync(IPAddress) |
Odešle zprávu odezvy protokolu ICMP (Internet Control Message Protocol) se zadanou datovou vyrovnávací pamětí do počítače, který má zadanou IPAddresshodnotu , a přijme odpovídající zprávu odezvy ICMP z tohoto počítače jako asynchronní operaci. |
| SendPingAsync(String) |
Odešle zprávu odezvy protokolu ICMP (Internet Control Message Protocol) se zadanou datovou vyrovnávací pamětí do zadaného počítače a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače jako asynchronní operaci. |
| SendPingAsync(IPAddress, Int32) |
Odešle zprávu odezvy protokolu ICMP (Internet Control Message Protocol) se zadanou datovou vyrovnávací pamětí do počítače, který má zadanou IPAddresshodnotu , a přijme odpovídající zprávu odezvy ICMP z tohoto počítače jako asynchronní operaci. Toto přetížení umožňuje zadat hodnotu časového limitu pro operaci. |
| SendPingAsync(String, Int32) |
Odešle zprávu odezvy protokolu ICMP (Internet Control Message Protocol) se zadanou datovou vyrovnávací pamětí do zadaného počítače a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače jako asynchronní operaci. Toto přetížení umožňuje zadat hodnotu časového limitu pro operaci. |
| SendPingAsync(IPAddress, Int32, Byte[]) |
Odešle zprávu odezvy protokolu ICMP (Internet Control Message Protocol) se zadanou datovou vyrovnávací pamětí do počítače, který má zadanou IPAddresshodnotu , a přijme odpovídající zprávu odezvy ICMP z tohoto počítače jako asynchronní operaci. Toto přetížení umožňuje zadat hodnotu časového limitu pro operaci a vyrovnávací paměť, která se má použít pro odesílání a přijímání. |
| SendPingAsync(String, Int32, Byte[]) |
Odešle zprávu odezvy protokolu ICMP (Internet Control Message Protocol) se zadanou datovou vyrovnávací pamětí do zadaného počítače a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače jako asynchronní operaci. Toto přetížení umožňuje zadat hodnotu časového limitu pro operaci a vyrovnávací paměť, která se má použít pro odesílání a přijímání. |
| SendPingAsync(IPAddress, Int32, Byte[], PingOptions) |
Odešle zprávu odezvy protokolu ICMP (Internet Control Message Protocol) se zadanou datovou vyrovnávací pamětí do počítače, který má zadanou IPAddresshodnotu , a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače jako asynchronní operaci. Toto přetížení umožňuje zadat hodnotu časového limitu pro operaci, vyrovnávací paměť, která se má použít pro odesílání a příjem, a řízení fragmentace a hodnoty Time-to-Live pro paket zpráv odezvy ICMP. |
| SendPingAsync(String, Int32, Byte[], PingOptions) |
Odešle zprávu odezvy protokolu ICMP (Internet Control Message Protocol) se zadanou datovou vyrovnávací pamětí do zadaného počítače a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače jako asynchronní operaci. Toto přetížení umožňuje zadat hodnotu časového limitu pro operaci, vyrovnávací paměť, která se má použít pro odesílání a příjem, a řízení fragmentace a hodnoty Time-to-Live pro paket zpráv odezvy ICMP. |
| SendPingAsync(IPAddress, TimeSpan, Byte[], PingOptions, CancellationToken) |
Odešle zprávu odezvy protokolu ICMP (Internet Control Message Protocol) se zadanou datovou vyrovnávací pamětí do počítače, který má zadanou IPAddresshodnotu , a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače jako asynchronní operaci. Toto přetížení umožňuje zadat hodnotu časového limitu pro operaci, vyrovnávací paměť, která se má použít pro odesílání a příjem, řízení fragmentace a hodnoty Time-to-Live a CancellationToken pro paket zpráv odezvy PROTOKOLU ICMP. |
Poznámky
IP adresa vrácená některou z SendPingAsync metod může pocházet ze škodlivého vzdáleného počítače. Pomocí tohoto příkazu se nepřipojíte ke vzdálenému počítači. Pomocí DNS určete IP adresu počítače, ke kterému se chcete připojit.
SendPingAsync(String, TimeSpan, Byte[], PingOptions, CancellationToken)
- Zdroj:
- Ping.cs
- Zdroj:
- Ping.cs
Odešle zprávu odezvy protokolu ICMP (Internet Control Message Protocol) se zadanou datovou vyrovnávací pamětí do zadaného počítače a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače jako asynchronní operaci. Toto přetížení umožňuje zadat hodnotu časového limitu pro operaci, vyrovnávací paměť, která se má použít pro odesílání a příjem, řízení fragmentace a hodnoty Time-to-Live a CancellationToken pro paket zpráv odezvy PROTOKOLU 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
Počítač, který je cílem zprávy odezvy PROTOKOLU ICMP. Hodnota zadaná pro tento parametr může být název hostitele nebo řetězcová reprezentace IP adresy.
- timeout
- TimeSpan
Doba čekání (po odeslání zprávy o odezvě) na odpověď icmp.
- buffer
- Byte[]
Pole Byte obsahující data, která mají být odeslána se zprávou odezvy PROTOKOLU ICMP a vrácena ve zprávě odezvy ICMP. Pole nesmí obsahovat více než 65 500 bajtů.
- options
- PingOptions
Objekt PingOptions sloužící k řízení fragmentace a hodnoty Time-to-Live paketu odezvy ICMP.
- cancellationToken
- CancellationToken
Token, který se má monitorovat pro žádosti o zrušení. Výchozí hodnota je None.
Návraty
Objekt úlohy představující asynchronní operaci.
Výjimky
Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.
Platí pro
SendPingAsync(IPAddress)
- Zdroj:
- Ping.cs
- Zdroj:
- Ping.cs
- Zdroj:
- Ping.cs
Odešle zprávu odezvy protokolu ICMP (Internet Control Message Protocol) se zadanou datovou vyrovnávací pamětí do počítače, který má zadanou IPAddresshodnotu , a přijme odpovídající zprávu odezvy ICMP z tohoto počítače jako asynchronní operaci.
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
IP adresa, která identifikuje počítač, který je cílem pro zprávu odezvy PROTOKOLU ICMP.
Návraty
Objekt úlohy představující asynchronní operaci.
Výjimky
address je null.
Probíhá volání do SendPingAsync .
Při odesílání nebo přijímání zpráv PROTOKOLU ICMP došlo k výjimce. Projděte si vnitřní výjimku pro konkrétní výjimku, která byla vyvolán.
address není platná IP adresa.
Tento objekt byl odstraněn.
Poznámky
Tato operace nebude blokována. Task<TResult> > Vrácený objekt se dokončí po odeslání paketu ICMP a přijetí odpovědi.
Platí pro
SendPingAsync(String)
- Zdroj:
- Ping.cs
- Zdroj:
- Ping.cs
- Zdroj:
- Ping.cs
Odešle zprávu odezvy protokolu ICMP (Internet Control Message Protocol) se zadanou datovou vyrovnávací pamětí do zadaného počítače a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače jako asynchronní operaci.
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
Počítač, který je cílem zprávy odezvy PROTOKOLU ICMP. Hodnota zadaná pro tento parametr může být název hostitele nebo řetězcová reprezentace IP adresy.
Návraty
Objekt úlohy představující asynchronní operaci.
Výjimky
hostNameOrAddress je null nebo je prázdný řetězec ("").
Probíhá volání SendAsync(String, Object) metody.
Při odesílání nebo přijímání zpráv PROTOKOLU ICMP došlo k výjimce. Projděte si vnitřní výjimku pro konkrétní výjimku, která byla vyvolán.
hostNameOrAddress nelze přeložit na platnou IP adresu.
Tento objekt byl odstraněn.
Poznámky
Tato operace nebude blokována. Task<TResult> > Vrácený objekt se dokončí po odeslání paketu ICMP a přijetí odpovědi.
Platí pro
SendPingAsync(IPAddress, Int32)
- Zdroj:
- Ping.cs
- Zdroj:
- Ping.cs
- Zdroj:
- Ping.cs
Odešle zprávu odezvy protokolu ICMP (Internet Control Message Protocol) se zadanou datovou vyrovnávací pamětí do počítače, který má zadanou IPAddresshodnotu , a přijme odpovídající zprávu odezvy ICMP z tohoto počítače jako asynchronní operaci. Toto přetížení umožňuje zadat hodnotu časového limitu pro operaci.
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
IP adresa, která identifikuje počítač, který je cílem pro zprávu odezvy PROTOKOLU ICMP.
- timeout
- Int32
Maximální počet milisekund (po odeslání zprávy o odezvě) pro čekání na odpověď odezvy ICMP.
Návraty
Objekt úlohy představující asynchronní operaci.
Výjimky
address je null.
Probíhá volání SendAsync metody.
Při odesílání nebo přijímání zpráv PROTOKOLU ICMP došlo k výjimce. Projděte si vnitřní výjimku pro konkrétní výjimku, která byla vyvolán.
address není platná IP adresa.
Tento objekt byl odstraněn.
Poznámky
Tato operace nebude blokována. Task<TResult> > Vrácený objekt se dokončí po odeslání paketu ICMP a přijetí odpovědi.
Platí pro
SendPingAsync(String, Int32)
- Zdroj:
- Ping.cs
- Zdroj:
- Ping.cs
- Zdroj:
- Ping.cs
Odešle zprávu odezvy protokolu ICMP (Internet Control Message Protocol) se zadanou datovou vyrovnávací pamětí do zadaného počítače a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače jako asynchronní operaci. Toto přetížení umožňuje zadat hodnotu časového limitu pro operaci.
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
Počítač, který je cílem zprávy odezvy PROTOKOLU ICMP. Hodnota zadaná pro tento parametr může být název hostitele nebo řetězcová reprezentace IP adresy.
- timeout
- Int32
Maximální počet milisekund (po odeslání zprávy o odezvě) pro čekání na odpověď odezvy ICMP.
Návraty
Objekt úlohy představující asynchronní operaci.
Výjimky
address je null.
Hodnota timeout je menší než nula.
Probíhá volání SendAsync metody.
Při odesílání nebo přijímání zpráv PROTOKOLU ICMP došlo k výjimce. Projděte si vnitřní výjimku pro konkrétní výjimku, která byla vyvolán.
address není platná IP adresa.
Tento objekt byl odstraněn.
Poznámky
Tato operace nebude blokována. Task<TResult> > Vrácený objekt se dokončí po odeslání paketu ICMP a přijetí odpovědi.
Platí pro
SendPingAsync(IPAddress, Int32, Byte[])
- Zdroj:
- Ping.cs
- Zdroj:
- Ping.cs
- Zdroj:
- Ping.cs
Odešle zprávu odezvy protokolu ICMP (Internet Control Message Protocol) se zadanou datovou vyrovnávací pamětí do počítače, který má zadanou IPAddresshodnotu , a přijme odpovídající zprávu odezvy ICMP z tohoto počítače jako asynchronní operaci. Toto přetížení umožňuje zadat hodnotu časového limitu pro operaci a vyrovnávací paměť, která se má použít pro odesílání a přijímání.
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
IP adresa, která identifikuje počítač, který je cílem pro zprávu odezvy PROTOKOLU ICMP.
- timeout
- Int32
Maximální počet milisekund (po odeslání zprávy o odezvě) pro čekání na odpověď odezvy ICMP.
- buffer
- Byte[]
Pole Byte obsahující data, která mají být odeslána se zprávou odezvy PROTOKOLU ICMP a vrácena ve zprávě odezvy ICMP. Pole nesmí obsahovat více než 65 500 bajtů.
Návraty
Objekt úlohy představující asynchronní operaci.
Výjimky
address nebo buffer je null.
Hodnota timeout je menší než nula.
Probíhá volání do SendPingAsync .
Při odesílání nebo přijímání zpráv PROTOKOLU ICMP došlo k výjimce. Projděte si vnitřní výjimku pro konkrétní výjimku, která byla vyvolán.
address není platná IP adresa.
Tento objekt byl odstraněn.
Velikost buffer překračuje 65 500 bajtů.
.NET 7 a novější verze pouze v Linuxu: Proces není privilegovaný a buffer není prázdný.
Poznámky
Tato operace nebude blokována. Task<TResult> > Vrácený objekt se dokončí po odeslání paketu ICMP a přijetí odpovědi.
Platí pro
SendPingAsync(String, Int32, Byte[])
- Zdroj:
- Ping.cs
- Zdroj:
- Ping.cs
- Zdroj:
- Ping.cs
Odešle zprávu odezvy protokolu ICMP (Internet Control Message Protocol) se zadanou datovou vyrovnávací pamětí do zadaného počítače a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače jako asynchronní operaci. Toto přetížení umožňuje zadat hodnotu časového limitu pro operaci a vyrovnávací paměť, která se má použít pro odesílání a přijímání.
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
Počítač, který je cílem zprávy odezvy PROTOKOLU ICMP. Hodnota zadaná pro tento parametr může být název hostitele nebo řetězcová reprezentace IP adresy.
- timeout
- Int32
Maximální počet milisekund (po odeslání zprávy o odezvě) pro čekání na odpověď odezvy ICMP.
- buffer
- Byte[]
Pole Byte obsahující data, která mají být odeslána se zprávou odezvy PROTOKOLU ICMP a vrácena ve zprávě odezvy ICMP. Pole nesmí obsahovat více než 65 500 bajtů.
Návraty
Objekt úlohy představující asynchronní operaci.
Výjimky
hostNameOrAddress je null nebo je prázdný řetězec ("").
-nebo-
buffer je null.
Hodnota timeout je menší než nula.
Probíhá volání do SendAsync .
Při odesílání nebo přijímání zpráv PROTOKOLU ICMP došlo k výjimce. Projděte si vnitřní výjimku pro konkrétní výjimku, která byla vyvolán.
hostNameOrAddress nelze přeložit na platnou IP adresu.
Tento objekt byl odstraněn.
Velikost buffer překračuje 65500 bajtů.
.NET 7 a novější verze pouze v Linuxu: Proces není privilegovaný a buffer není prázdný.
Poznámky
Tato operace nebude blokována. Task<TResult> > Vrácený objekt se dokončí po odeslání paketu ICMP a přijetí odpovědi.
Platí pro
SendPingAsync(IPAddress, Int32, Byte[], PingOptions)
- Zdroj:
- Ping.cs
- Zdroj:
- Ping.cs
- Zdroj:
- Ping.cs
Odešle zprávu odezvy protokolu ICMP (Internet Control Message Protocol) se zadanou datovou vyrovnávací pamětí do počítače, který má zadanou IPAddresshodnotu , a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače jako asynchronní operaci. Toto přetížení umožňuje zadat hodnotu časového limitu pro operaci, vyrovnávací paměť, která se má použít pro odesílání a příjem, a řízení fragmentace a hodnoty Time-to-Live pro paket zpráv odezvy 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
IP adresa, která identifikuje počítač, který je cílem pro zprávu odezvy PROTOKOLU ICMP.
- timeout
- Int32
Maximální počet milisekund (po odeslání zprávy o odezvě) pro čekání na odpověď odezvy ICMP.
- buffer
- Byte[]
Pole Byte obsahující data, která mají být odeslána se zprávou odezvy PROTOKOLU ICMP a vrácena ve zprávě odezvy ICMP. Pole nesmí obsahovat více než 65 500 bajtů.
- options
- PingOptions
Objekt PingOptions sloužící k řízení fragmentace a hodnoty Time-to-Live paketu odezvy ICMP.
Návraty
Objekt úlohy představující asynchronní operaci.
Výjimky
address nebo buffer je null.
Hodnota timeout je menší než nula.
Probíhá volání do SendPingAsync .
Při odesílání nebo přijímání zpráv PROTOKOLU ICMP došlo k výjimce. Projděte si vnitřní výjimku pro konkrétní výjimku, která byla vyvolán.
address není platná IP adresa.
Tento objekt byl odstraněn.
Velikost buffer překračuje 65 500 bajtů.
.NET 7 a novější verze pouze v Linuxu: Proces není privilegovaný a buffer není prázdný.
Poznámky
Tato operace nebude blokována. Task<TResult> > Vrácený objekt se dokončí po odeslání paketu ICMP a přijetí odpovědi.
Platí pro
SendPingAsync(String, Int32, Byte[], PingOptions)
- Zdroj:
- Ping.cs
- Zdroj:
- Ping.cs
- Zdroj:
- Ping.cs
Odešle zprávu odezvy protokolu ICMP (Internet Control Message Protocol) se zadanou datovou vyrovnávací pamětí do zadaného počítače a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače jako asynchronní operaci. Toto přetížení umožňuje zadat hodnotu časového limitu pro operaci, vyrovnávací paměť, která se má použít pro odesílání a příjem, a řízení fragmentace a hodnoty Time-to-Live pro paket zpráv odezvy 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
Počítač, který je cílem zprávy odezvy PROTOKOLU ICMP. Hodnota zadaná pro tento parametr může být název hostitele nebo řetězcová reprezentace IP adresy.
- timeout
- Int32
Maximální počet milisekund (po odeslání zprávy o odezvě) pro čekání na odpověď odezvy ICMP.
- buffer
- Byte[]
Pole Byte obsahující data, která mají být odeslána se zprávou odezvy PROTOKOLU ICMP a vrácena ve zprávě odezvy ICMP. Pole nesmí obsahovat více než 65 500 bajtů.
- options
- PingOptions
Objekt PingOptions sloužící k řízení fragmentace a hodnoty Time-to-Live paketu odezvy ICMP.
Návraty
Objekt úlohy představující asynchronní operaci.
Výjimky
hostNameOrAddress je null nebo je prázdný řetězec ("").
-nebo-
buffer je null.
Hodnota timeout je menší než nula.
Probíhá volání do SendAsync .
Při odesílání nebo přijímání zpráv PROTOKOLU ICMP došlo k výjimce. Projděte si vnitřní výjimku pro konkrétní výjimku, která byla vyvolán.
hostNameOrAddress nelze přeložit na platnou IP adresu.
Tento objekt byl odstraněn.
Velikost buffer překračuje 65500 bajtů.
.NET 7 a novější verze pouze v Linuxu: Proces není privilegovaný a buffer není prázdný.
Poznámky
Tato operace nebude blokována. Task<TResult> > Vrácený objekt se dokončí po odeslání paketu ICMP a přijetí odpovědi.
Platí pro
SendPingAsync(IPAddress, TimeSpan, Byte[], PingOptions, CancellationToken)
- Zdroj:
- Ping.cs
- Zdroj:
- Ping.cs
Odešle zprávu odezvy protokolu ICMP (Internet Control Message Protocol) se zadanou datovou vyrovnávací pamětí do počítače, který má zadanou IPAddresshodnotu , a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače jako asynchronní operaci. Toto přetížení umožňuje zadat hodnotu časového limitu pro operaci, vyrovnávací paměť, která se má použít pro odesílání a příjem, řízení fragmentace a hodnoty Time-to-Live a CancellationToken pro paket zpráv odezvy PROTOKOLU 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
IP adresa, která identifikuje počítač, který je cílem pro zprávu odezvy PROTOKOLU ICMP.
- timeout
- TimeSpan
Doba čekání (po odeslání zprávy o odezvě) na odpověď icmp.
- buffer
- Byte[]
Pole Byte obsahující data, která mají být odeslána se zprávou odezvy PROTOKOLU ICMP a vrácena ve zprávě odezvy ICMP. Pole nesmí obsahovat více než 65 500 bajtů.
- options
- PingOptions
Objekt PingOptions sloužící k řízení fragmentace a hodnoty Time-to-Live paketu odezvy ICMP.
- cancellationToken
- CancellationToken
Token, který se má monitorovat pro žádosti o zrušení. Výchozí hodnota je None.
Návraty
Objekt úlohy představující asynchronní operaci.
Výjimky
Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.
