Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

OperationalStatus Enumeration

Specifies the operational state of a network interface.

Namespace:  System.Net.NetworkInformation
Assembly:  System (in System.dll)
public enum OperationalStatus
Member nameDescription
UpThe network interface is up; it can transmit data packets.
DownThe network interface is unable to transmit data packets.
TestingThe network interface is running tests.
UnknownThe network interface status is not known.
DormantThe network interface is not in a condition to transmit data packets; it is waiting for an external event.
NotPresentThe network interface is unable to transmit data packets because of a missing component, typically a hardware component.
LowerLayerDownThe network interface is unable to transmit data packets because it runs on top of one or more other interfaces, and at least one of these "lower layer" interfaces is down.

This enumeration defines valid values for the OperationalStatus property.

The following code example displays a summary for all interfaces on the local computer.

public static void ShowInterfaceSummary()
{

    NetworkInterface[] interfaces = NetworkInterface.GetAllNetworkInterfaces();
    foreach (NetworkInterface adapter in interfaces)
    {                
        Console.WriteLine ("Name: {0}", adapter.Name);
        Console.WriteLine(adapter.Description);
        Console.WriteLine(String.Empty.PadLeft(adapter.Description.Length,'='));
        Console.WriteLine("  Interface type .......................... : {0}", adapter.NetworkInterfaceType);
        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);
        Console.WriteLine();
    }
    Console.WriteLine();
}
void ShowInterfaceSummary()
{

    NetworkInterface* interfaces[] = NetworkInterface::GetAllNetworkInterfaces();
    System::Collections::IEnumerator* myEnum5 = interfaces->GetEnumerator();
    while (myEnum5->MoveNext())
    {
        NetworkInterface* adapter = __try_cast<NetworkInterface*>(myEnum5->Current);                
        Console::WriteLine (S"Name: {0}", adapter->Name);
        Console::WriteLine(adapter->Description);
        Console::WriteLine(String::Empty->PadLeft(adapter->Description->Length,'='));
        Console::WriteLine(S"  Interface type .......................... : {0}", __box(adapter->Type));
        Console::WriteLine(S"  Operational status ...................... : {0}", __box(adapter->OperationalStatus));
        String* versions =S"";

        // Create a display string for the supported IP versions.
        if (adapter->Supports(NetworkInterfaceComponent::IPv4))
        {
            versions = S"IPv4";
        }
        if (adapter->Supports(NetworkInterfaceComponent::IPv6))
        {
            if (versions->Length > 0)
            {
                versions = String::Concat( versions, S" ");
            }
            versions = String::Concat( versions, S"IPv6" );
        }
        Console::WriteLine(S"  IP version .............................. : {0}", versions);
        Console::WriteLine();
    }
    Console::WriteLine();
}

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
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.