Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Socket.Socket(AddressFamily, SocketType, ProtocolType) Constructor

Initializes a new instance of the Socket class using the specified address family, socket type and protocol.

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

public Socket (
	AddressFamily addressFamily,
	SocketType socketType,
	ProtocolType protocolType
)
public Socket (
	AddressFamily addressFamily, 
	SocketType socketType, 
	ProtocolType protocolType
)
public function Socket (
	addressFamily : AddressFamily, 
	socketType : SocketType, 
	protocolType : ProtocolType
)
Not applicable.

Parameters

addressFamily

One of the AddressFamily values.

socketType

One of the SocketType values.

protocolType

One of the ProtocolType values.

Exception typeCondition

SocketException

The combination of addressFamily, socketType, and protocolType results in an invalid socket.

The addressFamily parameter specifies the addressing scheme that the Socket class uses, the socketType parameter specifies the type of the Socket class, and the protocolType parameter specifies the protocol used by Socket. The three parameters are not independent. Some address families restrict which protocols can be used with them, and often the Socket type is implicit in the protocol. If the combination of address family, Socket type, and protocol type results in an invalid Socket, this constructor throws a SocketException.

NoteNote:

If this constructor throws a SocketException, use the SocketException.ErrorCode property to obtain the specific error code. After you have obtained this code, refer to the Windows Sockets version 2 API error code documentation in the MSDN library for a detailed description of the error.

NoteNote:

This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

The following code example demonstrates how to create an instance of the Socket class.

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

import System.*;
import System.Text.*;
import System.IO.*;
import System.Net.*;
import 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.get_ASCII();
        String get = "GET / HTTP/1.1\r\nHost: " + server
            + "\r\nConnection: Close\r\n\r\n";
        System.Byte byteGet[] = (System.Byte[])ascii.GetBytes(get);
        System.Byte recvBytes[] = new System.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.Resolve(server);
            // Get the DNS IP addresses associated with the host.
            IPAddress IPaddresses[] = hostInfo.get_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.get_Connected())) {
                    // Connection failed, try next IPaddress.
                    strRetPage = "Unable to connect to host";
                    s = null;
                    continue;
                }
                // Sent the GET request to the host.
                s.Send((ubyte[])byteGet, byteGet.get_Length(), (SocketFlags)0);
            } // End of the for loop.      
            // Receive the host home page content and loop until all the 
            // data is received.
            Int32 bytes = (Int32)s.Receive((ubyte[])recvBytes,
                recvBytes.get_Length(), (SocketFlags)0);
            strRetPage = "Default HTML page on " + server + ":\r\n";
            strRetPage = strRetPage + ascii.GetString((ubyte[])recvBytes,
                0, Convert.ToInt32(bytes));

            while (Convert.ToInt32(bytes) > 0) {
                bytes = (Int32)s.Receive((ubyte[])recvBytes,
                    recvBytes.get_Length(), (SocketFlags)0);
                strRetPage = strRetPage
                    + ascii.GetString((ubyte[])recvBytes, 0,
                    Convert.ToInt32(bytes));
            }
        } // End of the try block.
        catch (SocketException e) {
            Console.WriteLine("SocketException caught!!!");
            Console.WriteLine("Source : " + e.get_Source());
            Console.WriteLine("Message : " + e.get_Message());
        }
        catch (ArgumentNullException e) {
            Console.WriteLine("ArgumentNullException caught!!!");
            Console.WriteLine("Source : " + e.get_Source());
            Console.WriteLine("Message : " + e.get_Message());
        }
        catch (NullReferenceException e) {
            Console.WriteLine("NullReferenceException caught!!!");
            Console.WriteLine("Source : " + e.get_Source());
            Console.WriteLine("Message : " + e.get_Message());
        }
        catch (System.Exception e) {
            Console.WriteLine("Exception caught!!!");
            Console.WriteLine("Source : " + e.get_Source());
            Console.WriteLine("Message : " + e.get_Message());
        }
        return strRetPage;
    } //DoSocketGet

    public static void main(String[] args)
    {
        Console.WriteLine(DoSocketGet("localhost"));
    } //main
} //Sample

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft