PingReply.Options Propriété

Définition

Espace de noms:

System.Net.NetworkInformation

Assembly:

System.Net.Ping.dll

Source:

PingReply.cs

Obtient les options utilisées pour transmettre la réponse à une demande d'écho ICMP.

public:
 property System::Net::NetworkInformation::PingOptions ^ Options { System::Net::NetworkInformation::PingOptions ^ get(); };

public System.Net.NetworkInformation.PingOptions? Options { get; }

member this.Options : System.Net.NetworkInformation.PingOptions

Public ReadOnly Property Options As PingOptions

Valeur de propriété

PingOptions

Objet PingOptions qui contient la durée de vie (TTL, Time-to-Live) et la directive de fragmentation utilisée pour transmettre la réponse si Status est Success ; sinon, null.

Exemples

L’exemple de code suivant envoie une requête d’écho ICMP de manière synchrone et affiche les valeurs stockées dans l’objet PingOptions retourné par cette propriété.

void LocalPing()
{
   
   // Ping's the local machine.
   Ping ^ pingSender = gcnew Ping;
   IPAddress^ address = IPAddress::Loopback;
   PingReply ^ reply = pingSender->Send( address );
   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 LocalPing ()
{
    // Ping's the local machine.
    Ping pingSender = new Ping ();
    IPAddress address = IPAddress.Loopback;
    PingReply reply = pingSender.Send (address);

    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 durée de vie définit le nombre de fois où les nœuds peuvent transférer un paquet pendant qu’il se déplace entre sa source et sa destination. Si le nombre de transfert, également appelés tronçons, dépasse la valeur spécifiée pour la durée de vie, le paquet est considéré comme non distribuable et est ignoré.

La DontFragment valeur spécifiée dans la demande d’écho ICMP contrôle la fragmentation des paquets. Si DontFragment est true et que la taille du paquet dépasse l’unité de transmission maximale du chemin d’accès réseau pris par le paquet, le paquet est ignoré et l’erreur PacketTooBig est retournée.