Ping.Send Metod

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

Parametrar

Returer

Ett PingReply objekt som innehåller information om ICMP-ekosvarsmeddelandet, om ett har tagits emot eller beskriver orsaken till felet om inget meddelande togs emot.

Undantag

Exempel

Följande kodexempel visar hur du anropar den här metoden.

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

Kommentarer

Den här metoden skickar till värden som anges av address en 32-databuffert Byte med ICMP-ekomeddelandet. Metoden väntar fem sekunder på ett ICMP-ekosvarsmeddelande. Om det inte får något svar under den tiden returnerar metoden och egenskapen Status är inställd på TimedOut.

Den här överlagringen använder standardinställningarna för paketfragmentering och vidarebefordran av paket. Paketet som innehåller ICMP-ekomeddelandet kan fragmenteras under överföring om den totala paketstorleken överskrider den maximala paketstorlek som kan överföras av en av routningsnoderna mellan de lokala datorerna och fjärrdatorerna. För att förhindra fragmentering använder du en av metoderna Send som tar en options parameter och anger DontFragment egenskapen till true. När DontFragment är true och den totala paketstorleken överskrider den maximala paketstorlek som kan överföras av en av routningsnoderna mellan de lokala datorerna och fjärrdatorerna misslyckas ICMP-ekobegäran. När detta händer är inställt på StatusPacketTooBig. Paket- eller paketfragmenten (om de är fragmenterade) kan vidarebefordras genom routning av noder 128 gånger innan de tas bort. Om du vill ändra den här inställningen använder du en Send överlagring som tar en options parameter och anger Ttl egenskapen till önskat värde. Om paketet inte når sitt mål när det har vidarebefordrats det angivna antalet gånger ignoreras paketet och ICMP-ekobegäran misslyckas. När detta händer är inställt på StatusTtlExpired.

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

Parametrar

Returer

Ett PingReply objekt som innehåller information om ICMP-ekosvarsmeddelandet, om ett har tagits emot eller anger orsaken till felet, om inget meddelande togs emot.

Undantag

Exempel

Följande kodexempel visar hur du anropar den här metoden.

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

Kommentarer

Den här metoden skickar en 32-databuffert Byte med ICMP-ekomeddelandet. Metoden väntar fem sekunder på ett ICMP-ekosvarsmeddelande. Om det inte får något svar under den tiden returnerar metoden och egenskapen Status är inställd på TimedOut.

Den här överlagringen använder standardinställningarna för paketfragmentering och vidarebefordran av paket. Paketet som innehåller ICMP-ekomeddelandet kan fragmenteras under överföring om den totala paketstorleken överskrider den maximala paketstorlek som kan överföras av en av routningsnoderna mellan de lokala datorerna och fjärrdatorerna. För att förhindra fragmentering använder du en av metoderna Send som tar en options parameter och anger DontFragment egenskapen till true. När DontFragment är true och den totala paketstorleken överskrider den maximala paketstorlek som kan överföras av en av routningsnoderna mellan de lokala datorerna och fjärrdatorerna misslyckas ICMP-ekobegäran. När detta händer är inställt på StatusPacketTooBig. Paket- eller paketfragmenten (om de är fragmenterade) kan vidarebefordras genom routning av noder 128 gånger innan de tas bort. Om du vill ändra den här inställningen använder du en Send överlagring som tar en options parameter och anger Ttl egenskapen till önskat värde. Om paketet inte når sitt mål när det har vidarebefordrats det angivna antalet gånger ignoreras paketet och ICMP-ekobegäran misslyckas. När detta händer är inställt på StatusTtlExpired.

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

Parametrar

Returer

Ett PingReply objekt som innehåller information om ICMP-ekosvarsmeddelandet om ett har tagits emot, eller som anger orsaken till felet om inget meddelande togs emot.

Undantag

Exempel

Ett exempel som visar hur du anropar en Send metod finns i klassöversikten Ping .

Kommentarer

Om ICMP-ekosvarsmeddelandet inte tas emot inom den tid som anges i parametern timeout misslyckas ICMP-ekot och Status egenskapen är inställd på TimedOut.

Den här överlagringen använder standardinställningarna för paketfragmentering och vidarebefordran av paket. Paketet som innehåller ICMP-ekomeddelandet kan fragmenteras under överföring om den totala paketstorleken överskrider den maximala paketstorlek som kan överföras av en av routningsnoderna mellan de lokala datorerna och fjärrdatorerna. För att förhindra fragmentering använder du en av metoderna Send som tar en options parameter och anger DontFragment egenskapen till true. När DontFragment är true och den totala paketstorleken överskrider den maximala paketstorlek som kan överföras av en av routningsnoderna mellan de lokala datorerna och fjärrdatorerna misslyckas ICMP-ekobegäran. När detta händer är inställt på StatusPacketTooBig.

Paket- eller paketfragmenten kan vidarebefordras av routningsnoder 128 gånger innan de tas bort. Om du vill ändra den här inställningen använder du en Send överlagring som tar en options parameter och anger Ttl egenskapen till önskat värde. Om paketet inte når sitt mål när det har vidarebefordrats det angivna antalet gånger ignoreras paketet och ICMP-ekobegäran misslyckas. När detta händer är inställt på StatusTtlExpired.

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

Parametrar

Returer

Ett PingReply objekt som innehåller information om ICMP-ekosvarsmeddelandet om ett har tagits emot, eller som anger orsaken till felet om inget meddelande togs emot.

Undantag

Exempel

Ett exempel som visar hur du anropar en Send metod finns i klassöversikten Ping .

Kommentarer

Om ICMP-ekosvarsmeddelandet inte tas emot inom den tid som anges i parametern timeout misslyckas ICMP-ekot och Status egenskapen är inställd på TimedOut.

Den här överlagringen använder standardinställningarna för paketfragmentering och vidarebefordran av paket. Paketet som innehåller ICMP-ekomeddelandet kan fragmenteras under överföring om den totala paketstorleken överskrider den maximala paketstorlek som kan överföras av en av routningsnoderna mellan de lokala datorerna och fjärrdatorerna. För att förhindra fragmentering använder du en av metoderna Send som tar en options parameter och anger DontFragment egenskapen till true. När DontFragment är true och den totala paketstorleken överskrider den maximala paketstorlek som kan överföras av en av routningsnoderna mellan de lokala datorerna och fjärrdatorerna misslyckas ICMP-ekobegäran. När detta händer är inställt på StatusPacketTooBig. Paket- eller paketfragmenten (om de är fragmenterade) kan vidarebefordras genom routning av noder 128 gånger innan de tas bort. Om du vill ändra den här inställningen använder du en Send överlagring som tar en options parameter och anger Ttl egenskapen till önskat värde. Om paketet inte når sitt mål när det har vidarebefordrats det angivna antalet gånger ignoreras paketet och ICMP-ekobegäran misslyckas. När detta händer är inställt på StatusTtlExpired.

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

Parametrar

Returer

Ett PingReply objekt som innehåller information om ICMP-ekosvarsmeddelandet, om ett har tagits emot eller anger orsaken till felet, om inget meddelande togs emot. Metoden returneras PacketTooBig om paketet överskrider MTU (Maximum Transmission Unit).

Undantag

Exempel

I följande kodexempel visas hur du anropar den här metoden.

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

Kommentarer

Om ICMP-ekosvarsmeddelandet inte tas emot inom den tid som anges i parametern timeout misslyckas ICMP-ekot och Status egenskapen är inställd på TimedOut.

Den här överlagringen använder standardinställningarna för paketfragmentering och vidarebefordran av paket. Paketet som innehåller ICMP-ekomeddelandet kan fragmenteras under överföring om den totala paketstorleken överskrider den maximala paketstorlek som kan överföras av en av routningsnoderna mellan de lokala datorerna och fjärrdatorerna. För att förhindra fragmentering använder du en av metoderna Send som tar en options parameter och anger DontFragment egenskapen till true. När DontFragment är true och den totala paketstorleken överskrider den maximala paketstorlek som kan överföras av en av routningsnoderna mellan de lokala datorerna och fjärrdatorerna misslyckas ICMP-ekobegäran. När detta händer är inställt på StatusPacketTooBig.

Paket- eller paketfragmenten kan vidarebefordras av routningsnoder 128 gånger innan de tas bort. Om du vill ändra den här inställningen använder du en Send överlagring som tar en options parameter och anger Ttl egenskapen till önskat värde. Om paketet inte når sitt mål när det har vidarebefordrats det angivna antalet gånger ignoreras paketet och ICMP-ekobegäran misslyckas. När detta händer är inställt på StatusTtlExpired.

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

Parametrar

Returer

Ett PingReply objekt som innehåller information om ICMP-ekosvarsmeddelandet om ett har tagits emot, eller som anger orsaken till felet om inget meddelande togs emot.

Undantag

Exempel

Ett exempel som visar hur du anropar en Send överlagring finns i klassöversikten Ping .

Kommentarer

Om ICMP-ekosvarsmeddelandet inte tas emot inom den tid som anges i parametern timeout misslyckas ICMP-ekot och Status egenskapen är inställd på TimedOut.

Den här överlagringen använder standardinställningarna för paketfragmentering och vidarebefordran av paket. Paketet som innehåller ICMP-ekomeddelandet kan fragmenteras under överföring om den totala paketstorleken överskrider den maximala paketstorlek som kan överföras av en av routningsnoderna mellan de lokala datorerna och fjärrdatorerna. För att förhindra fragmentering använder du en av metoderna Send som tar en options parameter och anger DontFragment egenskapen till true. När DontFragment är true och den totala paketstorleken överskrider den maximala paketstorlek som kan överföras av en av routningsnoderna mellan de lokala datorerna och fjärrdatorerna misslyckas ICMP-ekobegäran. När detta händer är inställt på StatusPacketTooBig.

Paket- eller paketfragmenten kan vidarebefordras av routningsnoder 128 gånger innan de tas bort. Om du vill ändra den här inställningen använder du en Send överlagring som tar en options parameter och anger Ttl egenskapen till önskat värde. Om paketet inte når sitt mål när det har vidarebefordrats det angivna antalet gånger ignoreras paketet och ICMP-ekobegäran misslyckas. När detta händer är inställt på StatusTtlExpired.

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

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

Parametrar

Returer

Ett PingReply objekt som innehåller information om ICMP-ekosvarsmeddelandet, om ett har tagits emot eller anger orsaken till felet, om inget meddelande togs emot. Metoden returneras PacketTooBig om paketet överskrider MTU (Maximum Transmission Unit).

Undantag

Exempel

I följande kodexempel visas hur du anropar den här metoden.

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

Kommentarer

Om ICMP-ekosvarsmeddelandet inte tas emot inom den tid som anges av parametern timeout misslyckas ICMP-ekot och Status egenskapen är inställd på TimedOut.

DontFragment Om egenskapen är true och den totala paketstorleken överskrider den maximala paketstorlek som kan överföras av en av routningsnoderna mellan de lokala datorerna och fjärrdatorerna misslyckas ICMP-ekobegäran. När detta händer är inställt på StatusPacketTooBig.

Använd egenskapen Ttl för att ange det maximala antalet gånger som ICMP-ekomeddelandet kan vidarebefordras innan det når målet. Om paketet inte når sitt mål när det har vidarebefordrats det angivna antalet gånger ignoreras paketet och ICMP-ekobegäran misslyckas. När detta händer är inställt på StatusTtlExpired.

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

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

Parametrar

Returer

Ett PingReply objekt som innehåller information om ICMP-ekosvarsmeddelandet om ett har tagits emot, eller som anger orsaken till felet om inget meddelande togs emot.

Undantag

Exempel

I följande kodexempel visas hur du anropar den här metoden.

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

Kommentarer

Om ICMP-ekosvarsmeddelandet inte tas emot inom den tid som anges av parametern timeout misslyckas ICMP-ekot och Status egenskapen är inställd på TimedOut.

DontFragment Om egenskapen är true och den totala paketstorleken överskrider den maximala paketstorlek som kan överföras av en av routningsnoderna mellan de lokala datorerna och fjärrdatorerna misslyckas ICMP-ekobegäran. När detta händer är inställt på StatusPacketTooBig.

Använd egenskapen Ttl för att ange det maximala antalet gånger som ICMP-ekomeddelandet kan vidarebefordras innan det når målet. Om paketet inte når sitt mål när det har vidarebefordrats det angivna antalet gånger ignoreras paketet och ICMP-ekobegäran misslyckas. När detta händer är inställt på StatusTtlExpired.