NetworkChange

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

NetworkChange イベント

パブリック イベント

	名前	説明
	NetworkAddressChanged	ネットワーク インターフェイスの IP アドレスが変更されたときに発生します。
	NetworkAvailabilityChanged	ネットワークの可用性に変更があったときに発生します。

参照

関連項目

NetworkChange クラス
System.Net.NetworkInformation 名前空間

NetworkChange クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

ネットワーク インターフェイス (ネットワーク カードまたはネットワーク アダプタとも呼ばれる) のインターネット プロトコル (IP) アドレスが変わったときに、アプリケーションが通知を受信できるようにします。

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

Visual Basic (宣言)

Public NotInheritable Class
 NetworkChange

Visual Basic (使用法)

Dim instance As NetworkChange

C#

public sealed class NetworkChange

C++

public ref class NetworkChange sealed

J#

public final class NetworkChange

JScript

public final class NetworkChange

解説

NetworkChange クラスは、NetworkAddressChanged イベントを発生させることによって、アドレス変更通知を提供します。インターフェイス アドレスは、ネットワーク ケーブルが切断された、ワイヤレス LAN の範囲外に移動した、ハードウェア障害が発生したなど、多くの理由で変更されることがあります。

通知を受信するには、アプリケーションのイベント ハンドラを識別する必要があります。アプリケーションのイベント ハンドラは、イベントが発生するたびにアプリケーション固有のタスクを実行する 1 つ以上のメソッドです。NetworkAddressChanged イベントが発生したときに NetworkChange オブジェクトからイベント処理メソッドが呼び出されるようにするには、メソッドを NetworkAddressChangedEventHandler デリゲートに関連付け、このデリゲートをイベントに追加する必要があります。

使用例

アドレスの変更を待機し、NetworkAddressChanged イベントが発生したときにネットワーク インターフェイスのステータスを表示するコード例を次に示します。

Visual Basic

Imports System
Imports System.Net
Imports System.Net.NetworkInformation

Public Class NetworkingExample
    Public Shared Sub Main()
        AddHandler NetworkChange.NetworkAddressChanged, AddressOf
 AddressChangedCallback
        Console.WriteLine("Listening for address changes. Press
 any key to exit.")
        Console.ReadLine()
    End Sub 'Main
    Shared Sub AddressChangedCallback(sender
 As Object, e As EventArgs)
        
        Dim adapters As NetworkInterface()
 = NetworkInterface.GetAllNetworkInterfaces()
        Dim n As NetworkInterface
        For Each n In  adapters
            Console.WriteLine("   {0} is {1}", n.Name,
 n.OperationalStatus)
        Next n
    End Sub 
End Class 

C#

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

namespace Examples.Net.AddressChanges
{
    public class NetworkingExample
    {
        public static void
 Main()
        {
            NetworkChange.NetworkAddressChanged += new 
            NetworkAddressChangedEventHandler(AddressChangedCallback);
            Console.WriteLine("Listening for address changes.
 Press any key to exit.");
            Console.ReadLine();
        }
        static void AddressChangedCallback(object
 sender, EventArgs e)
        {
            
            NetworkInterface[] adapters = NetworkInterface.GetAllNetworkInterfaces();
            foreach(NetworkInterface n in adapters)
            {
                Console.WriteLine("   {0} is {1}", n.Name, n.OperationalStatus);
            }
        }
    }
}

C++

#using <System.dll>

using namespace System;
using namespace System::Net;
using namespace System::Net::NetworkInformation;
void AddressChangedCallback( Object^ /*sender*/, EventArgs^ /*e*/
 )
{
   array<NetworkInterface^>^adapters = NetworkInterface::GetAllNetworkInterfaces();
   System::Collections::IEnumerator^ myEnum = adapters->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      NetworkInterface^ n = safe_cast<NetworkInterface^>(myEnum->Current);
      Console::WriteLine( "   {0} is {1}", n->Name, n->OperationalStatus
 );
   }
}

int main()
{
   NetworkChange::NetworkAddressChanged += gcnew NetworkAddressChangedEventHandler(
 AddressChangedCallback );
   Console::WriteLine( "Listening for address changes. Press
 any key to exit." );
   Console::ReadLine();
}

継承階層

System.Object
  System.Net.NetworkInformation.NetworkChange

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
NetworkChange メンバ
System.Net.NetworkInformation 名前空間

NetworkChange メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

NetworkChange クラス
System.Net.NetworkInformation 名前空間

NetworkChange メンバ

ネットワーク インターフェイス (ネットワーク カードまたはネットワーク アダプタとも呼ばれる) のインターネット プロトコル (IP) アドレスが変わったときに、アプリケーションが通知を受信できるようにします。

NetworkChange データ型で公開されるメンバを以下の表に示します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

パブリック イベント

	名前	説明
	NetworkAddressChanged	ネットワーク インターフェイスの IP アドレスが変更されたときに発生します。
	NetworkAvailabilityChanged	ネットワークの可用性に変更があったときに発生します。

参照

関連項目

NetworkChange クラス
System.Net.NetworkInformation 名前空間