Lire en anglais

Partager via


PingReply Classe

Définition

Fournit des informations sur l'état et les données résultant d'une opération Send ou SendAsync.

C#
public class PingReply
Héritage
PingReply

Exemples

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

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

Remarques

La Ping classe tente d’envoyer une demande d’écho ICMP (Internet Control Message Protocol) à un ordinateur distant et de recevoir des informations de l’ordinateur via un message de réponse d’écho ICMP. La Ping classe utilise des instances de la PingReply classe pour renvoyer des informations sur l’opération, telles que son status et le temps nécessaire pour envoyer la demande et recevoir la réponse.

Les Send méthodes retournent directement les instances de la PingReply classe. Les SendAsync méthodes retournent un PingReply dans le paramètre de la PingCompletedEventHandlerPingCompletedEventArgs méthode. Le PingReply est accessible via la Reply propriété .

Si la valeur de Status n’est pas Success, vous ne devez pas utiliser les valeurs retournées par les RoundtripTimepropriétés ou OptionsBuffer . La RoundtripTime propriété retourne zéro, la Buffer propriété renvoie un tableau vide et la Options propriété retourne null.

Propriétés

Address

Obtient l'adresse de l'hôte qui envoie la réponse à écho ICMP.

Buffer

Obtient la mémoire tampon des données reçues dans un message de réponse à écho ICMP.

Options

Obtient les options utilisées pour transmettre la réponse à une demande d'écho ICMP.

RoundtripTime

Obtient le nombre de millisecondes que prennent l’envoi d’une demande d’écho ICMP (Internet Control Message Protocol) et la réception du message de réponse d’écho ICMP correspondant.

Status

Obtient l'état d'une tentative d'envoi de demande d'écho ICMP et de réception du message ICMP de réponse à écho correspondant.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

S’applique à

Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1