PingReply.Buffer Propiedad

Definición

Espacio de nombres:

System.Net.NetworkInformation

Ensamblado:

System.Net.Ping.dll

Source:

PingReply.cs

Obtiene el búfer de datos recibidos en un mensaje de respuesta de eco ICMP (Protocolo de mensajes de control de Internet).

public:
 property cli::array <System::Byte> ^ Buffer { cli::array <System::Byte> ^ get(); };

public byte[] Buffer { get; }

member this.Buffer : byte[]

Public ReadOnly Property Buffer As Byte()

Valor de propiedad

Byte[]

Una matriz Byte que contiene los datos recibidos en un mensaje de respuesta de eco ICMP, o una matriz vacía si no se obtiene respuesta.

Ejemplos

En el ejemplo de código siguiente se envía una solicitud de eco ICMP de forma sincrónica y se muestra el tamaño del búfer devuelto por esta propiedad.

void ComplexPing()
{
   Ping ^ pingSender = gcnew Ping;
   
   // Create a buffer of 32 bytes of data to be transmitted.
   String^ data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
   array<Byte>^buffer = Encoding::ASCII->GetBytes( data );
   
   // Wait 10 seconds for a reply.
   int timeout = 10000;
   
   // Set options for transmission:
   // The data can go through 64 gateways or routers
   // before it is destroyed, and the data packet
   // cannot be fragmented.
   PingOptions ^ options = gcnew PingOptions( 64,true );
   
   // Send the request.
   PingReply ^ reply = pingSender->Send( "www.contoso.com", 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 );
   }
   else
   {
      Console::WriteLine( reply->Status );
   }
}

public static void ComplexPing ()
{
    Ping pingSender = new Ping ();

    // Create a buffer of 32 bytes of data to be transmitted.
    string data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
    byte[] buffer = Encoding.ASCII.GetBytes (data);

    // Wait 10 seconds for a reply.
    int timeout = 10000;

    // Set options for transmission:
    // The data can go through 64 gateways or routers
    // before it is destroyed, and the data packet
    // cannot be fragmented.
    PingOptions options = new PingOptions (64, true);

    // Send the request.
    PingReply reply = pingSender.Send ("www.contoso.com", 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);
    }
    else
    {
        Console.WriteLine (reply.Status);
    }
}

Comentarios

El búfer de datos enviado con la solicitud de eco ICMP se devuelve al remitente en la respuesta de eco para que se pueda calcular el tiempo de desplazamiento de ida y vuelta de un paquete de un tamaño conocido. El búfer de datos, combinado con la DontFragment opción , se puede usar para detectar la unidad de transmisión máxima para la ruta de acceso de red entre los equipos de origen y destino. Para obtener más información, vea "Traceroute" en RFC 1574, Sección 3.2, disponible en https://www.ietf.org.

El búfer predeterminado usado con Send y SendAsync contiene 32 bytes de datos.