PingReply Klasa

Definicja

Zawiera informacje o stanie i danych w wyniku Send SendAsync operacji lub.Provides information about the status and data resulting from a Send or SendAsync operation.

public ref class PingReply
public class PingReply
type PingReply = class
Public Class PingReply
Dziedziczenie
PingReply

Przykłady

Poniższy przykład kodu demonstruje użycie Ping klasy w celu synchronicznego wysłania żądania echa ICMP i wyświetlenia odpowiedzi.The following code example demonstrates using Ping class to send an ICMP echo request synchronously and display the response.

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

Uwagi

PingKlasa próbuje wysłać żądanie echa protokołu ICMP (Internet Control Message Protocol) do komputera zdalnego i odbierać informacje z komputera za pośrednictwem komunikatu odpowiedzi ICMP echo.The Ping class attempts to send an Internet Control Message Protocol (ICMP) echo request to a remote computer and receive information back from the computer via an ICMP echo reply message. PingKlasa używa wystąpień PingReply klasy w celu zwrócenia informacji o operacji, takich jak stan i czas potrzebny na wysłanie żądania i odebranie odpowiedzi.The Ping class uses instances of the PingReply class to return information about the operation, such as its status and the time taken to send the request and receive the reply.

SendMetody zwracają wystąpienia PingReply klasy bezpośrednio.The Send methods return instances of the PingReply class directly. SendAsyncMetody zwracają wartość PingReply w PingCompletedEventHandler PingCompletedEventArgs parametrze metody.The SendAsync methods return a PingReply in the PingCompletedEventHandler method's PingCompletedEventArgs parameter. Dostęp do niego PingReply można uzyskać za pomocą Reply właściwości.The PingReply is accessed through the Reply property.

Jeśli wartość Status nie jest Success , nie należy używać wartości zwracanych przez RoundtripTime Options lub Buffer właściwości.If the value of Status is not Success, you should not use the values returned by the RoundtripTime, Options or Buffer properties. RoundtripTimeWłaściwość zwróci wartość zero, a właściwość zwróci Buffer pustą tablicę, a właściwość zwróci wartość Options null .The RoundtripTime property will return zero, the Buffer property will return an empty array, and the Options property will return null.

Właściwości

Address

Pobiera adres hosta, który wysyła odpowiedź echa protokołu ICMP (Internet Control Message Protocol).Gets the address of the host that sends the Internet Control Message Protocol (ICMP) echo reply.

Buffer

Pobiera bufor danych odebranych w komunikacie odpowiedzi echa protokołu komunikacyjnego sterowania Internetem (ICMP).Gets the buffer of data received in an Internet Control Message Protocol (ICMP) echo reply message.

Options

Pobiera opcje używane do przesyłania odpowiedzi do żądania echa protokołu komunikacyjnego sterowania Internetem (ICMP).Gets the options used to transmit the reply to an Internet Control Message Protocol (ICMP) echo request.

RoundtripTime

Pobiera liczbę milisekund, jaką należy wykonać, aby wysłać żądanie echa protokołu ICMP (Internet Control Message Protocol) i odebrać odpowiedni komunikat odpowiedzi ICMP echo.Gets the number of milliseconds taken to send an Internet Control Message Protocol (ICMP) echo request and receive the corresponding ICMP echo reply message.

Status

Pobiera stan próby wysłania żądania echa protokołu ICMP (Internet Control Message Protocol) i Odbierz odpowiedni komunikat odpowiedzi ICMP echo.Gets the status of an attempt to send an Internet Control Message Protocol (ICMP) echo request and receive the corresponding ICMP echo reply message.

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Dotyczy