GetIPProperties Method

NetworkInterface.GetIPProperties Method

Returns an object that describes the configuration of this network interface.

Namespace:  System.Net.NetworkInformation
Assembly:  System (in System.dll)

public abstract IPInterfaceProperties GetIPProperties()

Return Value

Type: System.Net.NetworkInformation.IPInterfaceProperties
An IPInterfaceProperties object that describes this network interface.

Note that the information in the object returned by this method reflects the interfaces as of the time the array is created. This information is not updated dynamically.

The following code example displays information for the local computer's network adapters that support IPv4.

public static void DisplayIPv4NetworkInterfaces()
{
    NetworkInterface[] nics = NetworkInterface.GetAllNetworkInterfaces();
    IPGlobalProperties properties = IPGlobalProperties.GetIPGlobalProperties();
    Console.WriteLine("IPv4 interface information for {0}.{1}",
       properties.HostName, properties.DomainName);
    Console.WriteLine();   

    foreach (NetworkInterface adapter in nics)
    {
        // Only display informatin for interfaces that support IPv4. 
        if (adapter.Supports(NetworkInterfaceComponent.IPv4) == false)
        {
            continue;
        }
        Console.WriteLine(adapter.Description);
        // Underline the description.
        Console.WriteLine(String.Empty.PadLeft(adapter.Description.Length,'='));
        IPInterfaceProperties adapterProperties = adapter.GetIPProperties();
        // Try to get the IPv4 interface properties.
        IPv4InterfaceProperties p = adapterProperties.GetIPv4Properties();

        if (p == null)
        {
            Console.WriteLine("No IPv4 information is available for this interface.");
            Console.WriteLine();
            continue;
        }
        // Display the IPv4 specific data.
        Console.WriteLine("  Index ............................. : {0}", p.Index);
        Console.WriteLine("  MTU ............................... : {0}", p.Mtu);
        Console.WriteLine("  APIPA active....................... : {0}", 
            p.IsAutomaticPrivateAddressingActive);
        Console.WriteLine("  APIPA enabled...................... : {0}", 
            p.IsAutomaticPrivateAddressingEnabled);
        Console.WriteLine("  Forwarding enabled................. : {0}", 
            p.IsForwardingEnabled);
        Console.WriteLine("  Uses WINS ......................... : {0}", 
            p.UsesWins);
        Console.WriteLine();
    }
}
void DisplayIPv4NetworkInterfaces()
{
    NetworkInterface* nics[] = NetworkInterface::GetAllNetworkInterfaces();
    IPGlobalProperties* properties = IPGlobalProperties::GetIPGlobalProperties();
    Console::WriteLine(S"IPv4 interface information for {0}.{1}",
        properties->HostName, properties->DomainName);

    System::Collections::IEnumerator* myEnum23 = nics->GetEnumerator();
    while (myEnum23->MoveNext())
    {
        NetworkInterface* adapter = __try_cast<NetworkInterface*>(myEnum23->Current);
        // Only display informatin for interfaces that support IPv4.
        if (adapter->Supports(NetworkInterfaceComponent::IPv4) == false)
        {
            continue;
        }
        Console::WriteLine();
        Console::WriteLine(adapter->Description);
        // Underline the description.
        Console::WriteLine(String::Empty->PadLeft(adapter->Description->Length,'='));
        IPInterfaceProperties* adapterProperties = adapter->GetIPInterfaceProperties();
        // Try to get the IPv4 interface properties.
        IPv4InterfaceProperties* p = adapterProperties->GetIPv4InterfaceProperties();

        if (p == 0)
        {
            Console::WriteLine(S"No IPv4 information is available for this interface.");
            continue;
        }
        // Display the IPv4 specific data.
        Console::WriteLine(S"  Index ............................. : {0}", __box(p->Index));
        Console::WriteLine(S"  MTU ............................... : {0}", __box(p->Mtu));
        Console::WriteLine(S"  APIPA active....................... : {0}", __box(p->IsAutomaticPrivateAddressingActive));
        Console::WriteLine(S"  APIPA enabled...................... : {0}", __box(p->IsAutomaticPrivateAddressingEnabled));
        Console::WriteLine(S"  Forwarding enabled................. : {0}", __box(p->IsForwardingEnabled));
        Console::WriteLine(S"  Uses WINS ......................... : {0}", __box(p->UsesWins));
    }
}

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

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0

Community Additions

ADD
Show:
© 2016 Microsoft