Ping.Send Methode

Quelle:

Ping.cs

Quelle:

Ping.cs

Quelle:

Ping.cs

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::String ^ hostNameOrAddress, TimeSpan timeout, cli::array <System::Byte> ^ buffer, System::Net::NetworkInformation::PingOptions ^ options);

public System.Net.NetworkInformation.PingReply Send (string hostNameOrAddress, TimeSpan timeout, byte[]? buffer, System.Net.NetworkInformation.PingOptions? options);

member this.Send : string * TimeSpan * byte[] * System.Net.NetworkInformation.PingOptions -> System.Net.NetworkInformation.PingReply

Public Function Send (hostNameOrAddress As String, timeout As TimeSpan, buffer As Byte(), options As PingOptions) As PingReply

Parameter

Gibt zurück

Informationen zur ICMP-Echoantwortnachricht, wenn eine empfangen wurde, oder der Grund für den Fehler, wenn keine Nachricht empfangen wurde.

Ausnahmen

Quelle:

Ping.cs

Quelle:

Ping.cs

Quelle:

Ping.cs

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::String ^ hostNameOrAddress, int timeout, cli::array <System::Byte> ^ buffer, System::Net::NetworkInformation::PingOptions ^ options);

public System.Net.NetworkInformation.PingReply Send (string hostNameOrAddress, int timeout, byte[] buffer, System.Net.NetworkInformation.PingOptions? options);

public System.Net.NetworkInformation.PingReply Send (string hostNameOrAddress, int timeout, byte[] buffer, System.Net.NetworkInformation.PingOptions options);

member this.Send : string * int * byte[] * System.Net.NetworkInformation.PingOptions -> System.Net.NetworkInformation.PingReply

Public Function Send (hostNameOrAddress As String, timeout As Integer, buffer As Byte(), options As PingOptions) As PingReply

Parameter

Gibt zurück

Ein PingReply-Objekt, das ggf. Informationen über die ICMP-Echoantwortmeldung bereitstellt, oder das die Fehlerursache angibt, falls keine Meldung empfangen wurde.

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie diese Methode aufgerufen wird.

void ComplexPing()
{
   Ping ^ pingSender = gcnew Ping;
   
   // Create a buffer of 32 bytes of data to be transmitted.
   String^ data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
   array<Byte>^buffer = Encoding::ASCII->GetBytes( data );
   
   // Wait 10 seconds for a reply.
   int timeout = 10000;
   
   // Set options for transmission:
   // The data can go through 64 gateways or routers
   // before it is destroyed, and the data packet
   // cannot be fragmented.
   PingOptions ^ options = gcnew PingOptions( 64,true );
   
   // Send the request.
   PingReply ^ reply = pingSender->Send( "www.contoso.com", 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 );
   }
   else
   {
      Console::WriteLine( reply->Status );
   }
}

public static void ComplexPing ()
{
    Ping pingSender = new Ping ();

    // Create a buffer of 32 bytes of data to be transmitted.
    string data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
    byte[] buffer = Encoding.ASCII.GetBytes (data);

    // Wait 10 seconds for a reply.
    int timeout = 10000;

    // Set options for transmission:
    // The data can go through 64 gateways or routers
    // before it is destroyed, and the data packet
    // cannot be fragmented.
    PingOptions options = new PingOptions (64, true);

    // Send the request.
    PingReply reply = pingSender.Send ("www.contoso.com", 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);
    }
    else
    {
        Console.WriteLine (reply.Status);
    }
}

Hinweise

Wenn die ICMP-Echoantwortnachricht nicht innerhalb der vom timeout Parameter angegebenen Zeit empfangen wird, schlägt das ICMP-Echo fehl, und die Status -Eigenschaft ist auf TimedOutfestgelegt.

Wenn die DontFragment -Eigenschaft ist true und die Gesamtpaketgröße die maximale Paketgröße überschreitet, die von einem der Routingknoten zwischen dem lokalen computer und dem Remotecomputer übertragen werden kann, schlägt die ICMP-Echoanforderung fehl. In diesem Fall wird auf Status festgelegt PacketTooBig.

Verwenden Sie die Ttl -Eigenschaft, um anzugeben, wie oft die ICMP-Echonachricht maximal weitergeleitet werden kann, bevor sie ihr Ziel erreicht. Wenn das Paket sein Ziel nach der angegebenen Anzahl von Weiterleitungen nicht erreicht, wird das Paket verworfen, und die ICMP-Echoanforderung schlägt fehl. In diesem Fall wird auf Status festgelegt TtlExpired.

Quelle:

Ping.cs

Quelle:

Ping.cs

Quelle:

Ping.cs

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::Net::IPAddress ^ address, TimeSpan timeout, cli::array <System::Byte> ^ buffer, System::Net::NetworkInformation::PingOptions ^ options);

public System.Net.NetworkInformation.PingReply Send (System.Net.IPAddress address, TimeSpan timeout, byte[]? buffer, System.Net.NetworkInformation.PingOptions? options);

member this.Send : System.Net.IPAddress * TimeSpan * byte[] * System.Net.NetworkInformation.PingOptions -> System.Net.NetworkInformation.PingReply

Public Function Send (address As IPAddress, timeout As TimeSpan, buffer As Byte(), options As PingOptions) As PingReply

Parameter

Gibt zurück

Informationen zur ICMP-Echoantwortnachricht, wenn eine empfangen wurde, oder der Grund für den Fehler, wenn keine Nachricht empfangen wurde.

Ausnahmen

Quelle:

Ping.cs

Quelle:

Ping.cs

Quelle:

Ping.cs

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::Net::IPAddress ^ address, int timeout, cli::array <System::Byte> ^ buffer, System::Net::NetworkInformation::PingOptions ^ options);

public System.Net.NetworkInformation.PingReply Send (System.Net.IPAddress address, int timeout, byte[] buffer, System.Net.NetworkInformation.PingOptions? options);

public System.Net.NetworkInformation.PingReply Send (System.Net.IPAddress address, int timeout, byte[] buffer, System.Net.NetworkInformation.PingOptions options);

member this.Send : System.Net.IPAddress * int * byte[] * System.Net.NetworkInformation.PingOptions -> System.Net.NetworkInformation.PingReply

Public Function Send (address As IPAddress, timeout As Integer, buffer As Byte(), options As PingOptions) As PingReply

Parameter

Gibt zurück

Ein PingReply-Objekt, das ggf. Informationen über die ICMP-Echoantwortmeldung bereitstellt, oder das die Fehlerursache angibt, falls keine Meldung empfangen wurde. Die Methode gibt PacketTooBig zurück, wenn das Paket die Größe der maximalen Übertragungseinheit überschreitet.

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie diese Methode aufgerufen wird.

void ComplexLocalPing()
{
   
   // Ping's the local machine.
   Ping ^ pingSender = gcnew Ping;
   IPAddress^ address = IPAddress::Loopback;
   
   // Create a buffer of 32 bytes of data to be transmitted.
   String^ data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
   array<Byte>^buffer = Encoding::ASCII->GetBytes( data );
   
   // Wait 10 seconds for a reply.
   int timeout = 10000;
   
   // Set options for transmission:
   // The data can go through 64 gateways or routers
   // before it is destroyed, and the data packet
   // cannot be fragmented.
   PingOptions ^ options = gcnew PingOptions( 64,true );
   PingReply ^ reply = pingSender->Send( address, 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 );
   }
   else
   {
      Console::WriteLine( reply->Status );
   }
}

public static void ComplexLocalPing ()
{
    // Ping's the local machine.
    Ping pingSender = new Ping ();
    IPAddress address = IPAddress.Loopback;

    // Create a buffer of 32 bytes of data to be transmitted.
    string data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
    byte[] buffer = Encoding.ASCII.GetBytes (data);

    // Wait 10 seconds for a reply.
    int timeout = 10000;

    // Set options for transmission:
    // The data can go through 64 gateways or routers
    // before it is destroyed, and the data packet
    // cannot be fragmented.
    PingOptions options = new PingOptions (64, true);
    PingReply reply = pingSender.Send (address, 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);
    }
    else
    {
        Console.WriteLine (reply.Status);
    }
}

Hinweise

Wenn die ICMP-Echoantwortnachricht nicht innerhalb der vom timeout Parameter angegebenen Zeit empfangen wird, schlägt das ICMP-Echo fehl, und die Status -Eigenschaft ist auf TimedOutfestgelegt.

Wenn die DontFragment -Eigenschaft ist true und die Gesamtpaketgröße die maximale Paketgröße überschreitet, die von einem der Routingknoten zwischen dem lokalen computer und dem Remotecomputer übertragen werden kann, schlägt die ICMP-Echoanforderung fehl. In diesem Fall wird auf Status festgelegt PacketTooBig.

Verwenden Sie die Ttl -Eigenschaft, um anzugeben, wie oft die ICMP-Echonachricht maximal weitergeleitet werden kann, bevor sie ihr Ziel erreicht. Wenn das Paket sein Ziel nach der angegebenen Anzahl von Weiterleitungen nicht erreicht, wird das Paket verworfen, und die ICMP-Echoanforderung schlägt fehl. In diesem Fall wird auf Status festgelegt TtlExpired.

Quelle:

Ping.cs

Quelle:

Ping.cs

Quelle:

Ping.cs

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::String ^ hostNameOrAddress, int timeout, cli::array <System::Byte> ^ buffer);

public System.Net.NetworkInformation.PingReply Send (string hostNameOrAddress, int timeout, byte[] buffer);

member this.Send : string * int * byte[] -> System.Net.NetworkInformation.PingReply

Public Function Send (hostNameOrAddress As String, timeout As Integer, buffer As Byte()) As PingReply

Parameter

Gibt zurück

Ein PingReply-Objekt, das ggf. Informationen über die ICMP-Echoantwortmeldung bereitstellt, oder das die Fehlerursache angibt, falls keine Meldung empfangen wurde.

Ausnahmen

Beispiele

Ein Beispiel, das das Aufrufen einer Send Überladung veranschaulicht, finden Sie in der Übersicht über die Ping Klasse.

Hinweise

Wenn die ICMP-Echoantwortnachricht nicht innerhalb der im timeout Parameter angegebenen Zeit empfangen wird, schlägt das ICMP-Echo fehl, und die Status -Eigenschaft ist auf TimedOutfestgelegt.

Diese Überladung verwendet Standardeinstellungen für die Paketfragmentierung und Paketweiterleitung. Das Paket, das die ICMP-Echonachricht enthält, kann während der Übertragung fragmentiert werden, wenn die Gesamtpaketgröße die maximale Paketgröße überschreitet, die von einem der Routingknoten zwischen den lokalen und Remotecomputern übertragen werden kann. Um die Fragmentierung zu verhindern, verwenden Sie eine der Methoden, die Send einen options Parameter akzeptiert, und legen Sie die DontFragment -Eigenschaft auf fest true. Wenn DontFragment ist true und die Gesamtpaketgröße die maximale Paketgröße überschreitet, die von einem der Routingknoten zwischen den lokalen und Remotecomputern übertragen werden kann, schlägt die ICMP-Echoanforderung fehl. In diesem Fall wird auf Status festgelegt PacketTooBig.

Die Paket- oder Paketfragmente können von Routingknoten 128-mal weitergeleitet werden, bevor sie verworfen werden. Um diese Einstellung zu ändern, verwenden Sie eine Send Überladung, die einen options Parameter akzeptiert, und legen Sie die Ttl -Eigenschaft auf den gewünschten Wert fest. Wenn das Paket sein Ziel nach der angegebenen Anzahl von Weiterleitungen nicht erreicht, wird das Paket verworfen, und die ICMP-Echoanforderung schlägt fehl. In diesem Fall wird auf Status festgelegt TtlExpired.

Quelle:

Ping.cs

Quelle:

Ping.cs

Quelle:

Ping.cs

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::Net::IPAddress ^ address, int timeout, cli::array <System::Byte> ^ buffer);

public System.Net.NetworkInformation.PingReply Send (System.Net.IPAddress address, int timeout, byte[] buffer);

member this.Send : System.Net.IPAddress * int * byte[] -> System.Net.NetworkInformation.PingReply

Public Function Send (address As IPAddress, timeout As Integer, buffer As Byte()) As PingReply

Parameter

Gibt zurück

Ein PingReply-Objekt, das ggf. Informationen über die ICMP-Echoantwortmeldung bereitstellt, oder das die Fehlerursache angibt, falls keine Meldung empfangen wurde. Die Methode gibt PacketTooBig zurück, wenn das Paket die Größe der maximalen Übertragungseinheit überschreitet.

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie diese Methode aufgerufen wird.

void LocalPingTimeout()
{
   
   // Ping's the local machine.
   Ping ^ pingSender = gcnew Ping;
   IPAddress^ address = IPAddress::Loopback;
   
   // Create a buffer of 32 bytes of data to be transmitted.
   String^ data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
   array<Byte>^buffer = Encoding::ASCII->GetBytes( data );
   
   // Wait 10 seconds for a reply.
   int timeout = 10000;
   PingReply ^ reply = pingSender->Send( address, timeout, buffer);
   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 LocalPingTimeout ()
{
    // Ping's the local machine.
    Ping pingSender = new Ping ();
    IPAddress address = IPAddress.Loopback;

    // Create a buffer of 32 bytes of data to be transmitted.
    string data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
    byte[] buffer = Encoding.ASCII.GetBytes (data);

    // Wait 10 seconds for a reply.
    int timeout = 10000;
    PingReply reply = pingSender.Send (address, timeout, buffer);

    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

Wenn die ICMP-Echoantwortnachricht nicht innerhalb der im timeout Parameter angegebenen Zeit empfangen wird, schlägt das ICMP-Echo fehl, und die Status -Eigenschaft ist auf TimedOutfestgelegt.

Diese Überladung verwendet Standardeinstellungen für die Paketfragmentierung und Paketweiterleitung. Das Paket, das die ICMP-Echonachricht enthält, kann während der Übertragung fragmentiert werden, wenn die Gesamtpaketgröße die maximale Paketgröße überschreitet, die von einem der Routingknoten zwischen den lokalen und Remotecomputern übertragen werden kann. Um die Fragmentierung zu verhindern, verwenden Sie eine der Methoden, die Send einen options Parameter akzeptiert, und legen Sie die DontFragment -Eigenschaft auf fest true. Wenn DontFragment ist true und die Gesamtpaketgröße die maximale Paketgröße überschreitet, die von einem der Routingknoten zwischen den lokalen und Remotecomputern übertragen werden kann, schlägt die ICMP-Echoanforderung fehl. In diesem Fall wird auf Status festgelegt PacketTooBig.

Die Paket- oder Paketfragmente können von Routingknoten 128-mal weitergeleitet werden, bevor sie verworfen werden. Um diese Einstellung zu ändern, verwenden Sie eine Send Überladung, die einen options Parameter akzeptiert, und legen Sie die Ttl -Eigenschaft auf den gewünschten Wert fest. Wenn das Paket sein Ziel nach der angegebenen Anzahl von Weiterleitungen nicht erreicht, wird das Paket verworfen, und die ICMP-Echoanforderung schlägt fehl. In diesem Fall wird auf Status festgelegt TtlExpired.

Quelle:

Ping.cs

Quelle:

Ping.cs

Quelle:

Ping.cs

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::String ^ hostNameOrAddress, int timeout);

public System.Net.NetworkInformation.PingReply Send (string hostNameOrAddress, int timeout);

member this.Send : string * int -> System.Net.NetworkInformation.PingReply

Public Function Send (hostNameOrAddress As String, timeout As Integer) As PingReply

Parameter

Gibt zurück

Ein PingReply-Objekt, das ggf. Informationen über die ICMP-Echoantwortmeldung bereitstellt, oder das die Fehlerursache angibt, falls keine Meldung empfangen wurde.

Ausnahmen

Beispiele

Ein Beispiel, das das Aufrufen einer Send Methode veranschaulicht, finden Sie in der Übersicht über die Ping Klasse.

Hinweise

Wenn die ICMP-Echoantwortnachricht nicht innerhalb der im timeout Parameter angegebenen Zeit empfangen wird, schlägt das ICMP-Echo fehl, und die Status -Eigenschaft ist auf TimedOutfestgelegt.

Diese Überladung verwendet Standardeinstellungen für die Paketfragmentierung und Paketweiterleitung. Das Paket, das die ICMP-Echonachricht enthält, kann während der Übertragung fragmentiert werden, wenn die Gesamtpaketgröße die maximale Paketgröße überschreitet, die von einem der Routingknoten zwischen den lokalen und Remotecomputern übertragen werden kann. Um die Fragmentierung zu verhindern, verwenden Sie eine der Methoden, die Send einen options Parameter akzeptiert, und legen Sie die DontFragment -Eigenschaft auf fest true. Wenn DontFragment ist true und die Gesamtpaketgröße die maximale Paketgröße überschreitet, die von einem der Routingknoten zwischen den lokalen und Remotecomputern übertragen werden kann, schlägt die ICMP-Echoanforderung fehl. In diesem Fall wird auf Status festgelegt PacketTooBig. Die Paket- oder Paketfragmente (falls fragmentiert) können 128-mal von Routingknoten weitergeleitet werden, bevor sie verworfen werden. Um diese Einstellung zu ändern, verwenden Sie eine Send Überladung, die einen options Parameter akzeptiert, und legen Sie die Ttl -Eigenschaft auf den gewünschten Wert fest. Wenn das Paket sein Ziel nach der angegebenen Anzahl von Weiterleitungen nicht erreicht, wird das Paket verworfen, und die ICMP-Echoanforderung schlägt fehl. In diesem Fall wird auf Status festgelegt TtlExpired.

Quelle:

Ping.cs

Quelle:

Ping.cs

Quelle:

Ping.cs

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::Net::IPAddress ^ address, int timeout);

public System.Net.NetworkInformation.PingReply Send (System.Net.IPAddress address, int timeout);

member this.Send : System.Net.IPAddress * int -> System.Net.NetworkInformation.PingReply

Public Function Send (address As IPAddress, timeout As Integer) As PingReply

Parameter

Gibt zurück

Ein PingReply-Objekt, das ggf. Informationen über die ICMP-Echoantwortmeldung bereitstellt, oder das die Fehlerursache angibt, falls keine Meldung empfangen wurde.

Ausnahmen

Beispiele

Ein Beispiel, das das Aufrufen einer Send Methode veranschaulicht, finden Sie in der Übersicht über die Ping Klasse.

Hinweise

Wenn die ICMP-Echoantwortnachricht nicht innerhalb der im timeout Parameter angegebenen Zeit empfangen wird, schlägt das ICMP-Echo fehl, und die Status -Eigenschaft ist auf TimedOutfestgelegt.

Diese Überladung verwendet Standardeinstellungen für die Paketfragmentierung und Paketweiterleitung. Das Paket, das die ICMP-Echonachricht enthält, kann während der Übertragung fragmentiert werden, wenn die Gesamtpaketgröße die maximale Paketgröße überschreitet, die von einem der Routingknoten zwischen den lokalen und Remotecomputern übertragen werden kann. Um die Fragmentierung zu verhindern, verwenden Sie eine der Methoden, die Send einen options Parameter akzeptiert, und legen Sie die DontFragment -Eigenschaft auf fest true. Wenn DontFragment ist true und die Gesamtpaketgröße die maximale Paketgröße überschreitet, die von einem der Routingknoten zwischen den lokalen und Remotecomputern übertragen werden kann, schlägt die ICMP-Echoanforderung fehl. In diesem Fall wird auf Status festgelegt PacketTooBig.

Die Paket- oder Paketfragmente können von Routingknoten 128-mal weitergeleitet werden, bevor sie verworfen werden. Um diese Einstellung zu ändern, verwenden Sie eine Send Überladung, die einen options Parameter akzeptiert, und legen Sie die Ttl -Eigenschaft auf den gewünschten Wert fest. Wenn das Paket sein Ziel nach der angegebenen Anzahl von Weiterleitungen nicht erreicht, wird das Paket verworfen, und die ICMP-Echoanforderung schlägt fehl. In diesem Fall wird auf Status festgelegt TtlExpired.

Quelle:

Ping.cs

Quelle:

Ping.cs

Quelle:

Ping.cs

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::String ^ hostNameOrAddress);

public System.Net.NetworkInformation.PingReply Send (string hostNameOrAddress);

member this.Send : string -> System.Net.NetworkInformation.PingReply

Public Function Send (hostNameOrAddress As String) As PingReply

Parameter

Gibt zurück

Ein PingReply-Objekt, das ggf. Informationen über die ICMP-Echoantwortmeldung bereitstellt, oder das die Fehlerursache angibt, falls keine Meldung empfangen wurde.

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird das Aufrufen dieser Methode veranschaulicht.

void SimplePing()
{
   Ping ^ pingSender = gcnew Ping;
   PingReply ^ reply = pingSender->Send( "www.contoso.com" );
   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 SimplePing ()
{
    Ping pingSender = new Ping ();
    PingReply reply = pingSender.Send ("www.contoso.com");

    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

Diese Methode sendet einen 32-Datenpuffer Byte mit der ICMP-Echomeldung. Die -Methode wartet fünf Sekunden auf eine ICMP-Echoantwortnachricht. Wenn in diesem Zeitraum keine Antwort empfangen wird, gibt die Methode zurück, und die Status -Eigenschaft wird auf TimedOutfestgelegt.

Diese Überladung verwendet Standardeinstellungen für die Paketfragmentierung und Paketweiterleitung. Das Paket, das die ICMP-Echonachricht enthält, kann während der Übertragung fragmentiert werden, wenn die Gesamtpaketgröße die maximale Paketgröße überschreitet, die von einem der Routingknoten zwischen den lokalen und Remotecomputern übertragen werden kann. Um die Fragmentierung zu verhindern, verwenden Sie eine der Methoden, die Send einen options Parameter akzeptiert, und legen Sie die DontFragment -Eigenschaft auf fest true. Wenn DontFragment ist true und die Gesamtpaketgröße die maximale Paketgröße überschreitet, die von einem der Routingknoten zwischen den lokalen und Remotecomputern übertragen werden kann, schlägt die ICMP-Echoanforderung fehl. In diesem Fall wird auf Status festgelegt PacketTooBig. Die Paket- oder Paketfragmente (falls fragmentiert) können 128-mal von Routingknoten weitergeleitet werden, bevor sie verworfen werden. Um diese Einstellung zu ändern, verwenden Sie eine Send Überladung, die einen options Parameter akzeptiert, und legen Sie die Ttl -Eigenschaft auf den gewünschten Wert fest. Wenn das Paket sein Ziel nach der angegebenen Anzahl von Weiterleitungen nicht erreicht, wird das Paket verworfen, und die ICMP-Echoanforderung schlägt fehl. In diesem Fall wird auf Status festgelegt TtlExpired.

Quelle:

Ping.cs

Quelle:

Ping.cs

Quelle:

Ping.cs

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::Net::IPAddress ^ address);

public System.Net.NetworkInformation.PingReply Send (System.Net.IPAddress address);

member this.Send : System.Net.IPAddress -> System.Net.NetworkInformation.PingReply

Public Function Send (address As IPAddress) As PingReply

Parameter

Gibt zurück

Ein PingReply-Objekt, das ggf. Informationen über die ICMP-Echoantwortmeldung bereitstellt, oder das die Fehlerursache beschreibt, falls keine Meldung empfangen wurde.

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird das Aufrufen dieser Methode veranschaulicht.

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

Diese Methode sendet an den Host, der von address einem 32-Datenpuffer Byte mit der ICMP-Echomeldung angegeben wird. Die -Methode wartet fünf Sekunden auf eine ICMP-Echoantwortnachricht. Wenn in diesem Zeitraum keine Antwort empfangen wird, gibt die Methode zurück, und die Status -Eigenschaft wird auf TimedOutfestgelegt.

Diese Überladung verwendet Standardeinstellungen für die Paketfragmentierung und Paketweiterleitung. Das Paket, das die ICMP-Echonachricht enthält, kann während der Übertragung fragmentiert werden, wenn die Gesamtpaketgröße die maximale Paketgröße überschreitet, die von einem der Routingknoten zwischen den lokalen und Remotecomputern übertragen werden kann. Um die Fragmentierung zu verhindern, verwenden Sie eine der Methoden, die Send einen options Parameter akzeptiert, und legen Sie die DontFragment -Eigenschaft auf fest true. Wenn DontFragment ist true und die Gesamtpaketgröße die maximale Paketgröße überschreitet, die von einem der Routingknoten zwischen den lokalen und Remotecomputern übertragen werden kann, schlägt die ICMP-Echoanforderung fehl. In diesem Fall wird auf Status festgelegt PacketTooBig. Die Paket- oder Paketfragmente (falls fragmentiert) können 128-mal von Routingknoten weitergeleitet werden, bevor sie verworfen werden. Um diese Einstellung zu ändern, verwenden Sie eine Send Überladung, die einen options Parameter akzeptiert, und legen Sie die Ttl -Eigenschaft auf den gewünschten Wert fest. Wenn das Paket sein Ziel nach der angegebenen Anzahl von Weiterleitungen nicht erreicht, wird das Paket verworfen, und die ICMP-Echoanforderung schlägt fehl. In diesem Fall wird auf Status festgelegt TtlExpired.