Share via


Ping.SendPingAsync Metode

Definisi

Mengirim pesan gema Internet Control Message Protocol (ICMP) ke komputer, dan menerima pesan balasan gema ICMP yang sesuai dari komputer tersebut sebagai operasi asinkron.

Overload

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

Mengirim pesan gema Internet Control Message Protocol (ICMP) dengan buffer data yang ditentukan ke komputer yang ditentukan, dan menerima pesan balasan gema ICMP yang sesuai dari komputer tersebut sebagai operasi asinkron. Kelebihan beban ini memungkinkan Anda menentukan nilai waktu habis untuk operasi, buffer yang digunakan untuk mengirim dan menerima, mengontrol fragmentasi dan nilai Time-to-Live, dan CancellationToken untuk paket pesan gema ICMP.

SendPingAsync(IPAddress)

Kirim pesan gema Protokol Pesan Kontrol Internet (ICMP) dengan buffer data yang ditentukan ke komputer yang memiliki IPAddress, dan menerima pesan balasan gema ICMP yang sesuai dari komputer tersebut sebagai operasi asinkron.

SendPingAsync(String)

Mengirim pesan gema Protokol Pesan Kontrol Internet (ICMP) dengan buffer data yang ditentukan ke komputer yang ditentukan, dan menerima pesan balasan gema ICMP yang sesuai dari komputer tersebut sebagai operasi asinkron.

SendPingAsync(IPAddress, Int32)

Kirim pesan gema Protokol Pesan Kontrol Internet (ICMP) dengan buffer data yang ditentukan ke komputer yang memiliki IPAddress, dan menerima pesan balasan gema ICMP yang sesuai dari komputer tersebut sebagai operasi asinkron. Kelebihan beban ini memungkinkan Anda menentukan nilai waktu habis untuk operasi.

SendPingAsync(String, Int32)

Mengirim pesan gema Protokol Pesan Kontrol Internet (ICMP) dengan buffer data yang ditentukan ke komputer yang ditentukan, dan menerima pesan balasan gema ICMP yang sesuai dari komputer tersebut sebagai operasi asinkron. Kelebihan beban ini memungkinkan Anda menentukan nilai waktu habis untuk operasi.

SendPingAsync(IPAddress, Int32, Byte[])

Kirim pesan gema Protokol Pesan Kontrol Internet (ICMP) dengan buffer data yang ditentukan ke komputer yang memiliki IPAddress, dan menerima pesan balasan gema ICMP yang sesuai dari komputer tersebut sebagai operasi asinkron. Kelebihan beban ini memungkinkan Anda menentukan nilai waktu habis untuk operasi dan buffer yang digunakan untuk mengirim dan menerima.

SendPingAsync(String, Int32, Byte[])

Mengirim pesan gema Protokol Pesan Kontrol Internet (ICMP) dengan buffer data yang ditentukan ke komputer yang ditentukan, dan menerima pesan balasan gema ICMP yang sesuai dari komputer tersebut sebagai operasi asinkron. Kelebihan beban ini memungkinkan Anda menentukan nilai waktu habis untuk operasi dan buffer yang digunakan untuk mengirim dan menerima.

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

Mengirim pesan gema Internet Control Message Protocol (ICMP) dengan buffer data yang ditentukan ke komputer yang memiliki IPAddress, dan menerima pesan balasan gema ICMP yang sesuai dari komputer tersebut sebagai operasi asinkron. Kelebihan beban ini memungkinkan Anda menentukan nilai waktu habis untuk operasi, buffer yang digunakan untuk mengirim dan menerima, serta mengontrol fragmentasi dan nilai Time-to-Live untuk paket pesan gema ICMP.

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

Mengirim pesan gema Protokol Pesan Kontrol Internet (ICMP) dengan buffer data yang ditentukan ke komputer yang ditentukan, dan menerima pesan balasan gema ICMP yang sesuai dari komputer tersebut sebagai operasi asinkron. Kelebihan beban ini memungkinkan Anda menentukan nilai waktu habis untuk operasi, buffer yang digunakan untuk mengirim dan menerima, serta mengontrol fragmentasi dan nilai Time-to-Live untuk paket pesan gema ICMP.

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

Mengirim pesan gema Internet Control Message Protocol (ICMP) dengan buffer data yang ditentukan ke komputer yang memiliki IPAddress, dan menerima pesan balasan gema ICMP yang sesuai dari komputer tersebut sebagai operasi asinkron. Kelebihan beban ini memungkinkan Anda menentukan nilai waktu habis untuk operasi, buffer yang digunakan untuk mengirim dan menerima, mengontrol fragmentasi dan nilai Time-to-Live, dan CancellationToken untuk paket pesan gema ICMP.

Keterangan

Alamat IP yang dikembalikan oleh salah SendPingAsync satu metode dapat berasal dari komputer jarak jauh yang berbahaya. Jangan sambungkan ke komputer jarak jauh dengan menggunakan ini. Gunakan DNS untuk menentukan alamat IP komputer yang ingin Anda sambungkan.

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

Sumber:
Ping.cs
Sumber:
Ping.cs

Mengirim pesan gema Internet Control Message Protocol (ICMP) dengan buffer data yang ditentukan ke komputer yang ditentukan, dan menerima pesan balasan gema ICMP yang sesuai dari komputer tersebut sebagai operasi asinkron. Kelebihan beban ini memungkinkan Anda menentukan nilai waktu habis untuk operasi, buffer yang digunakan untuk mengirim dan menerima, mengontrol fragmentasi dan nilai Time-to-Live, dan CancellationToken untuk paket pesan gema 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)

Parameter

hostNameOrAddress
String

Komputer yang merupakan tujuan untuk pesan gema ICMP. Nilai yang ditentukan untuk parameter ini dapat menjadi nama host atau representasi string dari alamat IP.

timeout
TimeSpan

Jumlah waktu (setelah mengirim pesan gema) untuk menunggu pesan balasan gema ICMP.

buffer
Byte[]

Array Byte yang berisi data yang akan dikirim dengan pesan gema ICMP dan dikembalikan dalam pesan balasan gema ICMP. Array tidak boleh berisi lebih dari 65.500 byte.

options
PingOptions

Objek yang PingOptions digunakan untuk mengontrol fragmentasi dan nilai Time-to-Live untuk paket pesan gema ICMP.

cancellationToken
CancellationToken

Token yang akan dipantau untuk permintaan pembatalan. Nilai defaultnya adalah None.

Mengembalikan

Objek tugas yang mewakili operasi asinkron.

Pengecualian

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Berlaku untuk

SendPingAsync(IPAddress)

Sumber:
Ping.cs
Sumber:
Ping.cs
Sumber:
Ping.cs

Kirim pesan gema Protokol Pesan Kontrol Internet (ICMP) dengan buffer data yang ditentukan ke komputer yang memiliki IPAddress, dan menerima pesan balasan gema ICMP yang sesuai dari komputer tersebut sebagai operasi asinkron.

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)

Parameter

address
IPAddress

Alamat IP yang mengidentifikasi komputer yang merupakan tujuan untuk pesan gema ICMP.

Mengembalikan

Objek tugas yang mewakili operasi asinkron.

Pengecualian

addressadalah null.

Panggilan ke SendPingAsync sedang berlangsung.

Pengecualian dilemparkan saat mengirim atau menerima pesan ICMP. Lihat pengecualian dalam untuk pengecualian yang tepat yang dilemparkan.

address bukan alamat IP yang valid.

Obyek ini telah dibuang.

Keterangan

Operasi ini tidak akan memblokir. Objek yang dikembalikan Task<TResult>> akan selesai setelah paket ICMP dikirim dan respons telah diterima.

Berlaku untuk

SendPingAsync(String)

Sumber:
Ping.cs
Sumber:
Ping.cs
Sumber:
Ping.cs

Mengirim pesan gema Protokol Pesan Kontrol Internet (ICMP) dengan buffer data yang ditentukan ke komputer yang ditentukan, dan menerima pesan balasan gema ICMP yang sesuai dari komputer tersebut sebagai operasi asinkron.

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)

Parameter

hostNameOrAddress
String

Komputer yang merupakan tujuan untuk pesan gema ICMP. Nilai yang ditentukan untuk parameter ini dapat menjadi nama host atau representasi string dari alamat IP.

Mengembalikan

Objek tugas yang mewakili operasi asinkron.

Pengecualian

hostNameOrAddress adalah null atau adalah string kosong ("").

Panggilan ke SendAsync(String, Object) metode sedang berlangsung.

Pengecualian dilemparkan saat mengirim atau menerima pesan ICMP. Lihat pengecualian dalam untuk pengecualian yang tepat yang dilemparkan.

hostNameOrAddress tidak dapat diselesaikan ke alamat IP yang valid.

Obyek ini telah dibuang.

Keterangan

Operasi ini tidak akan memblokir. Objek yang dikembalikan Task<TResult>> akan selesai setelah paket ICMP dikirim dan respons telah diterima.

Berlaku untuk

SendPingAsync(IPAddress, Int32)

Sumber:
Ping.cs
Sumber:
Ping.cs
Sumber:
Ping.cs

Kirim pesan gema Protokol Pesan Kontrol Internet (ICMP) dengan buffer data yang ditentukan ke komputer yang memiliki IPAddress, dan menerima pesan balasan gema ICMP yang sesuai dari komputer tersebut sebagai operasi asinkron. Kelebihan beban ini memungkinkan Anda menentukan nilai waktu habis untuk operasi.

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)

Parameter

address
IPAddress

Alamat IP yang mengidentifikasi komputer yang merupakan tujuan untuk pesan gema ICMP.

timeout
Int32

Jumlah maksimum milidetik (setelah mengirim pesan gema) untuk menunggu pesan balasan gema ICMP.

Mengembalikan

Objek tugas yang mewakili operasi asinkron.

Pengecualian

addressadalah null.

Panggilan ke SendAsync metode sedang berlangsung.

Pengecualian dilemparkan saat mengirim atau menerima pesan ICMP. Lihat pengecualian dalam untuk pengecualian yang tepat yang dilemparkan.

address bukan alamat IP yang valid.

Obyek ini telah dibuang.

Keterangan

Operasi ini tidak akan memblokir. Objek yang dikembalikan Task<TResult>> akan selesai setelah paket ICMP dikirim dan respons telah diterima.

Berlaku untuk

SendPingAsync(String, Int32)

Sumber:
Ping.cs
Sumber:
Ping.cs
Sumber:
Ping.cs

Mengirim pesan gema Internet Control Message Protocol (ICMP) dengan buffer data yang ditentukan ke komputer yang ditentukan, dan menerima pesan balasan gema ICMP yang sesuai dari komputer tersebut sebagai operasi asinkron. Kelebihan beban ini memungkinkan Anda menentukan nilai waktu habis untuk operasi.

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)

Parameter

hostNameOrAddress
String

Komputer yang merupakan tujuan untuk pesan gema ICMP. Nilai yang ditentukan untuk parameter ini dapat menjadi nama host atau representasi string dari alamat IP.

timeout
Int32

Jumlah maksimum milidetik (setelah mengirim pesan gema) untuk menunggu pesan balasan gema ICMP.

Mengembalikan

Objek tugas yang mewakili operasi asinkron.

Pengecualian

addressadalah null.

timeout kurang dari nol.

Panggilan ke SendAsync metode sedang berlangsung.

Pengecualian dilemparkan saat mengirim atau menerima pesan ICMP. Lihat pengecualian dalam untuk pengecualian yang tepat yang dilemparkan.

address bukan alamat IP yang valid.

Obyek ini telah dibuang.

Keterangan

Operasi ini tidak akan memblokir. Objek yang dikembalikan Task<TResult>> akan selesai setelah paket ICMP dikirim dan respons telah diterima.

Berlaku untuk

SendPingAsync(IPAddress, Int32, Byte[])

Sumber:
Ping.cs
Sumber:
Ping.cs
Sumber:
Ping.cs

Kirim pesan gema Protokol Pesan Kontrol Internet (ICMP) dengan buffer data yang ditentukan ke komputer yang memiliki IPAddress, dan menerima pesan balasan gema ICMP yang sesuai dari komputer tersebut sebagai operasi asinkron. Kelebihan beban ini memungkinkan Anda menentukan nilai waktu habis untuk operasi dan buffer yang digunakan untuk mengirim dan menerima.

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)

Parameter

address
IPAddress

Alamat IP yang mengidentifikasi komputer yang merupakan tujuan untuk pesan gema ICMP.

timeout
Int32

Jumlah maksimum milidetik (setelah mengirim pesan echo) untuk menunggu pesan balasan gema ICMP.

buffer
Byte[]

Array Byte yang berisi data yang akan dikirim dengan pesan gema ICMP dan dikembalikan dalam pesan balasan gema ICMP. Array tidak boleh berisi lebih dari 65.500 byte.

Mengembalikan

Objek tugas yang mewakili operasi asinkron.

Pengecualian

address atau buffer adalah null.

timeout kurang dari nol.

Panggilan ke SendPingAsync sedang berlangsung.

Pengecualian dilemparkan saat mengirim atau menerima pesan ICMP. Lihat pengecualian dalam untuk pengecualian yang tepat yang dilemparkan.

address bukan alamat IP yang valid.

Objek ini telah dibuang.

Ukuran buffer melebihi 65.500 byte.

.NET 7 dan versi yang lebih baru hanya di Linux: Prosesnya tidak istimewa, dan buffer tidak kosong.

Keterangan

Operasi ini tidak akan memblokir. Objek yang dikembalikan Task<TResult>> akan selesai setelah paket ICMP dikirim dan respons telah diterima.

Berlaku untuk

SendPingAsync(String, Int32, Byte[])

Sumber:
Ping.cs
Sumber:
Ping.cs
Sumber:
Ping.cs

Mengirim pesan gema Internet Control Message Protocol (ICMP) dengan buffer data yang ditentukan ke komputer yang ditentukan, dan menerima pesan balasan gema ICMP yang sesuai dari komputer tersebut sebagai operasi asinkron. Kelebihan beban ini memungkinkan Anda menentukan nilai waktu habis untuk operasi dan buffer yang digunakan untuk mengirim dan menerima.

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)

Parameter

hostNameOrAddress
String

Komputer yang merupakan tujuan untuk pesan gema ICMP. Nilai yang ditentukan untuk parameter ini dapat berupa nama host atau representasi string alamat IP.

timeout
Int32

Jumlah maksimum milidetik (setelah mengirim pesan echo) untuk menunggu pesan balasan gema ICMP.

buffer
Byte[]

Array Byte yang berisi data yang akan dikirim dengan pesan gema ICMP dan dikembalikan dalam pesan balasan gema ICMP. Array tidak boleh berisi lebih dari 65.500 byte.

Mengembalikan

Objek tugas yang mewakili operasi asinkron.

Pengecualian

hostNameOrAddress adalah null atau adalah string kosong ("").

-atau-

bufferadalah null.

timeout kurang dari nol.

Panggilan ke SendAsync sedang berlangsung.

Pengecualian dilemparkan saat mengirim atau menerima pesan ICMP. Lihat pengecualian dalam untuk pengecualian yang tepat yang dilemparkan.

hostNameOrAddress tidak dapat diatasi ke alamat IP yang valid.

Objek ini telah dibuang.

Ukuran buffer melebihi 65500 byte.

.NET 7 dan versi yang lebih baru hanya di Linux: Prosesnya tidak istimewa, dan buffer tidak kosong.

Keterangan

Operasi ini tidak akan memblokir. Objek yang dikembalikan Task<TResult>> akan selesai setelah paket ICMP dikirim dan respons telah diterima.

Berlaku untuk

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

Sumber:
Ping.cs
Sumber:
Ping.cs
Sumber:
Ping.cs

Mengirim pesan gema Internet Control Message Protocol (ICMP) dengan buffer data yang ditentukan ke komputer yang memiliki IPAddress, dan menerima pesan balasan gema ICMP yang sesuai dari komputer tersebut sebagai operasi asinkron. Kelebihan beban ini memungkinkan Anda menentukan nilai waktu habis untuk operasi, buffer yang digunakan untuk mengirim dan menerima, serta mengontrol fragmentasi dan nilai Time-to-Live untuk paket pesan gema 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)

Parameter

address
IPAddress

Alamat IP yang mengidentifikasi komputer yang merupakan tujuan untuk pesan gema ICMP.

timeout
Int32

Jumlah maksimum milidetik (setelah mengirim pesan echo) untuk menunggu pesan balasan gema ICMP.

buffer
Byte[]

Array Byte yang berisi data yang akan dikirim dengan pesan gema ICMP dan dikembalikan dalam pesan balasan gema ICMP. Array tidak boleh berisi lebih dari 65.500 byte.

options
PingOptions

Objek yang PingOptions digunakan untuk mengontrol nilai fragmentasi dan Time-to-Live untuk paket pesan gema ICMP.

Mengembalikan

Objek tugas yang mewakili operasi asinkron.

Pengecualian

address atau buffer adalah null.

timeout kurang dari nol.

Panggilan ke SendPingAsync sedang berlangsung.

Pengecualian dilemparkan saat mengirim atau menerima pesan ICMP. Lihat pengecualian dalam untuk pengecualian yang tepat yang dilemparkan.

address bukan alamat IP yang valid.

Objek ini telah dibuang.

Ukuran buffer melebihi 65.500 byte.

.NET 7 dan versi yang lebih baru hanya di Linux: Prosesnya tidak istimewa, dan buffer tidak kosong.

Keterangan

Operasi ini tidak akan memblokir. Objek yang dikembalikan Task<TResult>> akan selesai setelah paket ICMP dikirim dan respons telah diterima.

Berlaku untuk

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

Sumber:
Ping.cs
Sumber:
Ping.cs
Sumber:
Ping.cs

Mengirim pesan gema Internet Control Message Protocol (ICMP) dengan buffer data yang ditentukan ke komputer yang ditentukan, dan menerima pesan balasan gema ICMP yang sesuai dari komputer tersebut sebagai operasi asinkron. Kelebihan beban ini memungkinkan Anda menentukan nilai waktu habis untuk operasi, buffer yang digunakan untuk mengirim dan menerima, serta mengontrol fragmentasi dan nilai Time-to-Live untuk paket pesan gema 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)

Parameter

hostNameOrAddress
String

Komputer yang merupakan tujuan untuk pesan gema ICMP. Nilai yang ditentukan untuk parameter ini dapat berupa nama host atau representasi string alamat IP.

timeout
Int32

Jumlah maksimum milidetik (setelah mengirim pesan echo) untuk menunggu pesan balasan gema ICMP.

buffer
Byte[]

Array Byte yang berisi data yang akan dikirim dengan pesan gema ICMP dan dikembalikan dalam pesan balasan gema ICMP. Array tidak boleh berisi lebih dari 65.500 byte.

options
PingOptions

Objek yang PingOptions digunakan untuk mengontrol nilai fragmentasi dan Time-to-Live untuk paket pesan gema ICMP.

Mengembalikan

Objek tugas yang mewakili operasi asinkron.

Pengecualian

hostNameOrAddress adalah null atau adalah string kosong ("").

-atau-

bufferadalah null.

timeout kurang dari nol.

Panggilan ke SendAsync sedang berlangsung.

Pengecualian dilemparkan saat mengirim atau menerima pesan ICMP. Lihat pengecualian dalam untuk pengecualian yang tepat yang dilemparkan.

hostNameOrAddress tidak dapat diatasi ke alamat IP yang valid.

Objek ini telah dibuang.

Ukuran buffer melebihi 65500 byte.

.NET 7 dan versi yang lebih baru hanya di Linux: Prosesnya tidak istimewa, dan buffer tidak kosong.

Keterangan

Operasi ini tidak akan memblokir. Objek yang dikembalikan Task<TResult>> akan selesai setelah paket ICMP dikirim dan respons telah diterima.

Berlaku untuk

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

Sumber:
Ping.cs
Sumber:
Ping.cs

Mengirim pesan gema Internet Control Message Protocol (ICMP) dengan buffer data yang ditentukan ke komputer yang memiliki IPAddress, dan menerima pesan balasan gema ICMP yang sesuai dari komputer tersebut sebagai operasi asinkron. Kelebihan beban ini memungkinkan Anda menentukan nilai waktu habis untuk operasi, buffer yang digunakan untuk mengirim dan menerima, mengontrol fragmentasi dan nilai Time-to-Live, dan CancellationToken untuk paket pesan gema 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)

Parameter

address
IPAddress

Alamat IP yang mengidentifikasi komputer yang merupakan tujuan untuk pesan gema ICMP.

timeout
TimeSpan

Jumlah waktu (setelah mengirim pesan gema) untuk menunggu pesan balasan gema ICMP.

buffer
Byte[]

Array Byte yang berisi data yang akan dikirim dengan pesan gema ICMP dan dikembalikan dalam pesan balasan gema ICMP. Array tidak boleh berisi lebih dari 65.500 byte.

options
PingOptions

Objek yang PingOptions digunakan untuk mengontrol nilai fragmentasi dan Time-to-Live untuk paket pesan gema ICMP.

cancellationToken
CancellationToken

Token yang akan dipantau untuk permintaan pembatalan. Nilai defaultnya adalah None.

Mengembalikan

Objek tugas yang mewakili operasi asinkron.

Pengecualian

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Berlaku untuk