PingReply Clase

Definición

Proporciona información sobre el estado y los datos resultantes de una operación Send o SendAsync.Provides information about the status and data resulting from a Send or SendAsync operation.

public ref class PingReply
public class PingReply
type PingReply = class
Public Class PingReply
Herencia
PingReply

Ejemplos

En el ejemplo de código siguiente Ping se muestra cómo usar la clase para enviar una solicitud de eco ICMP sincrónicamente y mostrar la respuesta.The following code example demonstrates using Ping class to send an ICMP echo request synchronously and display the response.

#using <System.dll>

using namespace System;
using namespace System::Net;
using namespace System::Net::NetworkInformation;
using namespace System::Text;

// args[1] can be an IPaddress or host name.
int main()
{
   array<String^>^args = Environment::GetCommandLineArgs();
   
   Ping ^ pingSender = gcnew Ping;
   PingOptions ^ options = gcnew PingOptions;
   
   // Use the default Ttl value which is 128,
   // but change the fragmentation behavior.
   options->DontFragment = true;
   
   // Create a buffer of 32 bytes of data to be transmitted.
   String^ data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
   array<Byte>^buffer = Encoding::ASCII->GetBytes( data );
   int timeout = 120;
   PingReply ^ reply = pingSender->Send( args[ 1 ], timeout, buffer, options );
   
   if ( reply->Status == IPStatus::Success )
   {
      Console::WriteLine( "Address: {0}", reply->Address->ToString() );
      Console::WriteLine( "RoundTrip time: {0}", reply->RoundtripTime );
      Console::WriteLine( "Time to live: {0}", reply->Options->Ttl );
      Console::WriteLine( "Don't fragment: {0}", reply->Options->DontFragment );
      Console::WriteLine( "Buffer size: {0}", reply->Buffer->Length );
   }

   
}

using System;
using System.Net;
using System.Net.NetworkInformation;
using System.Text;

namespace Examples.System.Net.NetworkInformation.PingTest
{
    public class PingExample
    {
        // args[0] can be an IPaddress or host name.
        public static void Main (string[] args)
        {
            Ping pingSender = new Ping ();
            PingOptions options = new PingOptions ();

            // Use the default Ttl value which is 128,
            // but change the fragmentation behavior.
            options.DontFragment = true;

            // Create a buffer of 32 bytes of data to be transmitted.
            string data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
            byte[] buffer = Encoding.ASCII.GetBytes (data);
            int timeout = 120;
            PingReply reply = pingSender.Send (args[0], timeout, buffer, options);
            if (reply.Status == IPStatus.Success)
            {
                Console.WriteLine ("Address: {0}", reply.Address.ToString ());
                Console.WriteLine ("RoundTrip time: {0}", reply.RoundtripTime);
                Console.WriteLine ("Time to live: {0}", reply.Options.Ttl);
                Console.WriteLine ("Don't fragment: {0}", reply.Options.DontFragment);
                Console.WriteLine ("Buffer size: {0}", reply.Buffer.Length);
            }
        }
    }
}

Comentarios

La Ping clase intenta enviar una solicitud de eco del Protocolo de mensajes de control de Internet (ICMP) a un equipo remoto y recibir información del equipo a través de un mensaje de respuesta de eco ICMP.The Ping class attempts to send an Internet Control Message Protocol (ICMP) echo request to a remote computer and receive information back from the computer via an ICMP echo reply message. La Ping clase utiliza instancias de la PingReply clase para devolver información sobre la operación, como su estado y el tiempo que se tarda en enviar la solicitud y recibir la respuesta.The Ping class uses instances of the PingReply class to return information about the operation, such as its status and the time taken to send the request and receive the reply.

Los Send métodos devuelven instancias PingReply de la clase directamente.The Send methods return instances of the PingReply class directly. Los SendAsync métodos devuelven un PingCompletedEventHandler PingReply valor en PingCompletedEventArgs el parámetro del método.The SendAsync methods return a PingReply in the PingCompletedEventHandler method's PingCompletedEventArgs parameter. Se obtiene acceso a a través Reply de la propiedad. PingReplyThe PingReply is accessed through the Reply property.

Si el valor de Status no Successes, no debe utilizar los valores devueltos por RoundtripTimelas Options propiedades Buffer , o.If the value of Status is not Success, you should not use the values returned by the RoundtripTime, Options or Buffer properties. La RoundtripTime propiedad devolverá cero, Buffer la propiedad devolverá una matriz vacía y Options la propiedad devolverá null.The RoundtripTime property will return zero, the Buffer property will return an empty array, and the Options property will return null.

Propiedades

Address

Obtiene la dirección del host que envía el mensaje de respuesta de eco ICPM (Protocolo de mensajes de control de Internet).Gets the address of the host that sends the Internet Control Message Protocol (ICMP) echo reply.

Buffer

Obtiene el búfer de datos recibidos en un mensaje de respuesta de eco ICMP (Protocolo de mensajes de control de Internet).Gets the buffer of data received in an Internet Control Message Protocol (ICMP) echo reply message.

Options

Obtiene las opciones utilizadas para transmitir la respuesta a un mensaje de solicitud de eco ICPM (Protocolo de mensajes de control de Internet).Gets the options used to transmit the reply to an Internet Control Message Protocol (ICMP) echo request.

RoundtripTime

Obtiene el número de milisegundos empleados en enviar un mensaje de solicitud de eco ICMP (Protocolo de mensajes de control de Internet) y recibir el mensaje de respuesta de eco ICMP correspondiente.Gets the number of milliseconds taken to send an Internet Control Message Protocol (ICMP) echo request and receive the corresponding ICMP echo reply message.

Status

Obtiene el estado de un intento de envío de un mensaje de solicitud de eco ICMP (Protocolo de mensajes de control de Internet) y la recepción del mensaje de respuesta de eco ICMP correspondiente.Gets the status of an attempt to send an Internet Control Message Protocol (ICMP) echo request and receive the corresponding ICMP echo reply message.

Métodos

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Se aplica a