PingReply.Status Propriété

Définition

Espace de noms:

System.Net.NetworkInformation

Assemblys:

netstandard.dll, System.Net.Ping.dll

Source:

PingReply.cs

Obtient l’état d’une tentative d’envoi d’une demande d’écho ICMP (Internet Control Message Protocol) et reçoit le message de réponse d’écho ICMP correspondant.

public:
 property System::Net::NetworkInformation::IPStatus Status { System::Net::NetworkInformation::IPStatus get(); };

public System.Net.NetworkInformation.IPStatus Status { get; }

member this.Status : System.Net.NetworkInformation.IPStatus

Public ReadOnly Property Status As IPStatus

Valeur de propriété

IPStatus

Valeur IPStatus indiquant le résultat de la requête.

Exemples

L’exemple de code suivant illustre l’utilisation Ping de la classe pour envoyer une demande d’écho ICMP de manière synchrone et afficher la réponse.

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

Remarques

Si la valeur n’est Status pas Success, vous ne devez pas utiliser les valeurs retournées par le RoundtripTimeou OptionsBuffer les propriétés. Les RoundtripTime propriétés retournent Buffer zéro, et la Options propriété retourne null.