AddressFamily 列舉

定義

命名空間:

System.Net.Sockets

組件:

System.Net.Primitives.dll

指定 Socket 類別的執行個體 (Instance) 可以使用的位址配置。

C#

public enum AddressFamily

繼承

Object

ValueType

Enum

AddressFamily

欄位

名稱	值	Description
AppleTalk	16	AppleTalk 位址。
Atm	22	原生 (Native) ATM 服務位址。
Banyan	21	Banyan 位址。
Ccitt	10	CCITT 通訊協定位址，例如 X.25。
Chaos	5	MIT CHAOS 通訊協定位址。
Cluster	24	Microsoft 叢集產品位址。
ControllerAreaNetwork	65537	控制器區域網路位址。
DataKit	9	Datakit 通訊協定位址。
DataLink	13	直接資料連結介面位址。
DecNet	12	DECnet 位址。
Ecma	8	歐洲電腦製造商協會 (ECMA) 位址。
FireFox	19	FireFox 位址。
HyperChannel	15	NSC Hyperchannel 位址。
Ieee12844	25	IEEE 1284.4 工作群組位址。
ImpLink	3	ARPANET IMP 位址。
InterNetwork	2	IP 第 4 版位址。
InterNetworkV6	23	IP 第 6 版位址。
Ipx	6	IPX 或 SPX 位址。
Irda	26	IrDA 位址。
Iso	7	ISO 通訊協定的位址。
Lat	14	LAT 位址。
Max	29	MAX 位址。
NetBios	17	NetBios 位址。
NetworkDesigners	28	Network Designers OSI 閘道器啟用通訊協定位址。
NS	6	Xerox NS 通訊協定位址。
Osi	7	OSI 通訊協定的位址。
Packet	65536	低階封包位址。
Pup	4	PUP 通訊協定的位址。
Sna	11	IBM SNA 位址。
Unix	1	Unix 本機對主機位址。
Unknown	-1	不明的通訊協定家族 (Family)。
Unspecified	0	未指定的通訊協定家族。
VoiceView	18	VoiceView 位址。

範例

下列範例會 Socket 使用 InterNetwork AddressFamily建立 。

C#

using System;
using System.Text;
using System.IO;
using System.Net;
using System.Net.Sockets;

public class Sample
{

  public static string DoSocketGet(string server)
  {
    //Set up variables and String to write to the server.
    Encoding ASCII = Encoding.ASCII;
    string Get = "GET / HTTP/1.1\r\nHost: " + server +
                 "\r\nConnection: Close\r\n\r\n";
    Byte[] ByteGet = ASCII.GetBytes(Get);
    Byte[] RecvBytes = new Byte[256];
    String strRetPage = null;

    // IPAddress and IPEndPoint represent the endpoint that will
    //   receive the request.
    // Get first IPAddress in list return by DNS.

    try
    {

      // Define those variables to be evaluated in the next for loop and
      // then used to connect to the server. These variables are defined
      // outside the for loop to make them accessible there after.
      Socket s = null;
      IPEndPoint hostEndPoint;
      IPAddress hostAddress = null;
      int conPort = 80;

      // Get DNS host information.
      IPHostEntry hostInfo = Dns.GetHostEntry(server);
      // Get the DNS IP addresses associated with the host.
      IPAddress[] IPaddresses = hostInfo.AddressList;

      // Evaluate the socket and receiving host IPAddress and IPEndPoint.
      for (int index=0; index<IPaddresses.Length; index++)
      {
        hostAddress = IPaddresses[index];
        hostEndPoint = new IPEndPoint(hostAddress, conPort);


        // Creates the Socket to send data over a TCP connection.
        s = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp );


        // Connect to the host using its IPEndPoint.
        s.Connect(hostEndPoint);

        if (!s.Connected)
        {
          // Connection failed, try next IPaddress.
          strRetPage = "Unable to connect to host";
          s = null;
          continue;
        }

        // Sent the GET request to the host.
        s.Send(ByteGet, ByteGet.Length, 0);

      } // End of the for loop.


      // Receive the host home page content and loop until all the data is received.
      Int32 bytes = s.Receive(RecvBytes, RecvBytes.Length, 0);
      strRetPage = "Default HTML page on " + server + ":\r\n";
      strRetPage = strRetPage + ASCII.GetString(RecvBytes, 0, bytes);

      while (bytes > 0)
      {
        bytes = s.Receive(RecvBytes, RecvBytes.Length, 0);
        strRetPage = strRetPage + ASCII.GetString(RecvBytes, 0, bytes);
      }

    } // End of the try block.

    catch(SocketException e)
    {
      Console.WriteLine("SocketException caught!!!");
      Console.WriteLine("Source : " + e.Source);
      Console.WriteLine("Message : " + e.Message);
    }
    catch(ArgumentNullException e)
    {
      Console.WriteLine("ArgumentNullException caught!!!");
      Console.WriteLine("Source : " + e.Source);
      Console.WriteLine("Message : " + e.Message);
    }
    catch(NullReferenceException e)
    {
      Console.WriteLine("NullReferenceException caught!!!");
      Console.WriteLine("Source : " + e.Source);
      Console.WriteLine("Message : " + e.Message);
    }
    catch(Exception e)
    {
      Console.WriteLine("Exception caught!!!");
      Console.WriteLine("Source : " + e.Source);
      Console.WriteLine("Message : " + e.Message);
    }

    return strRetPage;
}
   public static void Main()
   {
      Console.WriteLine(DoSocketGet("localhost"));
   }
 }

備註

AddressFamily成員會指定 將用來解析地址的尋址配置Socket。 例如，InterNetwork 表示當 連線到端點時 Socket ，應該要有IP第4版位址。

適用於

另請參閱

• IPAddress
• EndPoint