PingReply.Options Właściwość

Definicja

Przestrzeń nazw:

System.Net.NetworkInformation

Zestaw:

System.Net.Ping.dll

Źródło:

PingReply.cs

Pobiera opcje używane do przesyłania odpowiedzi na żądanie echa protokołu ICMP (Internet Control Message Protocol).

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

Wartość właściwości

PingOptions

PingOptions Obiekt zawierający czas wygaśnięcia (TTL) i dyrektywę fragmentacji używaną do przesyłania odpowiedzi , jeśli Status jest to Success; w przeciwnym razie null.

Przykłady

Poniższy przykład kodu wysyła synchronicznie żądanie echa ICMP i wyświetla wartości przechowywane w PingOptions obiekcie zwróconym przez tę właściwość.

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

Uwagi

Czas wygaśnięcia definiuje liczbę węzłów, które mogą przekazywać pakiet w miarę przechodzenia między jego źródłem a miejscem docelowym. Jeśli liczba przesyłania dalej, znana również jako przeskoki, przekracza wartość TTL określona dla czasu wygaśnięcia, pakiet zostanie uznany za nieuprawniony i zostanie odrzucony.

Wartość określona DontFragment w fragmentacji pakietów żądania echa ICMP. Jeśli DontFragment jest i true rozmiar pakietu przekracza maksymalną jednostkę transmisji ścieżki sieciowej podjętej przez pakiet, pakiet zostanie odrzucony i PacketTooBig zostanie zwrócony błąd.