Ping.SendAsync Methode

public:
 void SendAsync(System::String ^ hostNameOrAddress, int timeout, cli::array <System::Byte> ^ buffer, System::Net::NetworkInformation::PingOptions ^ options, System::Object ^ userToken);

public void SendAsync(string hostNameOrAddress, int timeout, byte[] buffer, System.Net.NetworkInformation.PingOptions options, object userToken);

member this.SendAsync : string * int * byte[] * System.Net.NetworkInformation.PingOptions * obj -> unit

Public Sub SendAsync (hostNameOrAddress As String, timeout As Integer, buffer As Byte(), options As PingOptions, userToken As Object)

Parameters

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u deze methode aanroept.

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

Opmerkingen

De SendAsync methode verzendt het echobericht asynchroon en retourneert de status naar uw toepassing wanneer de bewerking is voltooid (geslaagd of mislukt). Roep de SendAsync methode aan wanneer uw toepassing niet mag worden geblokkeerd. Elke aanroep wordt uitgevoerd in een afzonderlijke thread die automatisch wordt toegewezen vanuit de threadgroep. Wanneer de asynchrone bewerking is voltooid, wordt de PingCompleted gebeurtenis gegenereerd. Toepassingen gebruiken een PingCompletedEventHandler gemachtigde om de methode op te geven die wordt aangeroepen wanneer SendAsync de gebeurtenis wordt gegenereerd. U moet een PingCompletedEventHandler gemachtigde toevoegen aan de gebeurtenis voordat u aanroept SendAsync. De methode van de gemachtigde ontvangt een PingCompletedEventArgs object dat een PingReply object bevat dat het resultaat van de SendAsync aanroep beschrijft. Het PingCompletedEventArgs object neemt de UserState eigenschap over. Deze eigenschap bevat het userToken object dat is doorgegeven aan de SendAsync aanroep.

Als uw toepassing moet blokkeren tijdens het wachten op een antwoord, gebruikt u de Send methoden. Deze methoden zijn synchroon.

Als het ICMP-echoantwoordbericht niet wordt ontvangen binnen de tijd die is opgegeven door de timeout parameter, mislukt de ICMP-echo en wordt de Status eigenschap ingesteld op TimedOut.

Als de DontFragment eigenschap is true en de totale pakketgrootte de maximale pakketgrootte overschrijdt die kan worden verzonden door een van de routeringsknooppunten tussen de lokale en externe computers, mislukt de ICMP-echoaanvraag. Als dit gebeurt, is de Status optie ingesteld op PacketTooBig.

Gebruik de Ttl eigenschap om het maximum aantal keren op te geven dat het ICMP-echobericht kan worden doorgestuurd voordat het de bestemming bereikt. Als het pakket de bestemming niet bereikt nadat het opgegeven aantal keren is doorgestuurd, wordt het pakket verwijderd en mislukt de ICMP-echoaanvraag. Als dit gebeurt, is de Status optie ingesteld op TtlExpired.

public:
 void SendAsync(System::Net::IPAddress ^ address, int timeout, cli::array <System::Byte> ^ buffer, System::Net::NetworkInformation::PingOptions ^ options, System::Object ^ userToken);

public void SendAsync(System.Net.IPAddress address, int timeout, byte[] buffer, System.Net.NetworkInformation.PingOptions options, object userToken);

member this.SendAsync : System.Net.IPAddress * int * byte[] * System.Net.NetworkInformation.PingOptions * obj -> unit

Public Sub SendAsync (address As IPAddress, timeout As Integer, buffer As Byte(), options As PingOptions, userToken As Object)

Parameters

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u deze methode aanroept. Zie de voorbeeldsectie overbelasting van de methode voor overbelasting van de methode voor een implementatie van de SendAsync callback-methode.

Voor het volgende codevoorbeeld zijn de volgende naamruimten vereist:

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

In het volgende codevoorbeeld wordt asynchroon een ICMP-echobericht verzonden.

public static void AsyncComplexLocalPing ()
{
    // Get an object that will block the main thread.
    AutoResetEvent waiter = new AutoResetEvent (false);

    // Ping's the local machine.
    Ping pingSender = new Ping ();

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

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

    // Send the ping asynchronously.
    // Use the waiter as the user token.
    // When the callback completes, it can wake up this thread.
    pingSender.SendAsync (address, 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.");
}

Opmerkingen

De SendAsync methode verzendt het echobericht asynchroon en retourneert de status naar uw toepassing wanneer de bewerking is voltooid (geslaagd of mislukt). Roep de SendAsync methode aan wanneer uw toepassing niet mag worden geblokkeerd. Elke aanroep wordt uitgevoerd in een afzonderlijke thread die automatisch wordt toegewezen vanuit de threadgroep. Wanneer de asynchrone bewerking is voltooid, wordt de PingCompleted gebeurtenis gegenereerd. Toepassingen gebruiken een PingCompletedEventHandler gemachtigde om de methode op te geven die wordt aangeroepen wanneer SendAsync de gebeurtenis wordt gegenereerd. U moet een PingCompletedEventHandler gemachtigde toevoegen aan de gebeurtenis voordat u aanroept SendAsync. De methode van de gemachtigde ontvangt een PingCompletedEventArgs object dat een PingReply object bevat dat het resultaat van de SendAsync aanroep beschrijft. Het PingCompletedEventArgs object neemt de UserState eigenschap over. Deze eigenschap bevat het userToken object dat is doorgegeven aan de SendAsync aanroep.

Als uw toepassing blokkeert tijdens het wachten op een antwoord, gebruikt u de Send methoden. Deze methoden zijn synchroon.

Als het ICMP-echoantwoordbericht niet wordt ontvangen binnen de tijd die is opgegeven door de timeout parameter, mislukt de ICMP-echo en wordt de Status eigenschap ingesteld op TimedOut.

Als de DontFragment eigenschap is true en de totale pakketgrootte de maximale pakketgrootte overschrijdt die kan worden verzonden door een van de routeringsknooppunten tussen de lokale en externe computers, mislukt de ICMP-echoaanvraag. Als dit gebeurt, is de Status optie ingesteld op PacketTooBig.

Gebruik de Ttl eigenschap om het maximum aantal keren op te geven dat het ICMP-echobericht kan worden doorgestuurd voordat het de bestemming bereikt. Als het pakket de bestemming niet bereikt nadat het opgegeven aantal keren is doorgestuurd, wordt het pakket verwijderd en mislukt de ICMP-echoaanvraag. Als dit gebeurt, is de Status optie ingesteld op TtlExpired.

public:
 void SendAsync(System::String ^ hostNameOrAddress, int timeout, cli::array <System::Byte> ^ buffer, System::Object ^ userToken);

public void SendAsync(string hostNameOrAddress, int timeout, byte[] buffer, object userToken);

member this.SendAsync : string * int * byte[] * obj -> unit

Public Sub SendAsync (hostNameOrAddress As String, timeout As Integer, buffer As Byte(), userToken As Object)

Parameters

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een SendAsync overbelasting aanroept. Zie het Ping klasseoverzicht.

Opmerkingen

De SendAsync methode verzendt het echobericht asynchroon en retourneert de status naar uw toepassing wanneer de bewerking is voltooid (geslaagd of mislukt). Roep de SendAsync methode aan wanneer uw toepassing niet mag worden geblokkeerd. Elke aanroep wordt uitgevoerd in een afzonderlijke thread die automatisch wordt toegewezen vanuit de threadgroep. Wanneer de asynchrone bewerking is voltooid, wordt de PingCompleted gebeurtenis gegenereerd. Toepassingen gebruiken een PingCompletedEventHandler gemachtigde om de methode op te geven die wordt aangeroepen wanneer SendAsync de gebeurtenis wordt gegenereerd. U moet een PingCompletedEventHandler gemachtigde toevoegen aan de gebeurtenis voordat u aanroept SendAsync. De methode van de gemachtigde ontvangt een PingCompletedEventArgs object met een PingReply object dat het resultaat van de SendAsync aanroep beschrijft. Het PingCompletedEventArgs object neemt de UserState eigenschap over. Deze eigenschap bevat het userToken object dat is doorgegeven aan de SendAsync aanroep.

Als uw toepassing moet blokkeren tijdens het wachten op een antwoord, gebruikt u de Send methoden. Deze methoden zijn synchroon.

Als het ICMP-echoantwoordbericht niet wordt ontvangen binnen de tijd die is opgegeven door de timeout parameter, mislukt de ICMP-echo en wordt de Status eigenschap ingesteld op TimedOut.

Deze overbelasting maakt gebruik van standaardinstellingen voor pakketfragmentatie en het doorsturen van pakketten. Het pakket dat het ICMP-echobericht bevat, kan tijdens de overdracht worden gefragmenteerd als de totale pakketgrootte groter is dan de maximale pakketgrootte die kan worden verzonden door een van de routeringsknooppunten tussen de lokale en externe computers. Als u fragmentatie wilt voorkomen, gebruikt u een van de SendAsync methoden die een options parameter gebruiken en stelt u de DontFragment eigenschap in op true. Wanneer DontFragment is true en de totale pakketgrootte de maximale pakketgrootte overschrijdt die kan worden verzonden door een van de routeringsknooppunten tussen de lokale en externe computers, mislukt de ICMP-echoaanvraag. Als dit gebeurt, is de Status optie ingesteld op PacketTooBig. Het pakket- of pakketfragmenten (indien gefragmenteerd) kunnen 128 keer worden doorgestuurd door routeringsknooppunten voordat ze worden verwijderd. Als u deze instelling wilt wijzigen, gebruikt u een SendAsync overbelasting die een options parameter gebruikt en stelt u de Ttl eigenschap in op de gewenste waarde. Als het pakket de bestemming niet bereikt nadat het opgegeven aantal keren is doorgestuurd, wordt het pakket verwijderd en mislukt de ICMP-echoaanvraag. Als dit gebeurt, is de Status optie ingesteld op TtlExpired.

public:
 void SendAsync(System::Net::IPAddress ^ address, int timeout, cli::array <System::Byte> ^ buffer, System::Object ^ userToken);

public void SendAsync(System.Net.IPAddress address, int timeout, byte[] buffer, object userToken);

member this.SendAsync : System.Net.IPAddress * int * byte[] * obj -> unit

Public Sub SendAsync (address As IPAddress, timeout As Integer, buffer As Byte(), userToken As Object)

Parameters

Uitzonderingen

Voorbeelden

Zie het Ping klasseoverzicht voor een codevoorbeeld waarin het aanroepen van een SendAsync overbelasting wordt gedemonstreert.

Opmerkingen

Met deze methode wordt het echobericht asynchroon verzonden en wordt de status geretourneerd naar uw toepassing wanneer de bewerking is voltooid (geslaagd of mislukt). Roep de SendAsync methode aan wanneer uw toepassing niet mag worden geblokkeerd. Elke aanroep wordt uitgevoerd in een afzonderlijke thread die automatisch wordt toegewezen vanuit de threadgroep. Wanneer de asynchrone bewerking is voltooid, wordt de PingCompleted gebeurtenis gegenereerd. Als u de methode wilt opgeven die wordt aangeroepen wanneer SendAsync de gebeurtenis wordt gegenereerd, moet u een PingCompletedEventHandler gemachtigde aan de gebeurtenis toevoegen voordat u aanroept SendAsync. De methode van de gemachtigde ontvangt een PingCompletedEventArgs object dat een PingReply object bevat dat het resultaat van de SendAsync aanroep beschrijft. Het PingCompletedEventArgs object neemt de UserState eigenschap over. Deze eigenschap bevat het userToken object dat is doorgegeven aan de SendAsync aanroep.

Als het ICMP-echoantwoordbericht niet wordt ontvangen binnen de tijd die is opgegeven door de timeout parameter, mislukt de ICMP-echo en wordt de Status eigenschap ingesteld op TimedOut.

Deze overbelasting maakt gebruik van standaardinstellingen voor pakketfragmentatie en het doorsturen van pakketten. Het pakket dat het ICMP-echobericht bevat, kan tijdens de overdracht worden gefragmenteerd als de totale pakketgrootte groter is dan de maximale pakketgrootte die kan worden verzonden door een van de routeringsknooppunten tussen de lokale en externe computers. Als u fragmentatie wilt voorkomen, gebruikt u een van de SendAsync methoden die een options parameter gebruiken en stelt u de DontFragment eigenschap in op true. Wanneer DontFragment is true en de totale pakketgrootte de maximale pakketgrootte overschrijdt die kan worden verzonden door een van de routeringsknooppunten tussen de lokale en externe computers, mislukt de ICMP-echoaanvraag. Als dit gebeurt, is de Status optie ingesteld op PacketTooBig. Het pakket- of pakketfragmenten (indien gefragmenteerd) kunnen 128 keer worden doorgestuurd door routeringsknooppunten voordat ze worden verwijderd. Als u deze instelling wilt wijzigen, gebruikt u een SendAsync overbelasting die een options parameter gebruikt en stelt u de Ttl eigenschap in op de gewenste waarde. Als het pakket de bestemming niet bereikt nadat het opgegeven aantal keren is doorgestuurd, wordt het pakket verwijderd en mislukt de ICMP-echoaanvraag. Als dit gebeurt, is de Status optie ingesteld op TtlExpired.

public:
 void SendAsync(System::Net::IPAddress ^ address, int timeout, System::Object ^ userToken);

public void SendAsync(System.Net.IPAddress address, int timeout, object userToken);

member this.SendAsync : System.Net.IPAddress * int * obj -> unit

Public Sub SendAsync (address As IPAddress, timeout As Integer, userToken As Object)

Parameters

Uitzonderingen

Voorbeelden

Zie het Ping klasseoverzicht voor een codevoorbeeld waarin het aanroepen van een SendAsync overbelasting wordt gedemonstreert.

Opmerkingen

De SendAsync methode verzendt het echobericht asynchroon en retourneert de status naar uw toepassing wanneer de bewerking is voltooid (geslaagd of mislukt). Roep de SendAsync methode aan wanneer uw toepassing niet mag worden geblokkeerd. Elke aanroep wordt uitgevoerd in een afzonderlijke thread die automatisch wordt toegewezen vanuit de threadgroep. Wanneer de asynchrone bewerking is voltooid, wordt de PingCompleted gebeurtenis gegenereerd. Toepassingen gebruiken een PingCompletedEventHandler gemachtigde om de methode op te geven die wordt aangeroepen wanneer SendAsync de gebeurtenis wordt gegenereerd. U moet een PingCompletedEventHandler gemachtigde toevoegen aan de gebeurtenis voordat u aanroept SendAsync. De methode van de gemachtigde ontvangt een PingCompletedEventArgs object dat een PingReply object bevat dat het resultaat van de SendAsync aanroep beschrijft. Het PingCompletedEventArgs object neemt de UserState eigenschap over. Deze eigenschap bevat het userToken object dat is doorgegeven aan de SendAsync aanroep.

Als uw toepassing moet blokkeren tijdens het wachten op een antwoord, gebruikt u de Send methoden. Deze methoden zijn synchroon.

Als het ICMP-echoantwoordbericht niet wordt ontvangen binnen de tijd die is opgegeven door de timeout parameter, mislukt de ICMP-echo en wordt de Status eigenschap ingesteld op TimedOut.

Deze overbelasting maakt gebruik van standaardinstellingen voor pakketfragmentatie en het doorsturen van pakketten. Het pakket dat het ICMP-echobericht bevat, kan tijdens de overdracht worden gefragmenteerd als de totale pakketgrootte groter is dan de maximale pakketgrootte die kan worden verzonden door een van de routeringsknooppunten tussen de lokale en externe computers. Als u fragmentatie wilt voorkomen, gebruikt u een van de SendAsync methoden die een options parameter gebruiken en stelt u de DontFragment eigenschap in op true. Wanneer DontFragment is true en de totale pakketgrootte de maximale pakketgrootte overschrijdt die kan worden verzonden door een van de routeringsknooppunten tussen de lokale en externe computers, mislukt de ICMP-echoaanvraag. Als dit gebeurt, is de Status optie ingesteld op PacketTooBig. Het pakket- of pakketfragmenten (indien gefragmenteerd) kunnen 128 keer worden doorgestuurd door routeringsknooppunten voordat ze worden verwijderd. Als u deze instelling wilt wijzigen, gebruikt u een SendAsync overbelasting die een options parameter gebruikt en stelt u de Ttl eigenschap in op de gewenste waarde. Als het pakket de bestemming niet bereikt nadat het opgegeven aantal keren is doorgestuurd, wordt het pakket verwijderd en mislukt de ICMP-echoaanvraag. Als dit gebeurt, is de Status optie ingesteld op TtlExpired.

public:
 void SendAsync(System::String ^ hostNameOrAddress, System::Object ^ userToken);

public void SendAsync(string hostNameOrAddress, object userToken);

member this.SendAsync : string * obj -> unit

Public Sub SendAsync (hostNameOrAddress As String, userToken As Object)

Parameters

Uitzonderingen

Voorbeelden

Zie het Ping klasseoverzicht voor een codevoorbeeld waarin het aanroepen van de SendAsync methode wordt gedemonstreert.

Opmerkingen

De SendAsync methode verzendt het echobericht asynchroon en retourneert, wanneer de bewerking is voltooid (geslaagd of mislukt), de status naar uw toepassing. Roep de SendAsync methode aan wanneer uw toepassing niet mag worden geblokkeerd. Elke aanroep naar deze methode wordt uitgevoerd in een afzonderlijke thread die automatisch wordt toegewezen vanuit de threadgroep. Wanneer de asynchrone bewerking is voltooid, wordt de PingCompleted gebeurtenis gegenereerd. Als u de methode wilt opgeven die wordt aangeroepen wanneer SendAsync de gebeurtenis wordt gegenereerd, moet u een PingCompletedEventHandler gemachtigde aan de gebeurtenis toevoegen voordat u aanroept SendAsync. De methode van de gemachtigde ontvangt een PingCompletedEventArgs object dat een PingReply object bevat dat het resultaat van de SendAsync aanroep beschrijft. Het PingCompletedEventArgs object neemt de UserState eigenschap over. Deze eigenschap bevat het userToken object dat is doorgegeven aan de SendAsync aanroep.

Met deze methode wordt een gegevensbuffer van 32 Byte verzonden met het ICMP-echobericht. De methode wacht vijf seconden voor een ICMP-echoantwoordbericht. Als er op dat moment geen antwoord wordt ontvangen, wordt de methode geretourneerd en wordt de Status eigenschap ingesteld op TimedOut.

Deze overbelasting maakt gebruik van standaardinstellingen voor pakketfragmentatie en het doorsturen van pakketten. Het pakket dat het ICMP-echobericht bevat, kan tijdens de overdracht worden gefragmenteerd als de totale pakketgrootte groter is dan de maximale pakketgrootte die kan worden verzonden door een van de routeringsknooppunten tussen de lokale en externe computers. Als u fragmentatie wilt voorkomen, gebruikt u een van de SendAsync methoden die een options parameter gebruiken en stelt u de DontFragment eigenschap in op true. Wanneer DontFragment is true en de totale pakketgrootte de maximale pakketgrootte overschrijdt die kan worden verzonden door een van de routeringsknooppunten tussen de lokale en externe computers, mislukt de ICMP-echoaanvraag. Als dit gebeurt, is de Status optie ingesteld op PacketTooBig.

Het pakket of pakketfragmenten kunnen 128 keer worden doorgestuurd door routeringsknooppunten voordat ze worden verwijderd. Als u deze instelling wilt wijzigen, gebruikt u een SendAsync overbelasting die een options parameter gebruikt en stelt u de Ttl eigenschap in op de gewenste waarde. Als het pakket de bestemming niet bereikt nadat het opgegeven aantal keren is doorgestuurd, wordt het pakket verwijderd en mislukt de ICMP-echoaanvraag. Als dit gebeurt, is de Status optie ingesteld op TtlExpired.

public:
 void SendAsync(System::Net::IPAddress ^ address, System::Object ^ userToken);

public void SendAsync(System.Net.IPAddress address, object userToken);

member this.SendAsync : System.Net.IPAddress * obj -> unit

Public Sub SendAsync (address As IPAddress, userToken As Object)

Parameters

Uitzonderingen

Voorbeelden

Zie het Ping klasseoverzicht voor een codevoorbeeld waarin het aanroepen van een SendAsync methode wordt gedemonstreert.

Opmerkingen

De SendAsync methode verzendt het echobericht asynchroon en retourneert, wanneer de bewerking is voltooid (geslaagd of mislukt), de status naar uw toepassing. Roep de SendAsync methode aan wanneer uw toepassing niet mag worden geblokkeerd. Elke aanroep naar deze methode wordt uitgevoerd in een afzonderlijke thread die automatisch wordt toegewezen vanuit de threadgroep. Wanneer de asynchrone bewerking is voltooid, wordt de PingCompleted gebeurtenis gegenereerd. Als u de methode wilt opgeven die wordt aangeroepen wanneer SendAsync de gebeurtenis wordt gegenereerd, moet u een PingCompletedEventHandler gemachtigde aan de gebeurtenis toevoegen voordat u aanroept SendAsync. De methode van de gemachtigde ontvangt een PingCompletedEventArgs object dat een PingReply object bevat dat het resultaat van de SendAsync aanroep beschrijft. Het PingCompletedEventArgs object neemt de UserState eigenschap over. Deze eigenschap bevat het userToken object dat is doorgegeven aan de SendAsync aanroep.

Met deze methode wordt een gegevensbuffer van 32 Byte verzonden met het ICMP-echobericht. De methode wacht vijf seconden voor een ICMP-echoantwoordbericht. Als er op dat moment geen antwoord wordt ontvangen, wordt de methode geretourneerd en wordt de Status eigenschap ingesteld op TimedOut.

Deze overbelasting maakt gebruik van standaardinstellingen voor pakketfragmentatie en het doorsturen van pakketten. Het pakket dat het ICMP-echobericht bevat, kan tijdens de overdracht worden gefragmenteerd als de totale pakketgrootte groter is dan de maximale pakketgrootte die kan worden verzonden door een van de routeringsknooppunten tussen de lokale en externe computers. Als u fragmentatie wilt voorkomen, gebruikt u een van de SendAsync methoden die een options parameter gebruiken en stelt u de DontFragment eigenschap in op true. Wanneer DontFragment is true en de totale pakketgrootte de maximale pakketgrootte overschrijdt die kan worden verzonden door een van de routeringsknooppunten tussen de lokale en externe computers, mislukt de ICMP-echoaanvraag. Als dit gebeurt, is de Status optie ingesteld op PacketTooBig.

Het pakket of pakketfragmenten kunnen 128 keer worden doorgestuurd door routeringsknooppunten voordat ze worden verwijderd. Als u deze instelling wilt wijzigen, gebruikt u een SendAsync overbelasting die een options parameter gebruikt en stelt u de Ttl eigenschap in op de gewenste waarde. Als het pakket de bestemming niet bereikt nadat het opgegeven aantal keren is doorgestuurd, wordt het pakket verwijderd en mislukt de ICMP-echoaanvraag. Als dit gebeurt, is de Status optie ingesteld op TtlExpired.

public:
 void SendAsync(System::String ^ hostNameOrAddress, int timeout, System::Object ^ userToken);

public void SendAsync(string hostNameOrAddress, int timeout, object userToken);

member this.SendAsync : string * int * obj -> unit

Public Sub SendAsync (hostNameOrAddress As String, timeout As Integer, userToken As Object)

Parameters

Uitzonderingen

Voorbeelden

Zie het Ping klasseoverzicht voor een codevoorbeeld waarin het aanroepen van de SendAsync methode wordt gedemonstreert.

Opmerkingen

De SendAsync methode verzendt het echobericht asynchroon en retourneert de status naar uw toepassing wanneer de bewerking is voltooid (geslaagd of mislukt). Roep de SendAsync methode aan wanneer uw toepassing niet mag worden geblokkeerd. Elke aanroep wordt uitgevoerd in een afzonderlijke thread die automatisch wordt toegewezen vanuit de threadgroep. Wanneer de asynchrone bewerking is voltooid, wordt de PingCompleted gebeurtenis gegenereerd. Toepassingen gebruiken een PingCompletedEventHandler gemachtigde om de methode op te geven die wordt aangeroepen wanneer SendAsync de gebeurtenis wordt gegenereerd. U moet een PingCompletedEventHandler gemachtigde toevoegen aan de gebeurtenis voordat u aanroept SendAsync. De methode van de gemachtigde ontvangt een PingCompletedEventArgs object dat een PingReply object bevat dat het resultaat van de SendAsync aanroep beschrijft. Het PingCompletedEventArgs object neemt de UserState eigenschap over. Deze eigenschap bevat het userToken object dat is doorgegeven aan de SendAsync aanroep.

Als uw toepassing moet blokkeren tijdens het wachten op een antwoord, gebruikt u de Send methoden. Deze methoden zijn synchroon.

Als het ICMP-echoantwoordbericht niet wordt ontvangen binnen de tijd die is opgegeven door de timeout parameter, mislukt de ICMP-echo en wordt de Status eigenschap ingesteld op TimedOut.

Deze overbelasting maakt gebruik van standaardinstellingen voor pakketfragmentatie en het doorsturen van pakketten. Het pakket dat het ICMP-echobericht bevat, kan tijdens de overdracht worden gefragmenteerd als de totale pakketgrootte groter is dan de maximale pakketgrootte die kan worden verzonden door een van de routeringsknooppunten tussen de lokale en externe computers. Als u fragmentatie wilt voorkomen, gebruikt u een van de SendAsync methoden die een options parameter gebruiken en stelt u de DontFragment eigenschap in op true. Wanneer DontFragment is true en de totale pakketgrootte de maximale pakketgrootte overschrijdt die kan worden verzonden door een van de routeringsknooppunten tussen de lokale en externe computers, mislukt de ICMP-echoaanvraag. Als dit gebeurt, is de Status optie ingesteld op PacketTooBig. Het pakket- of pakketfragmenten (indien gefragmenteerd) kunnen 128 keer worden doorgestuurd door routeringsknooppunten voordat ze worden verwijderd. Als u deze instelling wilt wijzigen, gebruikt u een SendAsync overbelasting die een options parameter gebruikt en stelt u de Ttl eigenschap in op de gewenste waarde. Als het pakket de bestemming niet bereikt nadat het opgegeven aantal keren is doorgestuurd, wordt het pakket verwijderd en mislukt de ICMP-echoaanvraag. Als dit gebeurt, is de Status optie ingesteld op TtlExpired.