PingReply.Options PingReply.Options PingReply.Options PingReply.Options Property

Definition

Ruft die Optionen zum Übertragen der Antwort auf eine ICMP (Internet Control Message Protocol)-Echoanfrage ab.Gets the options used to transmit the reply to an Internet Control Message Protocol (ICMP) echo request.

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

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.A PingOptions object that contains the Time to Live (TTL) and the fragmentation directive used for transmitting the reply if Status is Success; otherwise, null.

Beispiele

Im folgenden Codebeispiel wird eine ICMP-Echo Anforderung synchron gesendet und die im PingOptions -Objekt gespeicherten Werte angezeigt, die von dieser Eigenschaft zurückgegeben werden.The following code example sends an ICMP echo request synchronously and displays the values stored in the PingOptions object returned by this property.

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 bei der Übertragung zwischen Quelle und Ziel weiterleiten können.The TTL defines the number of times nodes can forward a packet as it travels between its source and destination. Wenn die Anzahl der Weiterleitungen, auch als Hops bezeichnet, den für die Gültigkeitsdauer angegebenen Wert überschreitet, gilt das Paket als nicht zulieferbar und wird verworfen.If the number of forwards, also known as hops, exceeds the value specified for the TTL, the packet is deemed undeliverable and is discarded.

Der DontFragment in der ICMP-Echo Anforderung angegebene Wert steuert die Paket Fragmentierung.The DontFragment value specified in the ICMP echo request controls packet fragmentation. Wenn DontFragmentden Wert hat PacketTooBig und die Paketgröße die maximale Übertragungseinheit für den Netzwerkpfad des Pakets überschreitet, wird das Paket verworfen, und der Fehler wird zurückgegeben. trueIf DontFragment is true and the packet size exceeds the maximum transmission unit of the network path taken by the packet, the packet is discarded and the PacketTooBig error is returned.

Gilt für: