Ping.SendPingAsync Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
address
adalah 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
address
adalah 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
address
adalah 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-
buffer
adalah 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-
buffer
adalah 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.