Export (0) Print
Expand All

AddressFamily Enumeration

Specifies the addressing scheme that an instance of the Socket class can use.

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

public enum AddressFamily

Member nameDescription
Supported by the .NET Compact FrameworkUnknownUnknown address family.
Supported by the .NET Compact FrameworkUnspecifiedUnspecified address family.
Supported by the .NET Compact FrameworkUnixUnix local to host address.
Supported by the .NET Compact FrameworkInterNetworkAddress for IP version 4.
Supported by the .NET Compact FrameworkImpLinkARPANET IMP address.
Supported by the .NET Compact FrameworkPupAddress for PUP protocols.
Supported by the .NET Compact FrameworkChaosAddress for MIT CHAOS protocols.
Supported by the .NET Compact FrameworkNSAddress for Xerox NS protocols.
Supported by the .NET Compact FrameworkIpxIPX or SPX address.
Supported by the .NET Compact FrameworkIsoAddress for ISO protocols.
Supported by the .NET Compact FrameworkOsiAddress for OSI protocols.
Supported by the .NET Compact FrameworkEcmaEuropean Computer Manufacturers Association (ECMA) address.
Supported by the .NET Compact FrameworkDataKitAddress for Datakit protocols.
Supported by the .NET Compact FrameworkCcittAddresses for CCITT protocols, such as X.25.
Supported by the .NET Compact FrameworkSnaIBM SNA address.
Supported by the .NET Compact FrameworkDecNetDECnet address.
Supported by the .NET Compact FrameworkDataLinkDirect data-link interface address.
Supported by the .NET Compact FrameworkLatLAT address.
Supported by the .NET Compact FrameworkHyperChannelNSC Hyperchannel address.
Supported by the .NET Compact FrameworkAppleTalkAppleTalk address.
Supported by the .NET Compact FrameworkNetBiosNetBios address.
Supported by the .NET Compact FrameworkVoiceViewVoiceView address.
Supported by the .NET Compact FrameworkFireFoxFireFox address.
Supported by the .NET Compact FrameworkBanyanBanyan address.
Supported by the .NET Compact FrameworkAtmNative ATM services address.
Supported by the .NET Compact FrameworkInterNetworkV6Address for IP version 6.
Supported by the .NET Compact FrameworkClusterAddress for Microsoft cluster products.
Supported by the .NET Compact FrameworkIeee12844IEEE 1284.4 workgroup address.
Supported by the .NET Compact FrameworkIrdaIrDA address.
Supported by the .NET Compact FrameworkNetworkDesignersAddress for Network Designers OSI gateway-enabled protocols.
Supported by the .NET Compact FrameworkMaxMAX address.

An AddressFamily member specifies the addressing scheme that a Socket will use to resolve an address. For example, InterNetwork indicates that an IP version 4 address is expected when a Socket connects to an endpoint.

The following example creates a Socket using the InterNetwork AddressFamily.

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"));
   }
 }
#using <mscorlib.dll>
#using <System.dll>

using namespace System;
using namespace System::Text;
using namespace System::IO;
using namespace System::Net;
using namespace System::Net::Sockets;

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: ";
   Get->Concat(server, "\r\nConnection: Close\r\n\r\n");
   Byte ByteGet[] = ASCII->GetBytes(Get);
   Byte RecvBytes[] = new Byte[256];
   String *strRetPage = 0;

   // 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 = 0;
      IPEndPoint *hostEndPoint;
      IPAddress *hostAddress = 0;
      int conPort = 80;

      // Get DNS host information.
      IPHostEntry *hostInfo = Dns::Resolve(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 = 0;
            continue;
         }

         // Sent the GET request to the host.
         s->Send(ByteGet, ByteGet->Length, SocketFlags::None);


      } // 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, SocketFlags::None);
      strRetPage = "Default HTML page on ";
      strRetPage->Concat(server, ":\r\n", ASCII->GetString(RecvBytes, 0, bytes));

      while (bytes > 0)
      {
         bytes = s->Receive(RecvBytes, RecvBytes->Length, SocketFlags::None);
         strRetPage->Concat(ASCII->GetString(RecvBytes, 0, bytes));
      }


   } // End of the try block.

   catch(SocketException *e) 
   {
      Console::WriteLine("SocketException caught!!!");
      Console::Write("Source : ");
      Console::WriteLine(e->Source);
      Console::Write("Message : ");
      Console::WriteLine(e->Message);
   }
   catch(ArgumentNullException *e)
   {
      Console::WriteLine("ArgumentNULLException caught!!!");
      Console::Write("Source : ");
      Console::WriteLine(e->Source);
      Console::Write("Message : ");
      Console::WriteLine(e->Message);
   }
   catch(NullReferenceException *e)
   {
      Console::WriteLine("NULLReferenceException caught!!!");
      Console::Write("Source : ");
      Console::WriteLine(e->Source);
      Console::Write("Message : ");
      Console::WriteLine(e->Message);
   }
   catch(Exception *e)
   {
      Console::WriteLine("Exception caught!!!");
      Console::Write("Source : ");
      Console::WriteLine(e->Source);
      Console::Write("Message : ");
      Console::WriteLine(e->Message);
   }

   return strRetPage;
}

int main()
{
   Console::WriteLine(DoSocketGet("localhost"));
}

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, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

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, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft