PingReply.Buffer Propriété

Définition

Espace de noms:

System.Net.NetworkInformation

Assembly:

System.Net.Ping.dll

Source:

PingReply.cs

Obtient la mémoire tampon des données reçues dans un message de réponse à écho ICMP.

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()

Valeur de propriété

Byte[]

Tableau Byte contenant les données reçues dans un message de réponse à écho ICMP ou tableau vide, si aucune réponse n'a été reçue.

Exemples

L’exemple de code suivant envoie une requête d’écho ICMP de manière synchrone et affiche la taille de la mémoire tampon retournée par cette propriété.

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);
    }
}

Remarques

La mémoire tampon de données envoyée avec la demande d’écho ICMP est retournée à l’expéditeur dans la réponse d’écho afin que le temps de trajet aller-retour d’un paquet d’une taille connue puisse être calculé. La mémoire tampon de données, combinée à l’option DontFragment , peut être utilisée pour découvrir l’unité de transmission maximale pour le chemin réseau entre les ordinateurs source et de destination. Pour plus d’informations, consultez « Traceroute » dans RFC 1574, Section 3.2, disponible à l’adresse https://www.ietf.org.

La mémoire tampon par défaut utilisée avec Send et SendAsync contient 32 octets de données.