Ping Třída

Definice

Obor názvů:

System.Net.NetworkInformation

Sestavení:

netstandard.dll, System.Net.Ping.dll

Zdroj:

Ping.cs

Umožňuje aplikaci určit, jestli je vzdálený počítač přístupný přes síť.

public ref class Ping : System::ComponentModel::Component

public class Ping : System.ComponentModel.Component

type Ping = class
    inherit Component

Public Class Ping
Inherits Component

Dědičnost

Object

MarshalByRefObject

Component

Ping

Příklady

Následující příklad kódu ukazuje použití Ping třídy synchronně.

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

Následující příklad kódu ukazuje použití Ping třídy asynchronně.

using System;
using System.Text;
using System.Net;
using System.Net.NetworkInformation;
using System.ComponentModel;
using System.Threading;

namespace Examples.System.Net.NetworkInformation.PingTest
{
    public class PingExample
    {
        public static void Main (string[] args)
        {
            if (args.Length == 0)
                throw new ArgumentException ("Ping needs a host or IP Address.");

            string who = args[0];
            AutoResetEvent waiter = new AutoResetEvent (false);

            Ping pingSender = new Ping ();

            // When the PingCompleted event is raised,
            // the PingCompletedCallback method is called.
            pingSender.PingCompleted += new PingCompletedEventHandler (PingCompletedCallback);

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

            // Wait 12 seconds for a reply.
            int timeout = 12000;

            // 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);

            Console.WriteLine ("Time to live: {0}", options.Ttl);
            Console.WriteLine ("Don't fragment: {0}", options.DontFragment);

            // Send the ping asynchronously.
            // Use the waiter as the user token.
            // When the callback completes, it can wake up this thread.
            pingSender.SendAsync(who, timeout, buffer, options, waiter);

            // Prevent this example application from ending.
            // A real application should do something useful
            // when possible.
            waiter.WaitOne ();
            Console.WriteLine ("Ping example completed.");
        }

        private static void PingCompletedCallback (object sender, PingCompletedEventArgs e)
        {
            // If the operation was canceled, display a message to the user.
            if (e.Cancelled)
            {
                Console.WriteLine ("Ping canceled.");

                // Let the main thread resume.
                // UserToken is the AutoResetEvent object that the main thread
                // is waiting for.
                ((AutoResetEvent)e.UserState).Set ();
            }

            // If an error occurred, display the exception to the user.
            if (e.Error != null)
            {
                Console.WriteLine ("Ping failed:");
                Console.WriteLine (e.Error.ToString ());

                // Let the main thread resume.
                ((AutoResetEvent)e.UserState).Set();
            }

            PingReply reply = e.Reply;

            DisplayReply (reply);

            // Let the main thread resume.
            ((AutoResetEvent)e.UserState).Set();
        }

        public static void DisplayReply (PingReply reply)
        {
            if (reply == null)
                return;

            Console.WriteLine ("ping status: {0}", reply.Status);
            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);
            }
        }
    }
}

Poznámky

Aplikace používají Ping třídu ke zjištění, jestli je vzdálený počítač dostupný.

Topologie sítě může určit, jestli Ping se může úspěšně spojit se vzdáleným hostitelem. Přítomnost a konfigurace proxy serverů, zařízení překladu síťových adres (NAT) nebo bran firewall může zabránit Ping úspěšnému provedení. Úspěšné Ping označení znamená, že vzdálený hostitel je dostupný v síti. Přítomnost služeb vyšší úrovně (například webového serveru) na vzdáleném hostiteli není zaručená.

Tato třída poskytuje funkce podobné nástroji příkazového řádku Ping.exe. SendAsync Metody Send odesílají zprávu o odezvě protokolu ICMP (Internet Control Message Protocol) vzdálenému počítači a čekají na odpověď odezvy PROTOKOLU ICMP z tohoto počítače. Podrobný popis zpráv ICMP naleznete v dokumentu RFC 792, který je k dispozici na adrese https://www.ietf.org.

Následující typy se používají s Ping třídou a jsou podrobně popsány níže.

Název typu	Description
IPStatus	Definuje stavové kódy, které popisují výsledek zprávy žádosti o odezvu ICMP.
PingOptions	Umožňuje nakonfigurovat nebo načíst nastavení, která řídí, kolikrát může být paket požadavku předán (Ttl) a zda může být fragmentován (DontFragment ).
PingReply	Obsahuje výsledky žádosti o odezvu ICMP.
PingException	Vyvolá se, pokud dojde k neopravitelné chybě.
PingCompletedEventArgs	Obsahuje data přidružená k událostem PingCompleted , které jsou vyvolány při SendAsync dokončení nebo zrušení volání.
PingCompletedEventHandler	Delegát, který poskytuje metodu zpětného volání vyvolána při SendAsync dokončení nebo zrušení volání.

Metody Send vrátí SendAsync odpověď v objektu PingReply . Vlastnost PingReply.Status vrátí IPStatus hodnotu, která označuje výsledek požadavku.

Při odesílání požadavku musíte zadat vzdálený počítač. Můžete to provést zadáním řetězce názvu hostitele, IP adresy ve formátu řetězce nebo objektu IPAddress .

Můžete také zadat libovolný z následujících typů informací:

• Data, která se mají připojit k žádosti. Určení buffer umožňuje zjistit dobu potřebnou k přenosu paketu určité velikosti do vzdáleného hostitele a z vzdáleného hostitele a maximální přenosové jednotky síťové cesty. (Viz Send nebo SendAsync přetížení, které přebírají buffer parametr.)

• Jestli se paket ICMP Echo dá během přenosu fragmentovat. (Viz DontFragment vlastnost a SendSendAsync přetížení, které přebírají options parametr.)

• Kolikrát můžou uzly směrování, jako jsou směrovače nebo brány, předávat paket před tím, než dorazí do cílového počítače, nebo se zahodí. (Viz Ttl a SendSendAsync přetížení, které přebírají options parametr.)

• Časový limit, ve kterém musí být odpověď přijata. (Viz Send nebo SendAsync přetížení, které přebírají timeout parametr.

Třída Ping nabízí synchronní i asynchronní metody pro odeslání požadavku. Pokud by vaše aplikace měla blokovat při čekání na odpověď, použijte Send metody; tyto metody jsou synchronní. Pokud by vaše aplikace neměla blokovat, použijte asynchronní SendAsync metody. Volání, které se SendAsync provede ve vlastním vlákně, které se automaticky přidělí z fondu vláken. Po dokončení PingCompleted asynchronní operace vyvolá událost. Aplikace používají PingCompletedEventHandler delegáta k určení metody, která se volá pro PingCompleted události. Před voláním PingCompletedEventHandlerSendAsyncmusíte do události přidat delegáta . Metoda delegáta PingCompletedEventArgs obdrží objekt, který obsahuje PingReply objekt, který popisuje výsledek SendAsync volání.

Stejnou instanci Ping třídy nelze použít k vygenerování více souběžných požadavků ICMP Echo. Volání Send během probíhajícího SendAsync hovoru nebo volání SendAsync několikrát předtím, než se dokončí všechna předchozí volání, způsobí chybu InvalidOperationException.

Konstruktory

Name	Description
Ping()	Inicializuje novou instanci Ping třídy.

Vlastnosti

Name	Description
CanRaiseEvents	Získá hodnotu určující, zda komponenta může vyvolat událost. (Zděděno od Component)
Container	Získá ten IContainer , který obsahuje Component. (Zděděno od Component)
DesignMode	Získá hodnotu, která označuje, zda Component je aktuálně v režimu návrhu. (Zděděno od Component)
Events	Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component. (Zděděno od Component)
Site	Získá nebo nastaví ISite .Component (Zděděno od Component)

Metody

Name	Description
Dispose()	Uvolní všechny prostředky používané nástrojem Component. (Zděděno od Component)
Dispose(Boolean)	Uvolní nespravované prostředky používané objektem Ping a volitelně odstraní spravované prostředky.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetLifetimeService()	Zastaralé. Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetService(Type)	Vrátí objekt, který představuje službu poskytovanou objektem Component nebo jeho Container. (Zděděno od Component)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Zastaralé. Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
OnPingCompleted(PingCompletedEventArgs)	PingCompleted Vyvolá událost.
Send(IPAddress, Int32, Byte[], PingOptions)	Pokusí se odeslat zprávu o odezvě protokolu ICMP (Internet Control Message Protocol) se zadanou vyrovnávací pamětí dat do počítače, který má zadanou IPAddress zprávu a obdrží odpovídající zprávu odezvy ICMP z daného počítače. Toto přetížení umožňuje zadat hodnotu časového limitu pro operaci a řídit fragmentaci a hodnoty Time-to-Live pro paket zpráv odezvy ICMP.
Send(IPAddress, Int32, Byte[])	Pokusí se odeslat zprávu o odezvě protokolu ICMP (Internet Control Message Protocol) se zadanou vyrovnávací pamětí dat do počítače, který má zadanou IPAddressodpověď , a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače. Toto přetížení umožňuje zadat hodnotu časového limitu operace.
Send(IPAddress, Int32)	Pokusí se odeslat zprávu o odezvě protokolu ICMP (Internet Control Message Protocol) se zadanou vyrovnávací pamětí dat do počítače, který má zadanou IPAddressodpověď , a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače. Tato metoda umožňuje zadat hodnotu časového limitu operace.
Send(IPAddress, TimeSpan, Byte[], PingOptions)	Pokusí se odeslat zprávu o odezvě protokolu ICMP (Internet Control Message Protocol) počítači se zadaným IPAddressprotokolem a přijmout odpovídající zprávu odpovědi ICMP z tohoto počítače.
Send(IPAddress)	Pokusí se odeslat zprávu o odezvě protokolu ICMP (Internet Control Message Protocol) počítači se zadaným IPAddresskódem a obdrží odpovídající zprávu odpovědi ICMP z tohoto počítače.
Send(String, Int32, Byte[], PingOptions)	Pokusí se odeslat zprávu o odezvě protokolu ICMP (Internet Control Message Protocol) se zadanou vyrovnávací pamětí dat do zadaného počítače a obdrží odpovídající zprávu odpovědi ICMP z tohoto počítače. Toto přetížení umožňuje zadat hodnotu časového limitu pro operaci a řídit fragmentaci a hodnoty Time-to-Live pro paket ICMP.
Send(String, Int32, Byte[])	Pokusí se odeslat zprávu o odezvě protokolu ICMP (Internet Control Message Protocol) se zadanou vyrovnávací pamětí dat do zadaného počítače a obdrží odpovídající zprávu odpovědi ICMP z tohoto počítače. Toto přetížení umožňuje zadat hodnotu časového limitu operace.
Send(String, Int32)	Pokusí se odeslat zprávu o odezvě protokolu ICMP (Internet Control Message Protocol) do zadaného počítače a obdrží odpovídající zprávu odpovědi ICMP z tohoto počítače. Tato metoda umožňuje zadat hodnotu časového limitu operace.
Send(String, TimeSpan, Byte[], PingOptions)	Pokusí se odeslat zprávu o odezvě protokolu ICMP (Internet Control Message Protocol) do zadaného počítače a přijmout odpovídající zprávu odezvy ICMP z tohoto počítače.
Send(String)	Pokusí se odeslat zprávu o odezvě protokolu ICMP (Internet Control Message Protocol) do zadaného počítače a obdrží odpovídající zprávu odpovědi ICMP z tohoto počítače.
SendAsync(IPAddress, Int32, Byte[], Object)	Asynchronně se pokusí odeslat zprávu odezvy protokolu ICMP (Internet Control Message Protocol) se zadanou datovou vyrovnávací pamětí do počítače, který má zadaný IPAddress, a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače. Toto přetížení umožňuje zadat hodnotu časového limitu operace.
SendAsync(IPAddress, Int32, Byte[], PingOptions, Object)	Asynchronně se pokusí odeslat zprávu odezvy protokolu ICMP (Internet Control Message Protocol) se zadanou datovou vyrovnávací pamětí do počítače, který má zadaný IPAddress, a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače. Toto přetížení umožňuje zadat hodnotu časového limitu pro operaci a řídit fragmentaci a hodnoty Time-to-Live pro paket zpráv odezvy ICMP.
SendAsync(IPAddress, Int32, Object)	Asynchronně se pokusí odeslat zprávu o odezvě protokolu ICMP (Internet Control Message Protocol) počítači, který má zadanou IPAddressodpověď , a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače. Toto přetížení umožňuje zadat hodnotu časového limitu operace.
SendAsync(IPAddress, Object)	Asynchronně se pokusí odeslat zprávu o odezvě protokolu ICMP (Internet Control Message Protocol) počítači, který má zadanou IPAddressodpověď , a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače.
SendAsync(String, Int32, Byte[], Object)	Asynchronně se pokusí odeslat zprávu o odezvě protokolu ICMP (Internet Control Message Protocol) se zadanou vyrovnávací pamětí dat do zadaného počítače a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače. Toto přetížení umožňuje zadat hodnotu časového limitu operace.
SendAsync(String, Int32, Byte[], PingOptions, Object)	Asynchronně se pokusí odeslat zprávu o odezvě protokolu ICMP (Internet Control Message Protocol) se zadanou vyrovnávací pamětí dat do zadaného počítače a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače. Toto přetížení umožňuje zadat hodnotu časového limitu pro operaci a řídit fragmentaci a hodnoty Time-to-Live pro paket ICMP.
SendAsync(String, Int32, Object)	Asynchronně se pokusí odeslat zprávu o odezvě protokolu ICMP (Internet Control Message Protocol) do zadaného počítače a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače. Toto přetížení umožňuje zadat hodnotu časového limitu operace.
SendAsync(String, Object)	Asynchronně se pokusí odeslat zprávu o odezvě protokolu ICMP (Internet Control Message Protocol) do zadaného počítače a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače.
SendAsyncCancel()	Zruší všechny nevyřízené asynchronní požadavky na odeslání ozvěny protokolu ICMP (Internet Control Message Protocol) a obdrží odpovídající zprávu odezvy ICMP.
SendPingAsync(IPAddress, Int32, Byte[], PingOptions)	Odešle zprávu protokolu ICMP (Internet Control Message Protocol) se zadanou vyrovnávací pamětí dat do počítače, který má zadanou IPAddressodpověď , a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače jako asynchronní operace. Toto přetížení umožňuje zadat hodnotu časového limitu pro operaci, vyrovnávací paměť, která se má použít pro odesílání a příjem, a řídit fragmentaci a hodnoty Time-to-Live pro paket zpráv odezvy PROTOKOLU ICMP.
SendPingAsync(IPAddress, Int32, Byte[])	Odešle zprávu s odezvou protokolu ICMP (Internet Control Message Protocol) se zadanou vyrovnávací pamětí dat do počítače, který má zadanou IPAddressodpověď , a obdrží odpovídající zprávu odpovědi ICMP z tohoto počítače jako asynchronní operace. Toto přetížení umožňuje zadat hodnotu časového limitu pro operaci a vyrovnávací paměť, která se má použít pro odesílání a přijímání.
SendPingAsync(IPAddress, Int32)	Odešle zprávu s odezvou protokolu ICMP (Internet Control Message Protocol) se zadanou vyrovnávací pamětí dat do počítače, který má zadanou IPAddressodpověď , a obdrží odpovídající zprávu odpovědi ICMP z tohoto počítače jako asynchronní operace. Toto přetížení umožňuje zadat hodnotu časového limitu operace.
SendPingAsync(IPAddress, TimeSpan, Byte[], PingOptions, CancellationToken)	Odešle zprávu protokolu ICMP (Internet Control Message Protocol) se zadanou vyrovnávací pamětí dat do počítače, který má zadanou IPAddressodpověď , a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače jako asynchronní operace. Toto přetížení umožňuje zadat hodnotu časového limitu pro operaci, vyrovnávací paměť, která se má použít pro odesílání a přijímání, řízení fragmentace a hodnoty Time-to-Live a CancellationToken paket zprávy odezvy PROTOKOLU ICMP.
SendPingAsync(IPAddress)	Odešle zprávu s odezvou protokolu ICMP (Internet Control Message Protocol) se zadanou vyrovnávací pamětí dat do počítače, který má zadanou IPAddressodpověď , a obdrží odpovídající zprávu odpovědi ICMP z tohoto počítače jako asynchronní operace.
SendPingAsync(String, Int32, Byte[], PingOptions)	Odešle zprávu o odezvě protokolu ICMP (Internet Control Message Protocol) se zadanou vyrovnávací pamětí dat do zadaného počítače a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače jako asynchronní operaci. Toto přetížení umožňuje zadat hodnotu časového limitu pro operaci, vyrovnávací paměť, která se má použít pro odesílání a příjem, a řídit fragmentaci a hodnoty Time-to-Live pro paket zpráv odezvy PROTOKOLU ICMP.
SendPingAsync(String, Int32, Byte[])	Odešle zprávu o odezvě protokolu ICMP (Internet Control Message Protocol) se zadanou vyrovnávací pamětí dat do zadaného počítače a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače jako asynchronní operaci. Toto přetížení umožňuje zadat hodnotu časového limitu pro operaci a vyrovnávací paměť, která se má použít pro odesílání a přijímání.
SendPingAsync(String, Int32)	Odešle zprávu o odezvě protokolu ICMP (Internet Control Message Protocol) se zadanou vyrovnávací pamětí dat do zadaného počítače a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače jako asynchronní operaci. Toto přetížení umožňuje zadat hodnotu časového limitu operace.
SendPingAsync(String, TimeSpan, Byte[], PingOptions, CancellationToken)	Odešle zprávu protokolu ICMP (Internet Control Message Protocol) se zadanou vyrovnávací pamětí dat do zadaného počítače a přijme odpovídající zprávu odpovědi ICMP z tohoto počítače jako asynchronní operace. Toto přetížení umožňuje zadat hodnotu časového limitu pro operaci, vyrovnávací paměť, která se má použít pro odesílání a přijímání, řízení fragmentace a hodnoty Time-to-Live a CancellationToken paket zprávy odezvy PROTOKOLU ICMP.
SendPingAsync(String)	Odešle zprávu o odezvě protokolu ICMP (Internet Control Message Protocol) se zadanou vyrovnávací pamětí dat do zadaného počítače a obdrží odpovídající zprávu odezvy ICMP z tohoto počítače jako asynchronní operaci.
ToString()	String Vrátí hodnotu obsahující název Component, pokud existuje. Tato metoda by neměla být přepsána. (Zděděno od Component)

Událost

Name	Description
Disposed	Nastane, když komponenta je uvolněna voláním Dispose() metody. (Zděděno od Component)
PingCompleted	Nastane, když asynchronní operace odeslat zprávu odezvy protokolu ICMP (Internet Control Message Protocol) a obdrží odpovídající zprávu odezvy ICMP dokončena nebo je zrušena.

Viz také

• Postupy: Ping na hostitele
• Programování v síti v rozhraní .NET Framework
• Ukázky programování sítě
• NetworkInformation