PingReply.Options Eigenschaft

Definition

Ruft die Optionen zum Übertragen der Antwort auf eine ICMP (Internet Control Message Protocol)-Echoanfrage ab.

public:
 property System::Net::NetworkInformation::PingOptions ^ Options { System::Net::NetworkInformation::PingOptions ^ get(); };
public System.Net.NetworkInformation.PingOptions? Options { get; }
public System.Net.NetworkInformation.PingOptions Options { get; }
member this.Options : System.Net.NetworkInformation.PingOptions
Public ReadOnly Property Options As PingOptions

Eigenschaftswert

Ein PingOptions-Objekt, das die Gültigkeitsdauer (TTL) und Fragmentierungsdirektive zum Übertragen der Antwort enthält, wenn Status den Wert Success aufweist, andernfalls null.

Beispiele

Im folgenden Codebeispiel wird eine ICMP-Echoanforderung synchron gesendet und die werte angezeigt, die in dem PingOptions von dieser Eigenschaft zurückgegebenen Objekt gespeichert sind.

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

Hinweise

Die Gültigkeitsdauer definiert, wie oft Knoten ein Paket weiterleiten können, während es zwischen Quelle und Ziel wechselt. Wenn die Anzahl der Weiterleitungen( auch hops genannt) den für die TTL angegebenen Wert überschreitet, wird das Paket als nicht zustellbar betrachtet und verworfen.

Der DontFragment in der ICMP-Echoanforderung angegebene Wert steuert die Paketfragmentierung. Wenn DontFragment ist true und die Paketgröße die maximale Übertragungseinheit des Vom Paket belegten Netzwerkpfads überschreitet, wird das Paket verworfen, und der PacketTooBig Fehler wird zurückgegeben.

Gilt für: