PingOptions PingOptions PingOptions PingOptions Class

Definition

Wird verwendet, um das Übertragen von Ping-Datenpaketen zu steuern.Used to control how Ping data packets are transmitted.

public ref class PingOptions
public class PingOptions
type PingOptions = class
Public Class PingOptions
Vererbung
PingOptionsPingOptionsPingOptionsPingOptions

Beispiele

Im folgenden Codebeispiel wird die Ping, PingOptions und PingReply Klassen zum Senden einer ICMP-Echoanfrage an den Host in der Befehlszeile angegeben.The following code example uses the Ping, PingOptions and PingReply classes to send an ICMP echo request to the host specified on the command line.

#using <System.dll>

using namespace System;
using namespace System::Net;
using namespace System::Net::NetworkInformation;
using namespace System::Text;

// args[1] can be an IPaddress or host name.
int main()
{
   array<String^>^args = Environment::GetCommandLineArgs();
   
   Ping ^ pingSender = gcnew Ping;
   PingOptions ^ options = gcnew PingOptions;
   
   // Use the default Ttl value which is 128,
   // but change the fragmentation behavior.
   options->DontFragment = true;
   
   // Create a buffer of 32 bytes of data to be transmitted.
   String^ data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
   array<Byte>^buffer = Encoding::ASCII->GetBytes( data );
   int timeout = 120;
   PingReply ^ reply = pingSender->Send( args[ 1 ], 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 );
   }

   
}

using System;
using System.Net;
using System.Net.NetworkInformation;
using System.Text;

namespace Examples.System.Net.NetworkInformation.PingTest
{
    public class PingExample
    {
        // args[0] can be an IPaddress or host name.
        public static void Main (string[] args)
        {
            Ping pingSender = new Ping ();
            PingOptions options = new PingOptions ();

            // Use the default Ttl value which is 128,
            // but change the fragmentation behavior.
            options.DontFragment = true;

            // Create a buffer of 32 bytes of data to be transmitted.
            string data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
            byte[] buffer = Encoding.ASCII.GetBytes (data);
            int timeout = 120;
            PingReply reply = pingSender.Send (args[0], 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);
            }
        }
    }
}

Hinweise

Die PingOptions -Klasse stellt die Ttl und DontFragment Eigenschaften zu steuern, wie Internet Control Message Protocol (ICMP)-Echoanforderungspakete übertragen werden.The PingOptions class provides the Ttl and DontFragment properties to control how Internet Control Message Protocol (ICMP) echo request packets are transmitted.

Die Ttl Eigenschaft gibt an, das Time to Live für Pakete, die per der Ping Klasse.The Ttl property specifies the Time to Live for packets sent by the Ping class. Dieser Wert gibt an, die Anzahl der routing-Knoten, der weiterleiten kann eine Ping Paket aus, bevor sie verworfen wird.This value indicates the number of routing nodes that can forward a Ping packet before it is discarded. Das Festlegen dieser Option ist nützlich, wenn Sie die Anzahl der leitet testen möchten, auch bekannt als hops, sind erforderlich, um ein Paket von einem Quellcomputer zu einem Zielcomputer zu senden.Setting this option is useful if you want to test the number of forwards, also known as hops, are required to send a packet from a source computer to a destination computer.

Die DontFragment Eigenschaft steuert, ob Daten an einen Remotehost gesendet aufgeteilt werden können mehrere Pakete.The DontFragment property controls whether data sent to a remote host can be divided into multiple packets. Diese Option ist nützlich, wenn Sie die Router und Gateways, die zum Übertragen des Pakets die maximale Übertragungseinheit (MTU) testen möchten.This option is useful if you want to test the maximum transmission unit (MTU) of the routers and gateways used to transmit the packet.

Instanzen von der PingOptions -Klasse übergeben werden, auf die Send und SendAsync Methoden, und die PingReply Klasse gibt Instanzen von PingOptions über die Options Eigenschaft.Instances of the PingOptions class are passed to the Send and SendAsync methods, and the PingReply class returns instances of PingOptions via the Options property.

Eine Liste der anfänglichen Eigenschaftswerte für eine Instanz von PingOptions, finden Sie unter den PingOptions Konstruktor.For a list of initial property values for an instance of PingOptions, see the PingOptions constructor.

Konstruktoren

PingOptions() PingOptions() PingOptions() PingOptions()

Initialisiert eine neue Instanz der PingOptions-Klasse.Initializes a new instance of the PingOptions class.

PingOptions(Int32, Boolean) PingOptions(Int32, Boolean) PingOptions(Int32, Boolean) PingOptions(Int32, Boolean)

Initialisiert eine neue Instanz der PingOptions-Klasse und legt die Werte für Gültigkeitsdauer und Fragmentierung fest.Initializes a new instance of the PingOptions class and sets the Time to Live and fragmentation values.

Eigenschaften

DontFragment DontFragment DontFragment DontFragment

Ruft einen Boolean-Wert ab, der die Fragmentierung der an den Remotehost gesendeten Daten steuert, oder legt diesen fest.Gets or sets a Boolean value that controls fragmentation of the data sent to the remote host.

Ttl Ttl Ttl Ttl

Ruft die Anzahl der zulässigen Weiterleitungen der Ping-Daten über Routingknoten ab, bis die Daten verworfen werden.Gets or sets the number of routing nodes that can forward the Ping data before it is discarded.

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für: