ネットワーク

[C#] Pingクラスでネットワーク接続を確認する方法

2025-04-15更新日: 2025-04-15

C#のPingクラスを使用してネットワーク接続を確認するには、System.Net.NetworkInformation名前空間を利用します。

まず、Pingオブジェクトを作成し、SendメソッドまたはSendAsyncメソッドを使用して指定したホストにICMPエコー要求を送信します。

Sendメソッドは同期的に動作し、PingReplyオブジェクトを返します。

このオブジェクトのStatusプロパティを確認することで、接続が成功したかどうかを判断できます。

StatusがIPStatus.Successであれば、接続が成功したことを示します。

SendAsyncメソッドを使用すると非同期での確認が可能で、イベントハンドラを設定して結果を受け取ります。

これにより、ネットワークの疎通確認が簡単に行えます。

目次から探す

Pingクラスの基本的な使い方
PingReplyオブジェクトの解析
- PingReplyのプロパティ
- PingReplyの活用方法
エラーハンドリング
- 例外の種類
- 例外処理の実装方法
非同期処理の実装
応用例
まとめ

Pingクラスの基本的な使い方

C#のPingクラスは、ネットワーク接続を確認するための便利なツールです。

このセクションでは、Pingクラスの基本的な使い方について説明します。

Pingオブジェクトの作成

Pingクラスを使用するには、まずPingオブジェクトを作成する必要があります。

以下にその基本的な方法を示します。

using System.Net.NetworkInformation;
class Program
{
    static void Main()
    {
        // Pingオブジェクトを作成
        Ping pingSender = new Ping();
    }
}

このコードでは、Pingクラスのインスタンスを作成しています。

これにより、ネットワーク接続を確認するためのメソッドを使用できるようになります。

Sendメソッドの使用

Sendメソッドは、指定したホストに対して同期的にPingを送信します。

以下にその使用例を示します。

using System;
using System.Net.NetworkInformation;
class Program
{
    static void Main()
    {
        // Pingオブジェクトを作成
        Ping pingSender = new Ping();
        
        // ホスト名またはIPアドレスを指定
        string host = "www.example.com";
        
        // Pingを送信し、結果を取得
        PingReply reply = pingSender.Send(host);
        
        // 結果を表示
        if (reply.Status == IPStatus.Success)
        {
            Console.WriteLine("Ping成功");
            Console.WriteLine("アドレス: " + reply.Address.ToString());
            Console.WriteLine("往復時間: " + reply.RoundtripTime + "ms");
        }
        else
        {
            Console.WriteLine("Ping失敗: " + reply.Status.ToString());
        }
    }
}

このコードは、指定したホストにPingを送信し、結果を表示します。

PingReplyオブジェクトを使用して、Pingのステータスや往復時間を確認できます。

SendAsyncメソッドの使用

SendAsyncメソッドは、非同期的にPingを送信するために使用されます。

以下にその使用例を示します。

using System;
using System.Net.NetworkInformation;
using System.Threading;
class Program
{
    static void Main()
    {
        // Pingオブジェクトを作成
        Ping pingSender = new Ping();
        
        // ホスト名またはIPアドレスを指定
        string host = "www.example.com";
        
        // 非同期Pingを送信
        pingSender.SendAsync(host, null);
        
        // Ping完了時のイベントハンドラを設定
        pingSender.PingCompleted += new PingCompletedEventHandler(PingCompletedCallback);
        
        // メインスレッドが終了しないように待機
        Console.WriteLine("Ping送信中...");
        Thread.Sleep(5000);
    }
    private static void PingCompletedCallback(object sender, PingCompletedEventArgs e)
    {
        // Pingの結果を取得
        if (e.Reply.Status == IPStatus.Success)
        {
            Console.WriteLine("非同期Ping成功");
            Console.WriteLine("アドレス: " + e.Reply.Address.ToString());
            Console.WriteLine("往復時間: " + e.Reply.RoundtripTime + "ms");
        }
        else
        {
            Console.WriteLine("非同期Ping失敗: " + e.Reply.Status.ToString());
        }
    }
}

このコードは、非同期でPingを送信し、結果をイベントハンドラで処理します。

PingCompletedEventHandlerを使用して、Pingの完了時に結果を取得し、表示します。

非同期処理により、メインスレッドがブロックされることなくPingを実行できます。

PingReplyオブジェクトの解析

PingReplyオブジェクトは、PingクラスのSendまたはSendAsyncメソッドを使用した後に返されるオブジェクトで、Pingの結果を詳細に解析するための情報を提供します。

このセクションでは、PingReplyオブジェクトのプロパティとその活用方法について説明します。

PingReplyのプロパティ

PingReplyオブジェクトには、Pingの結果を解析するためのいくつかの重要なプロパティがあります。

以下に主要なプロパティを紹介します。

Statusプロパティ

Statusプロパティは、Pingの結果を示すIPStatus列挙型の値を返します。

このプロパティを使用して、Pingが成功したかどうかを確認できます。

if (reply.Status == IPStatus.Success)
{
    Console.WriteLine("Pingは成功しました。");
}
else
{
    Console.WriteLine("Pingは失敗しました。ステータス: " + reply.Status.ToString());
}

Statusプロパティは、Pingが成功した場合はIPStatus.Successを返し、失敗した場合はエラーの種類に応じたステータスを返します。

RoundtripTimeプロパティ

RoundtripTimeプロパティは、Pingの送信から応答の受信までにかかった時間をミリ秒単位で返します。

このプロパティを使用して、ネットワークの応答速度を測定できます。

Console.WriteLine("往復時間: " + reply.RoundtripTime + "ms");

RoundtripTimeプロパティは、ネットワークのパフォーマンスを評価するための重要な指標となります。

Addressプロパティ

Addressプロパティは、Ping応答を返したホストのIPアドレスを返します。

このプロパティを使用して、応答元のホストを特定できます。

Console.WriteLine("応答元のアドレス: " + reply.Address.ToString());

Addressプロパティは、特定のホストからの応答を確認する際に役立ちます。

PingReplyの活用方法

PingReplyオブジェクトを活用することで、ネットワークの状態を詳細に把握することができます。

以下にいくつかの活用方法を示します。

ネットワークの健全性チェック: Statusプロパティを使用して、ネットワーク接続が正常かどうかを確認します。

定期的にPingを実行し、ネットワークの健全性を監視することができます。

応答時間の測定: RoundtripTimeプロパティを使用して、ネットワークの応答速度を測定します。

これにより、ネットワークのパフォーマンスを評価し、遅延の原因を特定することができます。

ホストの特定: Addressプロパティを使用して、応答を返したホストを特定します。

特定のホストからの応答を確認することで、ネットワークのトポロジーを理解するのに役立ちます。

これらのプロパティを組み合わせて使用することで、PingReplyオブジェクトはネットワーク管理やトラブルシューティングにおいて非常に有用なツールとなります。

エラーハンドリング

Pingクラスを使用する際には、ネットワークの状態や入力の誤りなどにより、さまざまな例外が発生する可能性があります。

このセクションでは、Pingクラスに関連する例外の種類と、それらを適切に処理する方法について説明します。

例外の種類

Pingクラスを使用する際に考慮すべき主な例外には以下のようなものがあります。

PingException: Ping操作が失敗した場合にスローされる例外です。

ネットワークの問題や無効なホスト名が原因で発生することがあります。

ArgumentNullException: SendメソッドやSendAsyncメソッドにnullの引数を渡した場合にスローされます。
ArgumentException: 無効な引数が渡された場合にスローされます。

例えば、ホスト名が空文字列の場合などです。

InvalidOperationException: Pingオブジェクトが既に使用中である場合にスローされます。

非同期操作中に再度SendAsyncを呼び出すと発生することがあります。

SocketException: ネットワーク関連のエラーが発生した場合にスローされます。

ネットワークが利用できない場合や、ホストが見つからない場合に発生します。

例外処理の実装方法

例外を適切に処理することで、プログラムの安定性を向上させることができます。

以下に、Pingクラスを使用する際の例外処理の実装例を示します。

using System;
using System.Net.NetworkInformation;
using System.Net.Sockets;

class Program
{
    static void Main()
    {
        try
        {
            // Pingオブジェクトを作成
            Ping pingSender = new Ping();

            // ホスト名またはIPアドレスを指定
            string host = "www.example.com";

            // Pingを送信し、結果を取得
            PingReply reply = pingSender.Send(host);

            // 結果を表示
            if (reply.Status == IPStatus.Success)
            {
                Console.WriteLine("Ping成功");
                Console.WriteLine("アドレス: " + reply.Address.ToString());
                Console.WriteLine("往復時間: " + reply.RoundtripTime + "ms");
            }
            else
            {
                Console.WriteLine("Ping失敗: " + reply.Status.ToString());
            }
        }
        catch (PingException ex)
        {
            Console.WriteLine("Ping操作に失敗しました: " + ex.Message);
        }
        catch (ArgumentNullException ex)
        {
            Console.WriteLine("引数がnullです: " + ex.Message);
        }
        catch (ArgumentException ex)
        {
            Console.WriteLine("無効な引数です: " + ex.Message);
        }
        catch (InvalidOperationException ex)
        {
            Console.WriteLine("Pingオブジェクトが使用中です: " + ex.Message);
        }
        catch (SocketException ex)
        {
            Console.WriteLine("ネットワークエラーが発生しました: " + ex.Message);
        }
        catch (Exception ex)
        {
            Console.WriteLine("予期しないエラーが発生しました: " + ex.Message);
        }
    }
}

このコードでは、try-catchブロックを使用して、Pingクラスに関連する例外をキャッチし、適切なメッセージを表示しています。

各例外に対して個別のcatchブロックを用意することで、発生したエラーの種類に応じた処理を行うことができます。

これにより、プログラムが予期しないクラッシュを回避し、ユーザーに対して有用な情報を提供することが可能になります。

非同期処理の実装

非同期処理は、ネットワーク操作を行う際に、メインスレッドをブロックせずに他の作業を続行できるため、アプリケーションの応答性を向上させるのに役立ちます。

このセクションでは、PingクラスのSendAsyncメソッドを使用した非同期処理の詳細とその利点、実装例について説明します。

SendAsyncメソッドの詳細

SendAsyncメソッドは、指定したホストに対して非同期的にPingを送信します。

このメソッドは、Pingの完了を待たずにすぐに制御を返すため、メインスレッドがブロックされることはありません。

SendAsyncメソッドは、Pingの完了時に呼び出されるコールバックメソッドを指定することができます。

pingSender.SendAsync(host, null);

このコードでは、SendAsyncメソッドを使用して非同期Pingを送信しています。

第二引数にはユーザーステートオブジェクトを指定できますが、ここではnullを指定しています。

非同期処理の利点

非同期処理を使用することで、以下のような利点があります。

応答性の向上: メインスレッドがブロックされないため、ユーザーインターフェースが応答し続けることができます。

これにより、ユーザーエクスペリエンスが向上します。

効率的なリソース利用: 非同期処理により、CPUやネットワークリソースを効率的に利用できます。

複数のネットワーク操作を同時に実行することが可能です。

スケーラビリティの向上: 非同期処理を使用することで、アプリケーションがより多くのリクエストを処理できるようになります。

特にサーバーアプリケーションにおいて、スケーラビリティが向上します。

非同期処理の実装例

以下に、PingクラスのSendAsyncメソッドを使用した非同期処理の実装例を示します。

using System;
using System.Net.NetworkInformation;
using System.Threading;
class Program
{
    static void Main()
    {
        // Pingオブジェクトを作成
        Ping pingSender = new Ping();
        
        // ホスト名またはIPアドレスを指定
        string host = "www.example.com";
        
        // Ping完了時のイベントハンドラを設定
        pingSender.PingCompleted += new PingCompletedEventHandler(PingCompletedCallback);
        
        // 非同期Pingを送信
        pingSender.SendAsync(host, null);
        
        // メインスレッドが終了しないように待機
        Console.WriteLine("Ping送信中...");
        Thread.Sleep(5000);
    }
    private static void PingCompletedCallback(object sender, PingCompletedEventArgs e)
    {
        // Pingの結果を取得
        if (e.Reply.Status == IPStatus.Success)
        {
            Console.WriteLine("非同期Ping成功");
            Console.WriteLine("アドレス: " + e.Reply.Address.ToString());
            Console.WriteLine("往復時間: " + e.Reply.RoundtripTime + "ms");
        }
        else
        {
            Console.WriteLine("非同期Ping失敗: " + e.Reply.Status.ToString());
        }
    }
}

このコードでは、PingCompletedEventHandlerを使用して、Pingの完了時にPingCompletedCallbackメソッドが呼び出されるように設定しています。

SendAsyncメソッドを使用することで、メインスレッドがPingの完了を待たずに他の作業を続行できるため、アプリケーションの応答性が向上します。

非同期処理は、特にユーザーインターフェースを持つアプリケーションや、複数のネットワーク操作を同時に行う必要がある場合に非常に有用です。

応用例

Pingクラスを活用することで、ネットワークの状態を監視したり、複数のホストに対してPingを送信したりすることができます。

このセクションでは、Pingクラスの応用例として、複数ホストへのPing送信、定期的なネットワーク監視、Ping結果のログ出力について説明します。

複数ホストへのPing送信

複数のホストに対してPingを送信することで、ネットワーク全体の状態を把握することができます。

以下に、複数のホストにPingを送信する例を示します。

using System;
using System.Net.NetworkInformation;
class Program
{
    static void Main()
    {
        // 複数のホスト名またはIPアドレスを指定
        string[] hosts = { "www.example.com", "www.google.com", "www.microsoft.com" };
        
        // Pingオブジェクトを作成
        Ping pingSender = new Ping();
        
        foreach (string host in hosts)
        {
            // 各ホストにPingを送信
            PingReply reply = pingSender.Send(host);
            
            // 結果を表示
            Console.WriteLine("ホスト: " + host);
            if (reply.Status == IPStatus.Success)
            {
                Console.WriteLine("Ping成功");
                Console.WriteLine("アドレス: " + reply.Address.ToString());
                Console.WriteLine("往復時間: " + reply.RoundtripTime + "ms");
            }
            else
            {
                Console.WriteLine("Ping失敗: " + reply.Status.ToString());
            }
            Console.WriteLine();
        }
    }
}

このコードは、指定した複数のホストに対してPingを送信し、それぞれの結果を表示します。

これにより、ネットワーク全体の接続状態を確認することができます。

定期的なネットワーク監視

定期的にPingを送信することで、ネットワークの状態を継続的に監視することができます。

以下に、定期的にPingを送信する例を示します。

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

class Program
{
    static void Main()
    {
        // ホスト名またはIPアドレスを指定
        string host = "www.example.com";

        // Pingオブジェクトを作成
        Ping pingSender = new Ping();

        // 定期的にPingを送信
        System.Threading.Timer timer = new System.Threading.Timer((e) =>
        {
            PingReply reply = pingSender.Send(host);
            Console.WriteLine("Ping送信: " + DateTime.Now);
            if (reply.Status == IPStatus.Success)
            {
                Console.WriteLine("Ping成功");
                Console.WriteLine("アドレス: " + reply.Address.ToString());
                Console.WriteLine("往復時間: " + reply.RoundtripTime + "ms");
            }
            else
            {
                Console.WriteLine("Ping失敗: " + reply.Status.ToString());
            }
            Console.WriteLine();
        }, null, 0, 5000); // 5秒ごとにPingを送信

        // メインスレッドが終了しないように待機
        Console.ReadLine();
    }
}

このコードは、指定したホストに対して5秒ごとにPingを送信し、結果を表示します。

Timerクラスを使用して、定期的にPingを送信するように設定しています。

Ping結果のログ出力

Pingの結果をログファイルに出力することで、ネットワークの状態を記録し、後で分析することができます。

以下に、Ping結果をログファイルに出力する例を示します。

using System;
using System.IO;
using System.Net.NetworkInformation;
class Program
{
    static void Main()
    {
        // ホスト名またはIPアドレスを指定
        string host = "www.example.com";
        
        // ログファイルのパスを指定
        string logFilePath = "ping_log.txt";
        
        // Pingオブジェクトを作成
        Ping pingSender = new Ping();
        
        // Pingを送信し、結果を取得
        PingReply reply = pingSender.Send(host);
        
        // 結果をログファイルに出力
        using (StreamWriter writer = new StreamWriter(logFilePath, true))
        {
            writer.WriteLine("Ping送信: " + DateTime.Now);
            if (reply.Status == IPStatus.Success)
            {
                writer.WriteLine("Ping成功");
                writer.WriteLine("アドレス: " + reply.Address.ToString());
                writer.WriteLine("往復時間: " + reply.RoundtripTime + "ms");
            }
            else
            {
                writer.WriteLine("Ping失敗: " + reply.Status.ToString());
            }
            writer.WriteLine();
        }
        
        Console.WriteLine("Ping結果をログに出力しました。");
    }
}