Socket Constructeurs

Définition

Espace de noms:: System.Net.Sockets

Assemblys:: netstandard.dll, System.Net.Sockets.dll

Assembly:: System.Net.Sockets.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Assemblys:: System.dll, System.Net.Sockets.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Initialise une nouvelle instance de la classe Socket.

Surcharges

Nom	Description
Socket(SafeSocketHandle)	Initialise une nouvelle instance de la Socket classe pour le handle de socket spécifié.
Socket(SocketInformation)	Initialise une nouvelle instance de la Socket classe à l’aide de la valeur spécifiée retournée par DuplicateAndClose(Int32).
Socket(SocketType, ProtocolType)	Initialise une nouvelle instance de la Socket classe à l’aide du type et du protocole de socket spécifiés. Si le système d’exploitation prend en charge IPv6, ce constructeur crée un socket double mode ; sinon, il crée un socket IPv4.
Socket(AddressFamily, SocketType, ProtocolType)	Initialise une nouvelle instance de la Socket classe à l’aide de la famille d’adresses, du type de socket et du protocole spécifiés.

Socket(SafeSocketHandle)

Source:: Socket.cs

Source:: Socket.cs

Source:: Socket.cs

Source:: Socket.cs

Source:: Socket.cs

Initialise une nouvelle instance de la Socket classe pour le handle de socket spécifié.

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)

Paramètres

handle: SafeSocketHandle

Handle de socket pour le socket que l’objet Socket encapsule.

Exceptions

ArgumentNullException

handle a la valeur null.

ArgumentException

handle n’est pas valide.

SocketException

handle n’est pas un socket ou des informations sur le socket ne sont pas accessibles.

Remarques

Cette méthode remplit l’instance Socket avec les données collectées à partir de l’instance fournie SafeSocketHandle. Différents systèmes d’exploitation fournissent différents niveaux de prise en charge pour interroger un descripteur de socket ou un descripteur de fichier pour ses propriétés et sa configuration. Certaines API publiques sur l’instance résultante Socket peuvent différer en fonction du système d’exploitation, tel que ProtocolType et Blocking.

S’applique à

Socket(SocketInformation)

Source:: Socket.cs

Source:: Socket.cs

Source:: Socket.cs

Source:: Socket.cs

Source:: Socket.cs

Initialise une nouvelle instance de la Socket classe à l’aide de la valeur spécifiée retournée par DuplicateAndClose(Int32).

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

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

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

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

Public Sub New (socketInformation As SocketInformation)

Paramètres

socketInformation: SocketInformation

Informations de socket retournées par DuplicateAndClose(Int32).

Attributs: SupportedOSPlatformAttribute

Remarques

Si vous appelez le Socket constructeur plusieurs fois avec le même tableau d’octets que l’argument de chaque appel, vous allez créer plusieurs s managés Socketavec le même socket sous-jacent. Cette pratique est fortement déconseillée.

S’applique à

Socket(SocketType, ProtocolType)

Source:: Socket.cs

Source:: Socket.cs

Source:: Socket.cs

Source:: Socket.cs

Source:: Socket.cs

Initialise une nouvelle instance de la Socket classe à l’aide du type et du protocole de socket spécifiés. Si le système d’exploitation prend en charge IPv6, ce constructeur crée un socket double mode ; sinon, il crée 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)

Paramètres

socketType: SocketType

Une des SocketType valeurs.

protocolType: ProtocolType

Une des ProtocolType valeurs.

Exceptions

SocketException

La combinaison d’un socketType socket non valide et protocolType aboutit à une combinaison de sockets non valide.

Remarques

Le socketType paramètre spécifie le type de la Socket classe et le protocolType paramètre spécifie le protocole utilisé par Socket. Les deux paramètres ne sont pas indépendants. Souvent, le Socket type est implicite dans le protocole. Si la combinaison de Socket type et de type de protocole entraîne un non valide Socket, ce constructeur lève un SocketException.

Note

Si ce constructeur lève un SocketException, utilisez la SocketException.ErrorCode propriété pour obtenir le code d’erreur spécifique. Une fois que vous avez obtenu ce code, reportez-vous à la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.

Note

Ce membre génère des informations de suivi lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.

S’applique à

Socket(AddressFamily, SocketType, ProtocolType)

Source:: Socket.cs

Source:: Socket.cs

Source:: Socket.cs

Source:: Socket.cs

Source:: Socket.cs

Initialise une nouvelle instance de la Socket classe à l’aide de la famille d’adresses, du type de socket et du protocole spécifiés.

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)

Paramètres

addressFamily: AddressFamily

Une des AddressFamily valeurs.

socketType: SocketType

Une des SocketType valeurs.

protocolType: ProtocolType

Une des ProtocolType valeurs.

Exceptions

SocketException

La combinaison de addressFamily, socketTypeet protocolType aboutit à un socket non valide.

Exemples

L’exemple de code suivant montre comment créer une instance de la Socket classe.

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

Remarques

Le addressFamily paramètre spécifie le schéma d’adressage utilisé par la Socket classe, le socketType paramètre spécifie le type de la Socket classe et le protocolType paramètre spécifie le protocole utilisé par Socket. Les trois paramètres ne sont pas indépendants. Certaines familles d’adresses limitent les protocoles qui peuvent être utilisés avec eux, et souvent le Socket type est implicite dans le protocole. Si la combinaison de la famille d’adresses, Socket du type et du type de protocole entraîne un non valide Socket, ce constructeur lève un SocketException.

Note

Ce membre génère des informations de suivi lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.

Voir aussi

S’applique à

Commentaires

Cette page a-t-elle été utile ?

Partager via

Socket Constructeurs

Définition

Surcharges

Socket(SafeSocketHandle)

Paramètres

Exceptions

Remarques

S’applique à

Socket(SocketInformation)

Paramètres

Remarques

S’applique à

Socket(SocketType, ProtocolType)

Paramètres

Exceptions

Remarques

S’applique à

Socket(AddressFamily, SocketType, ProtocolType)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

Commentaires