PingReply.Status プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

PingReply.Status プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

ICMP (インターネットコントロールメッセージプロトコル) エコー要求の送信と、対応する ICMP エコー応答メッセージの受信の処理のステータスを取得します。

名前空間: System.Net.NetworkInformation
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 Status As IPStatus

Visual Basic (使用法)

Dim instance As PingReply
Dim value As IPStatus

value = instance.Status

public IPStatus Status { get; }

C++

public:
property IPStatus Status {
    IPStatus get ();
}

/** @property */
public IPStatus get_Status ()

JScript

public function get Status
 () : IPStatus

プロパティ値
要求の結果を示す IPStatus 値。

解説

Status の値が Success でない場合は、RoundTripTime、Options、または Buffer の各プロパティによって返される値は使用しないでください。RoundTripTime プロパティおよび Buffer プロパティは 0 を返し、Options プロパティは null 参照 (Visual Basic では Nothing) を返します。

使用例

Ping クラスを使用して、ICMP エコー要求を同期的に送信し、応答を表示するコード例を次に示します。

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