PingReply Třída

Definice

Obor názvů:

System.Net.NetworkInformation

Sestavení:

System.Net.Ping.dll

Zdroj:

PingReply.cs

Poskytuje informace o stavu a datech vyplývajících z Send operace nebo SendAsync .

public ref class PingReply

public class PingReply

type PingReply = class

Public Class PingReply

Dědičnost

Object

PingReply

Příklady

Následující příklad kódu ukazuje použití Ping třídy k synchronnímu odeslání požadavku na odezvu ICMP a zobrazení odpovědi.

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

open System.Net.NetworkInformation
open System.Text

// args[0] can be an IPaddress or host name.
[<EntryPoint>]
let main args =
    let pingSender = new Ping()

    // Use the default Ttl value which is 128,
    // but change the fragmentation behavior.
    let options = PingOptions()
    options.DontFragment <- true

    // Create a buffer of 32 bytes of data to be transmitted.
    let data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
    let buffer = Encoding.ASCII.GetBytes data
    let timeout = 120
    let reply: PingReply = pingSender.Send(args.[0], timeout, buffer, options)

    match reply.Status with
    | IPStatus.Success ->
        printfn "Address: %O" reply.Address
        printfn "RoundTrip time: %d" reply.RoundtripTime
        printfn "Time to live: %d" reply.Options.Ttl
        printfn "Don't fragment: %b" reply.Options.DontFragment
        printfn "Buffer size: %d" reply.Buffer.Length
        0
    | _ ->
        eprintfn "Error sending ping: %O" reply
        eprintfn "Error was: %O" reply.Status
        1

Poznámky

Třída Ping se pokusí odeslat požadavek na odezvu protokolu ICMP (Internet Control Message Protocol) vzdálenému počítači a přijmout informace zpět z počítače prostřednictvím zprávy odezvy ICMP. Třída Ping používá instance PingReply třídy k vrácení informací o operaci, jako je její stav a čas potřebný k odeslání požadavku a přijetí odpovědi.

Metody Send vrací instance PingReply třídy přímo. Metody SendAsync vrátí PingReply v parametru PingCompletedEventHandler metody PingCompletedEventArgs hodnotu . K objektu PingReplyReply se přistupuje prostřednictvím vlastnosti .

Pokud hodnota Status není Success, neměli byste používat hodnoty vrácené vlastnostmi RoundtripTime, Options nebo Buffer . Vlastnost RoundtripTime vrátí nulu Buffer , vlastnost vrátí prázdné pole a Options vlastnost vrátí nullhodnotu .

Vlastnosti

Address	Získá adresu hostitele, který odešle odpověď odezvy protokolu ICMP (Internet Control Message Protocol).
Buffer	Získá vyrovnávací paměť dat přijatých ve zprávě odezvy protokolu ICMP (Internet Control Message Protocol).
Options	Získá možnosti použité k přenosu odpovědi na požadavek odezvy protokolu ICMP (Internet Control Message Protocol).
RoundtripTime	Získá počet milisekund potřebných k odeslání požadavku na odezvu protokolu ICMP (Internet Control Message Protocol) a přijetí odpovídající zprávy odezvy ICMP.
Status	Získá stav pokusu o odeslání žádosti o odezvu protokolu ICMP (Internet Control Message Protocol) a přijmout odpovídající zprávu odezvy PROTOKOLU ICMP.

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)