Socket Constructores

Definición

Espacio de nombres:

System.Net.Sockets

Ensamblados:

netstandard.dll, System.Net.Sockets.dll

Inicializa una nueva instancia de la clase Socket.

Sobrecargas

Nombre	Description
Socket(SafeSocketHandle)	Inicializa una nueva instancia de la Socket clase para el identificador de socket especificado.
Socket(SocketInformation)	Inicializa una nueva instancia de la Socket clase utilizando el valor especificado devuelto de DuplicateAndClose(Int32).
Socket(SocketType, ProtocolType)	Inicializa una nueva instancia de la Socket clase utilizando el tipo de socket y el protocolo especificados. Si el sistema operativo admite IPv6, este constructor crea un socket de modo dual; de lo contrario, crea un socket IPv4.
Socket(AddressFamily, SocketType, ProtocolType)	Inicializa una nueva instancia de la Socket clase utilizando la familia de direcciones, el tipo de socket y el protocolo especificados.

Socket(SafeSocketHandle)

Source:

Socket.cs

Inicializa una nueva instancia de la Socket clase para el identificador de socket especificado.

public:
 Socket(System::Net::Sockets::SafeSocketHandle ^ handle);

public Socket(System.Net.Sockets.SafeSocketHandle handle);

new System.Net.Sockets.Socket : System.Net.Sockets.SafeSocketHandle -> System.Net.Sockets.Socket

Public Sub New (handle As SafeSocketHandle)

Parámetros

handle

SafeSocketHandle

Identificador de socket para el socket que el Socket objeto encapsulará.

Excepciones

ArgumentNullException

handle es null.

ArgumentException

handle no es válido.

SocketException

handle no es un socket o no se pudo tener acceso a información sobre el socket.

Comentarios

Este método rellena la Socket instancia con los datos recopilados del proporcionado SafeSocketHandle. Los distintos sistemas operativos proporcionan distintos niveles de compatibilidad para consultar un identificador de socket o descriptor de archivo para sus propiedades y configuración. Algunas de las API públicas de la instancia resultante Socket pueden diferir en función del sistema operativo, como ProtocolType y Blocking.

Socket(SocketInformation)

Source:

Socket.cs

Inicializa una nueva instancia de la Socket clase utilizando el valor especificado devuelto de DuplicateAndClose(Int32).

public:
 Socket(System::Net::Sockets::SocketInformation socketInformation);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public Socket(System.Net.Sockets.SocketInformation socketInformation);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
new System.Net.Sockets.Socket : System.Net.Sockets.SocketInformation -> System.Net.Sockets.Socket

Public Sub New (socketInformation As SocketInformation)

Parámetros

socketInformation

SocketInformation

Información de socket devuelta por DuplicateAndClose(Int32).

Atributos

SupportedOSPlatformAttribute

Comentarios

Si llama al Socket constructor varias veces con la misma matriz de bytes que el argumento para cada llamada, creará varios administrados Socketcon el mismo socket subyacente. Esta práctica es muy desaconsejada.

Socket(SocketType, ProtocolType)

Source:

Socket.cs

Inicializa una nueva instancia de la Socket clase utilizando el tipo de socket y el protocolo especificados. Si el sistema operativo admite IPv6, este constructor crea un socket de modo dual; de lo contrario, crea un socket IPv4.

public:
 Socket(System::Net::Sockets::SocketType socketType, System::Net::Sockets::ProtocolType protocolType);

public Socket(System.Net.Sockets.SocketType socketType, System.Net.Sockets.ProtocolType protocolType);

new System.Net.Sockets.Socket : System.Net.Sockets.SocketType * System.Net.Sockets.ProtocolType -> System.Net.Sockets.Socket

Public Sub New (socketType As SocketType, protocolType As ProtocolType)

Parámetros

socketType

SocketType

Uno de los SocketType valores.

protocolType

ProtocolType

Uno de los ProtocolType valores.

Excepciones

SocketException

La combinación de socketType y protocolType da como resultado un socket no válido.

Comentarios

El socketType parámetro especifica el tipo de la Socket clase y el protocolType parámetro especifica el protocolo utilizado por Socket. Los dos parámetros no son independientes. A menudo, el Socket tipo está implícito en el protocolo. Si la combinación de Socket tipo y tipo de protocolo da como resultado un valor no válido Socket, este constructor produce una SocketExceptionexcepción .

Nota:

Si este constructor produce una SocketExceptionexcepción , use la SocketException.ErrorCode propiedad para obtener el código de error específico. Después de obtener este código, consulte la documentación del código de error de la API de Windows Sockets versión 2 para obtener una descripción detallada del error.

Nota:

Este miembro genera información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, consulte Seguimiento de red en .NET Framework.

Socket(AddressFamily, SocketType, ProtocolType)

Source:

Socket.cs

Inicializa una nueva instancia de la Socket clase utilizando la familia de direcciones, el tipo de socket y el protocolo especificados.

public:
 Socket(System::Net::Sockets::AddressFamily addressFamily, System::Net::Sockets::SocketType socketType, System::Net::Sockets::ProtocolType protocolType);

public Socket(System.Net.Sockets.AddressFamily addressFamily, System.Net.Sockets.SocketType socketType, System.Net.Sockets.ProtocolType protocolType);

new System.Net.Sockets.Socket : System.Net.Sockets.AddressFamily * System.Net.Sockets.SocketType * System.Net.Sockets.ProtocolType -> System.Net.Sockets.Socket

Public Sub New (addressFamily As AddressFamily, socketType As SocketType, protocolType As ProtocolType)

Parámetros

addressFamily

AddressFamily

Uno de los AddressFamily valores.

socketType

SocketType

Uno de los SocketType valores.

protocolType

ProtocolType

Uno de los ProtocolType valores.

Excepciones

SocketException

La combinación de addressFamily, socketTypey protocolType da como resultado un socket no válido.

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear una instancia de la Socket clase .

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

Imports System.Text
Imports System.IO
Imports System.Net
Imports System.Net.Sockets

 _

Public Class Sample
   
   
   Public Shared Function DoSocketGet(server As String) As String
      'Set up variables and String to write to the server.
    Dim ASCII As Encoding = Encoding.ASCII
    Dim [Get] As String = "GET / HTTP/1.1" + ControlChars.Lf + ControlChars.NewLine + "Host: " + server + ControlChars.Lf + ControlChars.NewLine + "Connection: Close" + ControlChars.Lf + ControlChars.NewLine + ControlChars.Lf + ControlChars.NewLine
    Dim ByteGet As [Byte]() = ASCII.GetBytes([Get])
    Dim RecvBytes(256) As [Byte]
    Dim strRetPage As [String] = Nothing


      
      ' 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.
         Dim s As Socket = Nothing
         Dim hostEndPoint As IPEndPoint
         Dim hostAddress As IPAddress = Nothing
         Dim conPort As Integer = 80
         
         ' Get DNS host information.
         Dim hostInfo As IPHostEntry = Dns.Resolve(server)
         ' Get the DNS IP addresses associated with the host.
         Dim IPaddresses As IPAddress() = hostInfo.AddressList
         
         ' Evaluate the socket and receiving host IPAddress and IPEndPoint. 
      Dim index As Integer = 0
      For index = 0 To IPaddresses.Length - 1
        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 Not s.Connected Then
          ' Connection failed, try next IPaddress.
          strRetPage = "Unable to connect to host"
          s = Nothing
          GoTo ContinueFor1
        End If


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


ContinueFor1:
      Next index  ' End of the for loop.
      



      ' Receive the host home page content and loop until all the data is received.

      'Dim bytes As Int32 = s.Receive(RecvBytes, RecvBytes.Length, 0)
      Dim bytes As Int32 = s.Receive(RecvBytes, RecvBytes.Length, 0)

      strRetPage = "Default HTML page on " + server + ":\r\n"
      strRetPage = "Default HTML page on " + server + ":" + ControlChars.Lf + ControlChars.NewLine

      Dim i As Integer

      While bytes > 0

        bytes = s.Receive(RecvBytes, RecvBytes.Length, 0)

        strRetPage = strRetPage + ASCII.GetString(RecvBytes, 0, bytes)

      End While


      ' End of the try block.
    Catch e As SocketException
         Console.WriteLine("SocketException caught!!!")
         Console.WriteLine(("Source : " + e.Source))
         Console.WriteLine(("Message : " + e.Message))
      Catch e As ArgumentNullException
         Console.WriteLine("ArgumentNullException caught!!!")
         Console.WriteLine(("Source : " + e.Source))
         Console.WriteLine(("Message : " + e.Message))
      Catch e As NullReferenceException
         Console.WriteLine("NullReferenceException caught!!!")
         Console.WriteLine(("Source : " + e.Source))
         Console.WriteLine(("Message : " + e.Message))
      Catch e As Exception
         Console.WriteLine("Exception caught!!!")
         Console.WriteLine(("Source : " + e.Source))
         Console.WriteLine(("Message : " + e.Message))
      End Try
      
      Return strRetPage
   End Function 'DoSocketGet
    
   Public Shared Sub Main()
    Console.WriteLine(DoSocketGet("localhost"))
   End Sub
End Class

Comentarios

El addressFamily parámetro especifica el esquema de direccionamiento que usa la Socket clase , el socketType parámetro especifica el tipo de la Socket clase y el protocolType parámetro especifica el protocolo utilizado por Socket. Los tres parámetros no son independientes. Algunas familias de direcciones restringen qué protocolos se pueden usar con ellos y, a menudo, el Socket tipo está implícito en el protocolo. Si la combinación de la familia de direcciones, Socket el tipo y el tipo de protocolo da como resultado un valor no válido Socket, este constructor produce una SocketExceptionexcepción .

Nota:

Si este constructor produce una SocketExceptionexcepción , use la SocketException.ErrorCode propiedad para obtener el código de error específico. Después de obtener este código, consulte la documentación del código de error de la API de Windows Sockets versión 2 para obtener una descripción detallada del error.

Nota:

Este miembro genera información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, consulte Seguimiento de red en .NET Framework.

Consulte también

• SocketException
• AddressFamily
• ProtocolType
• SocketType