NetworkInterface Sınıf

Tanım

Ad Alanı:

System.Net.NetworkInformation

Bütünleştirilmiş Kod:

System.Net.NetworkInformation.dll

Kaynak:

NetworkInterface.cs

Ağ arabirimi için yapılandırma ve istatistiksel bilgiler sağlar.

public ref class NetworkInterface abstract

public abstract class NetworkInterface

type NetworkInterface = class

Public MustInherit Class NetworkInterface

Devralma

Object

NetworkInterface

Örnekler

Aşağıdaki kod örneği, arabirimler hakkındaki bilgileri görüntüler.

void ShowNetworkInterfaces()
{
   IPGlobalProperties ^ computerProperties = IPGlobalProperties::GetIPGlobalProperties();
   array<NetworkInterface^>^nics = NetworkInterface::GetAllNetworkInterfaces();
   Console::WriteLine( "Interface information for {0}.{1}     ", computerProperties->HostName, computerProperties->DomainName );
   if ( nics == nullptr || nics->Length < 1 )
   {
      Console::WriteLine( "  No network interfaces found." );
      return;
   }

   Console::WriteLine( "  Number of interfaces .................... : {0}", nics->Length );
   System::Collections::IEnumerator^ myEnum4 = nics->GetEnumerator();
   while ( myEnum4->MoveNext() )
   {
      NetworkInterface ^ adapter = safe_cast<NetworkInterface ^>(myEnum4->Current);
      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() );
      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 = String::Concat( versions, " " );
         }
         versions = String::Concat( 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();
   }
}

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();
    }
}

Açıklamalar

Bu sınıf, yerel bilgisayardaki bağdaştırıcılar olarak da bilinen ağ arabirimleri için verileri kapsüller. Bu sınıfın örneklerini oluşturmazsınız; yöntemi, GetAllNetworkInterfaces yerel bilgisayardaki her ağ arabirimi için bu sınıfın bir örneğini içeren bir dizi döndürür.

Oluşturucular

NetworkInterface()

NetworkInterface sınıfının yeni bir örneğini başlatır.

Özellikler

Description	Arabirimin açıklamasını alır.
Id	Ağ bağdaştırıcısının tanımlayıcısını alır.
IPv6LoopbackInterfaceIndex	IPv6 geri döngü arabiriminin dizinini alır.
IsReceiveOnly	Ağ arabiriminin yalnızca veri paketlerini alacak şekilde ayarlanıp ayarlanmadığını belirten bir Boolean değer alır.
LoopbackInterfaceIndex	IPv4 geri döngü arabiriminin dizinini alır.
Name	Ağ bağdaştırıcısının adını alır.
NetworkInterfaceType	Arabirim türünü alır.
OperationalStatus	Ağ bağlantısının geçerli işletim durumunu alır.
Speed	Ağ arabiriminin hızını alır.
SupportsMulticast	Ağ arabiriminin çok noktaya yayın paketlerini almak için etkinleştirilip etkinleştirilmediğini belirten bir Boolean değer alır.

Yöntemler

GetAllNetworkInterfaces()	Yerel bilgisayardaki ağ arabirimlerini açıklayan nesneleri döndürür.
GetIPProperties()	Bu ağ arabiriminin yapılandırmasını açıklayan bir nesne döndürür.
GetIPStatistics()	Bu NetworkInterface örneğin IP istatistiklerini alır.
GetIPv4Statistics()	Bu NetworkInterface örneğin IPv4 istatistiklerini alır.
GetIsNetworkAvailable()	Herhangi bir ağ bağlantısının kullanılabilir olup olmadığını gösterir.
GetPhysicalAddress()	Bu bağdaştırıcının Medya Access Control (MAC) veya fiziksel adresini döndürür.
Supports(NetworkInterfaceComponent)	Arabirimin belirtilen protokolü destekleyip desteklemediğini gösteren bir Boolean değer alır.