System 2.0.0.0 4.0.0.0 System.ComponentModel.Component System.IDisposable System.MonoTODO("IPv6 support is missing")

Applications use the class to detect whether a remote computer is reachable.

Network topology can determine whether can successfully contact a remote host. The presence and configuration of proxies, network address translation (NAT) equipment, or firewalls can prevent from succeeding. A successful indicates only that the remote host can be reached on the network; the presence of higher level services (such as a Web server) on the remote host is not guaranteed.

This class provides functionality similar to the Ping.exe command line tool. The and methods send an Internet Control Message Protocol (ICMP) echo request message to a remote computer and waits for an ICMP echo reply message from that computer. For a detailed description of ICMP messages, see RFC 792, available at http://www.ietf.org.

The following types are used with the class and are described in detail below.

Type name

Description

Defines status codes that describe the outcome of an ICMP echo request message.

Allows you to configure or retrieve the settings that control how many times the request packet can be forwarded (), and whether it can be fragmented ( ).

Contains the results of an ICMP echo request.

Thrown if an unrecoverable error occurs.

Contains the data associated with events, which are raised when a call completes or is canceled.

The delegate that provides the callback method invoked when a call completes or is canceled.

The and methods return the reply in a object. The property returns an value to indicate the outcome of the request.

When sending the request, you must specify the remote computer. You can do this by providing a host name string, an IP address in string format, or an object.

You can also specify any of the following types of information:

Data to accompany the request. Specifying allows you to learn the amount of time required for a packet of a particular size to travel to and from the remote host and the maximum transmission unit of the network path. (See the or overloads that take a parameter.)

Whether the ICMP Echo packet can be fragmented in transit. (See the property and the or overloads that take an parameter.)

How many times routing nodes, such as routers or gateways, can forward the packet before it either reaches the destination computer or is discarded. (See and the or overloads that take an parameter.)

The time limit within which the reply must be received. (See the or overloads that take a parameter.

The class offers both synchronous and asynchronous methods for sending the request. If your application should block while waiting for a reply, use the methods; these methods are synchronous. If your application should not block, use the asynchronous methods. A call to executes in its own thread that is automatically allocated from the thread pool. When the asynchronous operation completes, it raises the event. Applications use a delegate to specify the method that is called for events. You must add a delegate to the event before calling . The delegate's method receives a object that contains a object that describes the result of the call.

You cannot use the same instance of the class to generate multiple simultaneous ICMP Echo requests. Calling while a call is in progress or calling multiple times before all previous calls have completed causes an .

Allows an application to determine whether a remote computer is accessible over the network.

- Constructor
  2.0.0.0
  4.0.0.0
  To be added.

  Initializes a new instance of the class.

- Method
  2.0.0.0
  4.0.0.0
  System.Void ``

  Classes that inherit from the class can override this method to perform additional tasks, such as logging the data contained in the parameter.

  Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.

  The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

  Raises the event.

  A object that contains event data.
- Event
  2.0.0.0
  4.0.0.0
  System.Net.NetworkInformation.PingCompletedEventHandler

  Applications use the event to get information about the completion status and data collected by a call to one of the methods. The delegate provides the call back method invoked when raises this event.

  Occurs when an asynchronous operation to send an Internet Control Message Protocol (ICMP) echo message and receive the corresponding ICMP echo reply message completes or is canceled.

- Method
  2.0.0.0
  4.0.0.0
  System.Net.NetworkInformation.PingReply ``

  This method sends to the host that is specified by a 32 data buffer with the ICMP echo message. The method waits five seconds for an ICMP echo reply message. If it does not receive a reply in that time, the method returns and the property is set to .

  This overload uses default settings for packet fragmentation and packet forwarding. The packet that contains the ICMP echo message can be fragmented in transit if the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers. To prevent fragmentation, use one of the methods that takes an parameter, and set the property to true. When is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. When this happens, the is set to . The packet or packet fragments (if fragmented) can be forwarded by routing nodes 128 times before being discarded. To change this setting, use a overload that takes an parameter, and set the property to the desired value. If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. When this happens, the is set to .

  Attempts to send an Internet Control Message Protocol (ICMP) echo message to the computer that has the specified , and receive a corresponding ICMP echo reply message from that computer.

  A object that provides information about the ICMP echo reply message, if one was received, or describes the reason for the failure if no message was received.

  An that identifies the computer that is the destination for the ICMP echo message.
- Method
  2.0.0.0
  4.0.0.0
  System.Net.NetworkInformation.PingReply ``

  This method sends a 32 data buffer with the ICMP echo message. The method waits five seconds for an ICMP echo reply message. If it does not receive a reply in that time, the method returns and the property is set to .

  This overload uses default settings for packet fragmentation and packet forwarding. The packet that contains the ICMP echo message can be fragmented in transit if the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers. To prevent fragmentation, use one of the methods that takes an parameter, and set the property to true. When is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. When this happens, the is set to . The packet or packet fragments (if fragmented) can be forwarded by routing nodes 128 times before being discarded. To change this setting, use a overload that takes an parameter, and set the property to the desired value. If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. When this happens, the is set to .

  Attempts to send an Internet Control Message Protocol (ICMP) echo message to the specified computer, and receive a corresponding ICMP echo reply message from that computer.

  A object that provides information about the ICMP echo reply message, if one was received, or provides the reason for the failure, if no message was received.

  A that identifies 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.
- Method
  2.0.0.0
  4.0.0.0
  System.Net.NetworkInformation.PingReply `` ``

  If the ICMP echo reply message is not received within the time specified in the parameter, the ICMP echo fails, and the property is set to .

  When specifying very small numbers for , the Ping reply can be received even if milliseconds have elapsed.

  This overload uses default settings for packet fragmentation and packet forwarding. The packet that contains the ICMP echo message can be fragmented in transit if the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers. To prevent fragmentation, use one of the methods that takes an parameter, and set the property to true. When is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. When this happens, the is set to .

  The packet or packet fragments can be forwarded by routing nodes 128 times before being discarded. To change this setting, use a overload that takes an parameter, and set the property to the desired value. If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. When this happens, the is set to .

  Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified , and receive a corresponding ICMP echo reply message from that computer. This method allows you to specify a time-out value for the operation.

  A object that provides information about the ICMP echo reply message if one was received, or provides the reason for the failure if no message was received.

  An that identifies the computer that is the destination for the ICMP echo message. An value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message.
- Method
  2.0.0.0
  4.0.0.0
  System.Net.NetworkInformation.PingReply `` ``

  If the ICMP echo reply message is not received within the time specified in the parameter, the ICMP echo fails, and the property is set to .

  When specifying very small numbers for , the Ping reply can be received even if milliseconds have elapsed.

  This overload uses default settings for packet fragmentation and packet forwarding. The packet that contains the ICMP echo message can be fragmented in transit if the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers. To prevent fragmentation, use one of the methods that takes an parameter, and set the property to true. When is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. When this happens, the is set to . The packet or packet fragments (if fragmented) can be forwarded by routing nodes 128 times before being discarded. To change this setting, use a overload that takes an parameter, and set the property to the desired value. If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. When this happens, the is set to .

  Attempts to send an Internet Control Message Protocol (ICMP) echo message to the specified computer, and receive a corresponding ICMP echo reply message from that computer. This method allows you to specify a time-out value for the operation.

  A object that provides information about the ICMP echo reply message if one was received, or provides the reason for the failure if no message was received.

  A that identifies 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. An value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message.
- Method
  2.0.0.0
  4.0.0.0
  System.Net.NetworkInformation.PingReply `` `` ``

  If the ICMP echo reply message is not received within the time specified in the parameter, the ICMP echo fails, and the property is set to .

  When specifying very small numbers for , the Ping reply can be received even if milliseconds have elapsed.

  This overload uses default settings for packet fragmentation and packet forwarding. The packet that contains the ICMP echo message can be fragmented in transit if the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers. To prevent fragmentation, use one of the methods that takes an parameter, and set the property to true. When is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. When this happens, the is set to .

  The packet or packet fragments can be forwarded by routing nodes 128 times before being discarded. To change this setting, use a overload that takes an parameter, and set the property to the desired value. If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. When this happens, the is set to .

  Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified , and receive a corresponding ICMP echo reply message from that computer. This overload allows you to specify a time-out value for the operation.

  A object that provides information about the ICMP echo reply message, if one was received, or provides the reason for the failure, if no message was received. The method will return if the packet exceeds the Maximum Transmission Unit (MTU).

  An that identifies the computer that is the destination for the ICMP echo message. An value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message. A 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.
- Method
  2.0.0.0
  4.0.0.0
  System.Net.NetworkInformation.PingReply `` `` ``

  If the ICMP echo reply message is not received within the time specified in the parameter, the ICMP echo fails, and the property is set to .

  When specifying very small numbers for , the Ping reply can be received even if milliseconds have elapsed.

  This overload uses default settings for packet fragmentation and packet forwarding. The packet that contains the ICMP echo message can be fragmented in transit if the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers. To prevent fragmentation, use one of the methods that takes an parameter, and set the property to true. When is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. When this happens, the is set to .

  The packet or packet fragments can be forwarded by routing nodes 128 times before being discarded. To change this setting, use a overload that takes an parameter, and set the property to the desired value. If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. When this happens, the is set to .

  Attempts to send 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. This overload allows you to specify a time-out value for the operation.

  A object that provides information about the ICMP echo reply message if one was received, or provides the reason for the failure if no message was received.

  A that identifies 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. An value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message. A 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.
- Method
  2.0.0.0
  4.0.0.0
  System.Net.NetworkInformation.PingReply `` `` `` ``

  If the ICMP echo reply message is not received within the time specified by the parameter, the ICMP echo fails, and the property is set to .

  When specifying very small numbers for , the Ping reply can be received even if milliseconds have elapsed.

  If the property is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. When this happens, the is set to .

  Use the property to specify the maximum number of times the ICMP echo message can be forwarded before reaching its destination. If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. When this happens, the is set to .

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

  A object that provides information about the ICMP echo reply message, if one was received, or provides the reason for the failure, if no message was received. The method will return if the packet exceeds the Maximum Transmission Unit (MTU).

  An that identifies the computer that is the destination for the ICMP echo message. An value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message. A 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. A object used to control fragmentation and Time-to-Live values for the ICMP echo message packet.
- Method
  2.0.0.0
  4.0.0.0
  System.Net.NetworkInformation.PingReply `` `` `` ``

  If the ICMP echo reply message is not received within the time specified by the parameter, the ICMP echo fails, and the property is set to .

  When specifying very small numbers for , the Ping reply can be received even if milliseconds have elapsed.

  If the property is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. When this happens, the is set to .

  Use the property to specify the maximum number of times the ICMP echo message can be forwarded before reaching its destination. If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. When this happens, the is set to .

  Attempts to send 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. This overload allows you to specify a time-out value for the operation and control fragmentation and Time-to-Live values for the ICMP packet.

  A object that provides information about the ICMP echo reply message if one was received, or provides the reason for the failure if no message was received.

  A that identifies 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. An value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message. A 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. A object used to control fragmentation and Time-to-Live values for the ICMP echo message packet.
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` ``

  The method sends the echo message asynchronously and, when the operation completes (successfully or unsuccessfully), returns the status to your application. Call the method when your application should not block. Each call to this method executes in a separate thread that is automatically allocated from the thread pool. When the asynchronous operation completes, it raises the event. To specify the method that is called when raises the event, you must add a delegate to the event before calling . The delegate's method receives a object that contains a object that describes the result of the call. The object inherits the property. This property contains the object passed into the call.

  If your application should block while waiting for a reply, use one of the methods; these methods are synchronous.

  This method sends a 32 data buffer with the ICMP echo message. The method waits five seconds for an ICMP echo reply message. If it does not receive a reply in that time, the method returns and the property is set to .

  This overload uses default settings for packet fragmentation and packet forwarding. The packet that contains the ICMP echo message can be fragmented in transit if the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers. To prevent fragmentation, use one of the methods that takes an parameter, and set the property to true. When is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. When this happens, the is set to .

  The packet or packet fragments can be forwarded by routing nodes 128 times before being discarded. To change this setting, use a overload that takes an parameter, and set the property to the desired value. If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. When this happens, the is set to .

  Asynchronously attempts to send an Internet Control Message Protocol (ICMP) echo message to the computer that has the specified , and receive a corresponding ICMP echo reply message from that computer.

  An that identifies the computer that is the destination for the ICMP echo message. An object that is passed to the method invoked when the asynchronous operation completes.
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` ``

  The method sends the echo message asynchronously and, when the operation completes (successfully or unsuccessfully), returns the status to your application. Call the method when your application should not block. Each call to this method executes in a separate thread that is automatically allocated from the thread pool. When the asynchronous operation completes, it raises the event. To specify the method that is called when raises the event, you must add a delegate to the event before calling . The delegate's method receives a object that contains a object that describes the result of the call. The object inherits the property. This property contains the object passed into the call.

  If your application should block while waiting for a reply, use the methods; these methods are synchronous.

  This method sends a 32 data buffer with the ICMP echo message. The method waits five seconds for an ICMP echo reply message. If it does not receive a reply in that time the method returns and the property is set to .

  This overload uses default settings for packet fragmentation and packet forwarding. The packet that contains the ICMP echo message can be fragmented in transit if the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers. To prevent fragmentation, use one of the methods that takes an parameter, and set the property to true. When is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. When this happens, the is set to .

  The packet or packet fragments can be forwarded by routing nodes 128 times before being discarded. To change this setting, use a overload that takes an parameter, and set the property to the desired value. If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. When this happens, the is set to .

  Asynchronously attempts to send an Internet Control Message Protocol (ICMP) echo message to the specified computer, and receive a corresponding ICMP echo reply message from that computer.

  A that identifies 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. An object that is passed to the method invoked when the asynchronous operation completes.
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` `` ``

  The method sends the Echo message asynchronously and, when the operation completes (successfully or unsuccessfully), returns the status to your application. Call the method when your application should not block. Each call executes in a separate thread that is automatically allocated from the thread pool. When the asynchronous operation completes, it raises the event. Applications use a delegate to specify the method that is called when raises the event. You must add a delegate to the event before calling . The delegate's method receives a object that contains a object that describes the result of the call. The object inherits the property. This property contains the object passed into the call.

  If your application should block while waiting for a reply, use the methods; these methods are synchronous.

  If the ICMP echo reply message is not received within the time specified by the parameter, the ICMP echo fails, and the property is set to .

  When specifying very small numbers for , the Ping reply can be received even if milliseconds have elapsed.

  This overload uses default settings for packet fragmentation and packet forwarding. The packet that contains the ICMP echo message can be fragmented in transit if the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers. To prevent fragmentation, use one of the methods that takes an parameter, and set the property to true. When is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. When this happens, the is set to . The packet or packet fragments (if fragmented) can be forwarded by routing nodes 128 times before being discarded. To change this setting, use a overload that takes an parameter, and set the property to the desired value. If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. When this happens, the is set to .

  Asynchronously attempts to send an Internet Control Message Protocol (ICMP) echo message to the computer that has the specified , and receive a corresponding ICMP echo reply message from that computer. This overload allows you to specify a time-out value for the operation.

  An that identifies the computer that is the destination for the ICMP echo message. An value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message. An object that is passed to the method invoked when the asynchronous operation completes.
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` `` ``

  The method sends the Echo message asynchronously and, when the operation completes (successfully or unsuccessfully), returns the status to your application. Call the method when your application should not block. Each call executes in a separate thread that is automatically allocated from the thread pool. When the asynchronous operation completes, it raises the event. Applications use a delegate to specify the method that is called when raises the event. You must add a delegate to the event before calling . The delegate's method receives a object that contains a object that describes the result of the call. The object inherits the property. This property contains the object passed into the call.

  If your application should block while waiting for a reply, use the methods; these methods are synchronous.

  If the ICMP echo reply message is not received within the time specified by the parameter, the ICMP echo fails, and the property is set to .

  When specifying very small numbers for , the Ping reply can be received even if milliseconds have elapsed.

  This overload uses default settings for packet fragmentation and packet forwarding. The packet that contains the ICMP echo message can be fragmented in transit if the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers. To prevent fragmentation, use one of the methods that takes an parameter, and set the property to true. When is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. When this happens, the is set to . The packet or packet fragments (if fragmented) can be forwarded by routing nodes 128 times before being discarded. To change this setting, use a overload that takes an parameter, and set the property to the desired value. If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. When this happens, the is set to .

  Asynchronously attempts to send an Internet Control Message Protocol (ICMP) echo message to the specified computer, and receive a corresponding ICMP echo reply message from that computer. This overload allows you to specify a time-out value for the operation.

  A that identifies 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. An value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message. An object that is passed to the method invoked when the asynchronous operation completes.
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` `` `` ``

  This method sends the echo message asynchronously and, when the operation completes (successfully or unsuccessfully), returns the status to your application. Call the method when your application should not block. Each call executes in a separate thread that is automatically allocated from the thread pool. When the asynchronous operation completes, it raises the event. To specify the method that is called when raises the event, you must add a delegate to the event before calling . The delegate's method receives a object that contains a object that describes the result of the call. The object inherits the property. This property contains the object passed into the call.

  If your application blocks while waiting for a reply, use the methods; these methods are synchronous.

  If the ICMP echo reply message is not received within the time specified by the parameter, the ICMP echo fails, and the property is set to .

  When specifying very small numbers for , the Ping reply can be received even if milliseconds have elapsed.

  This overload uses default settings for packet fragmentation and packet forwarding. The packet that contains the ICMP echo message can be fragmented in transit if the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers. To prevent fragmentation, use one of the methods that takes an parameter, and set the property to true. When is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. When this happens, the is set to . The packet or packet fragments (if fragmented) can be forwarded by routing nodes 128 times before being discarded. To change this setting, use a overload that takes an parameter, and set the property to the desired value. If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. When this happens, the is set to .

  Asynchronously attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified , and receive a corresponding ICMP echo reply message from that computer. This overload allows you to specify a time-out value for the operation.

  An that identifies the computer that is the destination for the ICMP echo message. An value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message. A 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. An object that is passed to the method invoked when the asynchronous operation completes.
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` `` `` ``

  The method sends the Echo message asynchronously and, when the operation completes (successfully or unsuccessfully), returns the status to your application. Call the method when your application should not block. Each call executes in a separate thread that is automatically allocated from the thread pool. When the asynchronous operation completes, it raises the event. Applications use a delegate to specify the method that is called when raises the event. You must add a delegate to the event before calling . The delegate's method receives a object containing a object that describes the result of the call. The object inherits the property. This property contains the object passed into the call.

  If your application should block while waiting for a reply, use the methods; these methods are synchronous.

  If the ICMP echo reply message is not received within the time specified by the parameter, the ICMP echo fails, and the property is set to .

  When specifying very small numbers for , the Ping reply can be received even if milliseconds have elapsed.

  This overload uses default settings for packet fragmentation and packet forwarding. The packet that contains the ICMP echo message can be fragmented in transit if the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers. To prevent fragmentation, use one of the methods that takes an parameter, and set the property to true. When is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. When this happens, the is set to . The packet or packet fragments (if fragmented) can be forwarded by routing nodes 128 times before being discarded. To change this setting, use a overload that takes an parameter, and set the property to the desired value. If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. When this happens, the is set to .

  Asynchronously attempts to send 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. This overload allows you to specify a time-out value for the operation.

  A that identifies 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. An value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message. A 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. An object that is passed to the method invoked when the asynchronous operation completes.
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` `` `` `` ``

  The method sends the Echo message asynchronously and, when the operation completes (successfully or unsuccessfully), returns the status to your application. Call the method when your application must not block. Each call executes in a separate thread that is automatically allocated from the thread pool. When the asynchronous operation completes, it raises the event. Applications use a delegate to specify the method that is called when raises the event. You must add a delegate to the event before calling . The delegate's method receives a object that contains a object that describes the result of the call. The object inherits the property. This property contains the object passed into the call.

  If your application blocks while waiting for a reply, use the methods; these methods are synchronous.

  If the ICMP echo reply message is not received within the time specified by the parameter, the ICMP echo fails, and the property is set to .

  When specifying very small numbers for , the Ping reply can be received even if milliseconds have elapsed.

  If the property is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. When this happens, the is set to .

  Use the property to specify the maximum number of times the ICMP echo message can be forwarded before reaching its destination. If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. When this happens, the is set to .

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

  An that identifies the computer that is the destination for the ICMP echo message. An value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message. A 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. A object used to control fragmentation and Time-to-Live values for the ICMP echo message packet. An object that is passed to the method invoked when the asynchronous operation completes.
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` `` `` `` ``

  The method sends the Echo message asynchronously and, when the operation completes (successfully or unsuccessfully), returns the status to your application. Call the method when your application must not block. Each call executes in a separate thread that is automatically allocated from the thread pool. When the asynchronous operation completes, it raises the event. Applications use a delegate to specify the method that is called when raises the event. You must add a delegate to the event before calling . The delegate's method receives a object that contains a object that describes the result of the call. The object inherits the property. This property contains the object passed into the call.

  If your application should block while waiting for a reply, use the methods; these methods are synchronous.

  If the ICMP echo reply message is not received within the time specified by the parameter, the ICMP echo fails, and the property is set to .

  When specifying very small numbers for , the Ping reply can be received even if milliseconds have elapsed.

  If the property is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. When this happens, the is set to .

  Use the property to specify the maximum number of times the ICMP echo message can be forwarded before reaching its destination. If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. When this happens, the is set to .

  Asynchronously attempts to send 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. This overload allows you to specify a time-out value for the operation and control fragmentation and Time-to-Live values for the ICMP packet.

  A that identifies 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. A 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. An value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message. A object used to control fragmentation and Time-to-Live values for the ICMP echo message packet. An object that is passed to the method invoked when the asynchronous operation completes.
- Method
  2.0.0.0
  4.0.0.0
  System.Void

  Call this method to terminate any calls to that have not completed.

  Cancels all pending asynchronous requests to send an Internet Control Message Protocol (ICMP) echo message and receives a corresponding ICMP echo reply message.

- Method
  4.0.0.0
  System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> ``

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

  Send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified , and receives a corresponding ICMP echo reply message from that computer as an asynchronous operation.

  Returns .

  The task object representing the asynchronous operation.

  An IP address that identifies the computer that is the destination for the ICMP echo message.
- Method
  4.0.0.0
  System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> ``

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

  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.

  Returns .

  The task object representing the asynchronous operation.

  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.
- Method
  4.0.0.0
  System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> `` ``

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

  Send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified , and receives 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.

  Returns .

  The task object representing the asynchronous operation.

  An IP address that identifies the computer that is the destination for the ICMP echo message. The maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message.
- Method
  4.0.0.0
  System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> `` ``

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

  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.

  Returns .

  The task object representing the asynchronous operation.

  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. The maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message.
- Method
  4.0.0.0
  System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> `` `` ``

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

  Send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified , and receives 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 and a buffer to use for send and receive.

  Returns .

  The task object representing the asynchronous operation.

  An IP address that identifies the computer that is the destination for the ICMP echo message. The maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message. A 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.
- Method
  4.0.0.0
  System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> `` `` ``

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

  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 and a buffer to use for send and receive.

  Returns .

  The task object representing the asynchronous operation.

  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. The maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message. A 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.
- Method
  4.0.0.0
  System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> `` `` `` ``

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

  Send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified , and receives 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.

  Returns .

  The task object representing the asynchronous operation.

  An IP address that identifies the computer that is the destination for the ICMP echo message. The maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message. A 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. A object used to control fragmentation and Time-to-Live values for the ICMP echo message packet.
- Method
  4.0.0.0
  System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> `` `` `` ``

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

  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.

  Returns .

  The task object representing the asynchronous operation.

  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. The maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message. A 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. A object used to control fragmentation and Time-to-Live values for the ICMP echo message packet.
- Method
  2.0.0.0
  4.0.0.0
  System.Void

  If you call any method on a object that has been disposed, you receive an .

  Releases all resources used by instances of the class.