Ping.SendPingAsync Method (String, Int32, Byte(), PingOptions)

.NET Framework (current version)

Sends an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the specified computer, and receive a corresponding ICMP echo reply message from that computer as an asynchronous operation. This overload allows you to specify a time-out value for the operation, a buffer to use for send and receive, and control fragmentation and Time-to-Live values for the ICMP echo message packet.

Namespace:   System.Net.NetworkInformation
Assembly:  System (in System.dll)

<HostProtectionAttribute(SecurityAction.LinkDemand, ExternalThreading := True)>
Public Function SendPingAsync (
	hostNameOrAddress As String,
	timeout As Integer,
	buffer As Byte(),
	options As PingOptions
) As Task(Of PingReply)


Type: System.String

The computer that is the destination for the ICMP echo message. The value specified for this parameter can be a host name or a string representation of an IP address.

Type: System.Int32

The maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message.

Type: System.Byte()

A Byte array that contains data to be sent with the ICMP echo message and returned in the ICMP echo reply message. The array cannot contain more than 65,500 bytes.

Type: System.Net.NetworkInformation.PingOptions

A PingOptions object used to control fragmentation and Time-to-Live values for the ICMP echo message packet.

Return Value

Type: System.Threading.Tasks.Task(Of PingReply)

Returns Task(Of TResult).

The task object representing the asynchronous operation.

This operation will not block. The returned Task(Of TResult)> object will complete after the ICMP packet has been sent and the response has been received.

.NET Framework
Available since 4.5
Return to top