network-interface

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

NetworkInterface クラス

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

ネットワーク インターフェイスの構成情報および統計情報を提供します。

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

Visual Basic (宣言)

Public MustInherit Class
 NetworkInterface

Visual Basic (使用法)

Dim instance As NetworkInterface

C#

public abstract class NetworkInterface

C++

public ref class NetworkInterface abstract

J#

public abstract class NetworkInterface

JScript

public abstract class NetworkInterface

解説

このクラスは、ローカル コンピュータのネットワーク インターフェイス (アダプタ) のデータをカプセル化します。このクラスのインスタンスを作成することはありません。GetAllNetworkInterfaces メソッドが、ローカル コンピュータの各ネットワーク インターフェイスについて、このクラスのインスタンスを格納している配列を返します。

使用例

インターフェイスに関する情報を表示するコード例を次に示します。

C#

public static void ShowNetworkInterfaces()
{
    IPGlobalProperties computerProperties = IPGlobalProperties.GetIPGlobalProperties();
    NetworkInterface[] nics = NetworkInterface.GetAllNetworkInterfaces();
    Console.WriteLine("Interface information for {0}.{1}
     ",
            computerProperties.HostName, computerProperties.DomainName);
    if (nics == null || nics.Length < 1)
    {
        Console.WriteLine("  No network interfaces found.");
        return;
    }
                     
    Console.WriteLine("  Number of interfaces .................... : {0}",
 nics.Length);
    foreach (NetworkInterface adapter in nics)
    {
        IPInterfaceProperties properties = adapter.GetIPProperties();
        Console.WriteLine();
        Console.WriteLine(adapter.Description);
        Console.WriteLine(String.Empty.PadLeft(adapter.Description.Length,'='));
        Console.WriteLine("  Interface type .......................... : {0}",
 adapter.NetworkInterfaceType);
        Console.WriteLine("  Physical Address ........................ : {0}",
 
                   adapter.GetPhysicalAddress().ToString());
        Console.WriteLine("  Operational status ...................... : {0}",
 
            adapter.OperationalStatus);
        string versions ="";

        // Create a display string for the supported IP versions.
        if (adapter.Supports(NetworkInterfaceComponent.IPv4))
        {
             versions = "IPv4";
         }
        if (adapter.Supports(NetworkInterfaceComponent.IPv6))
        {
            if (versions.Length > 0)
            {
                versions += " ";
             }
            versions += "IPv6";
        }
        Console.WriteLine("  IP version .............................. : {0}",
 versions);
        ShowIPAddresses(properties);
        
        // The following information is not useful for loopback adapters.
        if (adapter.NetworkInterfaceType == NetworkInterfaceType.Loopback)
        {
            continue;
        }
        Console.WriteLine("  DNS suffix .............................. : {0}",
 
            properties.DnsSuffix);
        
        string label;
        if (adapter.Supports(NetworkInterfaceComponent.IPv4))
        {
            IPv4InterfaceProperties ipv4 = properties.GetIPv4Properties();
            Console.WriteLine("  MTU...................................... :
 {0}", ipv4.Mtu);
            if (ipv4.UsesWins)
            {
                
                IPAddressCollection winsServers = properties.WinsServersAddresses;
                if (winsServers.Count > 0)
                {
                    label = "  WINS Servers ............................ :";
                    ShowIPAddresses(label, winsServers);
                }
            }
        }
                 
        Console.WriteLine("  DNS enabled ............................. : {0}",
 
            properties.IsDnsEnabled);
        Console.WriteLine("  Dynamically configured DNS .............. : {0}",
 
            properties.IsDynamicDnsEnabled);
        Console.WriteLine("  Receive Only ............................ : {0}",
 
            adapter.IsReceiveOnly);
        Console.WriteLine("  Multicast ............................... : {0}",
 
            adapter.SupportsMulticast);
        ShowInterfaceStatistics(adapter);
        
        Console.WriteLine();
    }

.NET Framework のセキュリティ

• SecurityPermission  (アンマネージ コードを実行するために必要なアクセス許可)。UnmanagedCode (関連する列挙体)

継承階層

System.Object
  System.Net.NetworkInformation.NetworkInterface

スレッド セーフ

この型の 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

参照

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

NetworkInterface コンストラクタ

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

NetworkInterface クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Protected Sub New

Visual Basic (使用法)

Dim instance As New NetworkInterface

C#

protected NetworkInterface ()

C++

protected:
NetworkInterface ()

J#

protected NetworkInterface ()

JScript

protected function NetworkInterface ()

解説

このコンストラクタは、NetworkInterface クラスから派生したクラスからのみ呼び出すことができます。

プラットフォーム

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

参照

関連項目
NetworkInterface クラス
NetworkInterface メンバ
System.Net.NetworkInformation 名前空間

NetworkInterface プロパティ

パブリック プロパティ

	名前	説明
	Name	ネットワーク アダプタの名前を取得します。
	NetworkInterfaceType	インターフェイスの種類を取得します。
	OperationalStatus	ネットワーク接続の現在の操作状態を取得します。
	Speed	ネットワーク インターフェイスの速度を取得します。
	SupportsMulticast	ネットワーク インターフェイスでマルチキャスト パケットの受信が有効になっているかどうかを示す Boolean 値を取得します。

参照

関連項目

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

NetworkInterface メソッド

パブリック メソッド

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

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetAllNetworkInterfaces	ローカル コンピュータのネットワーク インターフェイスを記述するオブジェクトを返します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetIPProperties	このネットワーク インターフェイスの構成を記述するオブジェクトを返します。
	GetIPv4Statistics	IPv4 の統計情報を取得します。
	GetIsNetworkAvailable	ネットワーク接続が使用可能かどうかを示します。
	GetPhysicalAddress	このアダプタのメディア アクセス制御 (MAC: Media Access Control) アドレスを返します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Supports	指定したプロトコルをインターフェイスがサポートしているかどうかを示す Boolean 値を取得します。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

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

参照

関連項目

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

NetworkInterface メンバ

ネットワーク インターフェイスの構成情報および統計情報を提供します。

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

プロテクト コンストラクタ

	名前	説明
	NetworkInterface	NetworkInterface クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	Name	ネットワーク アダプタの名前を取得します。
	NetworkInterfaceType	インターフェイスの種類を取得します。
	OperationalStatus	ネットワーク接続の現在の操作状態を取得します。
	Speed	ネットワーク インターフェイスの速度を取得します。
	SupportsMulticast	ネットワーク インターフェイスでマルチキャスト パケットの受信が有効になっているかどうかを示す Boolean 値を取得します。

パブリック メソッド

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

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetAllNetworkInterfaces	ローカル コンピュータのネットワーク インターフェイスを記述するオブジェクトを返します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetIPProperties	このネットワーク インターフェイスの構成を記述するオブジェクトを返します。
	GetIPv4Statistics	IPv4 の統計情報を取得します。
	GetIsNetworkAvailable	ネットワーク接続が使用可能かどうかを示します。
	GetPhysicalAddress	このアダプタのメディア アクセス制御 (MAC: Media Access Control) アドレスを返します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Supports	指定したプロトコルをインターフェイスがサポートしているかどうかを示す Boolean 値を取得します。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

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

参照

関連項目

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

ウィキペディア

ネットワークインタフェース

出典: フリー百科事典『ウィキペディア（Wikipedia）』 (2022/02/25 16:27 UTC 版)

ネットワークインタフェース (Network interface)には以下のようなものが含まれる。