Ping.Send Methode

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

Parameters

Retouren

Een PingReply object dat informatie biedt over het ICMP-echoantwoordbericht, als er een is ontvangen of de reden voor de fout beschrijft als er geen bericht is ontvangen.

Uitzonderingen

Voorbeelden

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

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

Opmerkingen

Deze methode verzendt naar de host die is opgegeven door address een gegevensbuffer van 32 Byte 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 Send 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 Send 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:
 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

Parameters

Retouren

Een PingReply object dat informatie biedt over het ICMP-echoantwoordbericht, als er een is ontvangen of de reden voor de fout biedt, als er geen bericht is ontvangen.

Uitzonderingen

Voorbeelden

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

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

Opmerkingen

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 Send 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 Send 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:
 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

Parameters

Retouren

Een PingReply object dat informatie geeft over het ICMP-echoantwoordbericht als er een is ontvangen of de reden voor de fout geeft als er geen bericht is ontvangen.

Uitzonderingen

Voorbeelden

Zie het Ping klasseoverzicht voor een voorbeeld waarin het aanroepen van een Send methode wordt gedemonstreert.

Opmerkingen

Als het ICMP-echoantwoordbericht niet wordt ontvangen binnen de tijd die is opgegeven in 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 Send 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 Send 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:
 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

Parameters

Retouren

Een PingReply object dat informatie geeft over het ICMP-echoantwoordbericht als er een is ontvangen of de reden voor de fout geeft als er geen bericht is ontvangen.

Uitzonderingen

Voorbeelden

Zie het Ping klasseoverzicht voor een voorbeeld waarin het aanroepen van een Send methode wordt gedemonstreert.

Opmerkingen

Als het ICMP-echoantwoordbericht niet wordt ontvangen binnen de tijd die is opgegeven in 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 Send 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 Send 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:
 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

Parameters

Retouren

Een PingReply object dat informatie biedt over het ICMP-echoantwoordbericht, als er een is ontvangen of de reden voor de fout biedt, als er geen bericht is ontvangen. De methode retourneert PacketTooBig als het pakket de Maximum Transmission Unit (MTU) overschrijdt.

Uitzonderingen

Voorbeelden

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

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

Opmerkingen

Als het ICMP-echoantwoordbericht niet wordt ontvangen binnen de tijd die is opgegeven in 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 Send 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 Send 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:
 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

Parameters

Retouren

Een PingReply object dat informatie geeft over het ICMP-echoantwoordbericht als er een is ontvangen of de reden voor de fout geeft als er geen bericht is ontvangen.

Uitzonderingen

Voorbeelden

Zie het Ping klasoverzicht voor een voorbeeld dat laat zien hoe u een Send overbelasting aanroept.

Opmerkingen

Als het ICMP-echoantwoordbericht niet wordt ontvangen binnen de tijd die is opgegeven in 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 Send 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 Send 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:
 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

Parameters

Retouren

Een PingReply object dat informatie biedt over het ICMP-echoantwoordbericht, als er een is ontvangen of de reden voor de fout biedt, als er geen bericht is ontvangen. De methode retourneert PacketTooBig als het pakket de Maximum Transmission Unit (MTU) overschrijdt.

Uitzonderingen

Voorbeelden

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

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

Opmerkingen

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:
 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

Parameters

Retouren

Een PingReply object dat informatie geeft over het ICMP-echoantwoordbericht als er een is ontvangen of de reden voor de fout geeft als er geen bericht is ontvangen.

Uitzonderingen

Voorbeelden

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

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

Opmerkingen

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.