IPInterfaceProperties クラス

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

IPInterfaceProperties クラス

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

インターネット プロトコル Version 4 (IPv4) またはインターネット プロトコル Version 6 (IPv6) をサポートしているネットワーク インターフェイスに関する情報を提供します。

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

Visual Basic (宣言)

Public MustInherit Class
 IPInterfaceProperties

Visual Basic (使用法)

Dim instance As IPInterfaceProperties

C#

public abstract class IPInterfaceProperties

C++

public ref class IPInterfaceProperties abstract

J#

public abstract class IPInterfaceProperties

JScript

public abstract class IPInterfaceProperties

解説

このクラスは、IPv4 または IPv6 をサポートするネットワーク インターフェイスの構成情報とアドレス情報へのアクセスを提供します。このクラスのインスタンスを作成する必要はありません。インスタンスは、GetIPProperties メソッドによって返されます。

IPv4 固有のプロパティにアクセスするには、GetIPv4Properties メソッドによって返されるオブジェクトを使用します。IPv6 固有のプロパティにアクセスするには、GetIPv6Properties メソッドによって返されるオブジェクトを使用します。

使用例

アドレス情報を表示するコード例を次に示します。

C#

public static void ShowIPAddresses(IPInterfaceProperties
 adapterProperties)
{
    IPAddressCollection dnsServers = adapterProperties.DnsAddresses;
    if (dnsServers != null)
    {
        foreach (IPAddress dns in dnsServers)
        {
            Console.WriteLine("  DNS Servers ............................. :
 {0}", 
                dns.ToString()
           );
        }
    }
    IPAddressInformationCollection anyCast = adapterProperties.AnycastAddresses;
    if (anyCast != null)
    {
        foreach (IPAddressInformation any in
 anyCast)
        {
            Console.WriteLine("  Anycast Address ..........................
 : {0} {1} {2}", 
                any.Address,
                any.IsTransient ? "Transient" : "", 
                any.IsDnsEligible ? "DNS Eligible" : ""
            );
        }
        Console.WriteLine();
    }
        
    MulticastIPAddressInformationCollection multiCast = adapterProperties.MulticastAddresses;
    if (multiCast != null)
    {
        foreach (IPAddressInformation multi in
 multiCast)
        {
            Console.WriteLine("  Multicast Address ....................... :
 {0} {1} {2}", 
                multi.Address,
                multi.IsTransient ? "Transient" : "", 
                multi.IsDnsEligible ? "DNS Eligible" : ""
            );
        }
        Console.WriteLine();
    }
    UnicastIPAddressInformationCollection uniCast = adapterProperties.UnicastAddresses;
    if (uniCast != null)
    {
        string lifeTimeFormat = "dddd, MMMM dd, yyyy  hh:mm:ss
 tt";
        foreach (UnicastIPAddressInformation uni in
 uniCast)
        {
            DateTime when;
            
            Console.WriteLine("  Unicast Address ......................... :
 {0}", uni.Address);
            Console.WriteLine("     Prefix Origin ........................ :
 {0}", uni.PrefixOrigin);
            Console.WriteLine("     Suffix Origin ........................ :
 {0}", uni.SuffixOrigin);
            Console.WriteLine("     Duplicate Address Detection .......... :
 {0}", 
                uni.DuplicateAddressDetectionState);
                
            // Format the lifetimes as Sunday, February 16, 2003 11:33:44
 PM
            // if en-us is the current culture.
            
            // Calculate the date and time at the end of the lifetimes.
    
            when = DateTime.UtcNow + TimeSpan.FromSeconds(uni.AddressValidLifetime);
            when = when.ToLocalTime();    
            Console.WriteLine("     Valid Life Time ...................... :
 {0}", 
                when.ToString(lifeTimeFormat,System.Globalization.CultureInfo.CurrentCulture)
            );
            when = DateTime.UtcNow + TimeSpan.FromSeconds(uni.AddressPreferredLifetime);
   
            when = when.ToLocalTime();      
            Console.WriteLine("     Preferred life time .................. :
 {0}", 
                when.ToString(lifeTimeFormat,System.Globalization.CultureInfo.CurrentCulture)
            ); 
            
            when = DateTime.UtcNow + TimeSpan.FromSeconds(uni.DhcpLeaseLifetime);
            when = when.ToLocalTime(); 
            Console.WriteLine("     DHCP Leased Life Time ................ :
 {0}", 
                when.ToString(lifeTimeFormat,System.Globalization.CultureInfo.CurrentCulture)
            );
        }
        Console.WriteLine();
    }
}

継承階層

System.Object
  System.Net.NetworkInformation.IPInterfaceProperties

スレッド セーフ

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

参照

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