Socket, classe

La classe Socket fournit une grande variété de méthodes et de propriétés pour les communications réseau. La classe Socket vous permet d'effectuer des transferts de données synchrones et asynchrones à l'aide de n'importe quel protocole de communication répertorié dans l'énumération ProtocolType.

La classe Socket suit le modèle de désignation .NET Framework pour les méthodes asynchrones. Par exemple, la méthode synchrone Receive correspond aux méthodes asynchrones BeginReceive et EndReceive.

Si votre application nécessite un seul thread au cours de l'exécution, utilisez les méthodes suivantes, conçues pour le mode de fonctionnement synchrone.

• Si vous utilisez un protocole orienté connexion tel que TCP, votre serveur peut écouter les connexions à l'aide de la méthode Listen. La méthode Accept traite toutes les demandes de connexion entrantes et retourne un Socket que vous pouvez utiliser pour la communication de données avec l'hôte distant. Utilisez ce Socket retourné pour appeler la méthode Send ou Receive. Appelez la méthode Bind avant d'appeler la méthode Listen si vous voulez spécifier l'adresse IP locale et le numéro de port. Utilisez le numéro de port zéro si vous souhaitez que le fournisseur de services sous-jacent vous assigne un port libre. Si vous voulez vous connecter à un hôte à l'écoute, appelez la méthode Connect. Pour communiquer des données, appelez la méthode Send ou Receive.

• Si vous utilisez un protocole sans connexion, tel que UDP, vous n'avez pas du tout besoin d'écouter les connexions. Appelez la méthode ReceiveFrom pour accepter tous les datagrammes entrants. Utilisez la méthode SendTo pour envoyer des datagrammes à un hôte distant.

Pour traiter les communications à l'aide de threads séparés au cours de l'exécution, utilisez les méthodes suivantes, conçues pour le mode de fonctionnement asynchrone.

• Si vous utilisez un protocole orienté connexion tel que TCP, utilisez Socket, la méthode BeginConnect et la méthode EndConnect pour vous connecter à un hôte à l'écoute. Utilisez les méthodes BeginSend et EndSend ou BeginReceive et EndReceive pour communiquer des données de manière asynchrone. Les demandes de connexion entrantes peuvent être traitées à l'aide des méthodes BeginAccept et EndAccept.

• Si vous utilisez un protocole sans connexion tel que UDP, vous pouvez utiliser les méthodes BeginSendTo et EndSendTo pour envoyer des datagrammes, ainsi que les méthodes BeginReceiveFrom et EndReceiveFrom pour recevoir des datagrammes.

Si vous exécutez plusieurs opérations asynchrones sur un socket, elles ne se terminent pas nécessairement dans l'ordre dans lequel elles sont exécutées.

Une fois l'envoi ou la réception de données terminé, utilisez la méthode Shutdown pour désactiver le Socket. Après avoir appelé Shutdown, appelez la méthode Close pour libérer toutes les ressources associées à Socket.

La classe Socket vous permet de configurer Socket à l'aide de la méthode SetSocketOption. Récupérez ces paramètres à l'aide de la méthode GetSocketOption.

Remarque
Si vous écrivez une application relativement simple et si vous n'avez pas besoin des performances maximales, préférez l'utilisation de TcpClient, TcpListener et UdpClient. Ces classes fournissent une interface plus simple et plus conviviale pour les communications de Socket.

L'exemple de code suivant montre comment la classe Socket peut être utilisée pour envoyer des données à un serveur HTTP et recevoir la réponse de celui-ci. Cet exemple entraîne un blocage jusqu'à la réception de la totalité de la page.

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

public class GetSocket
{
    private static Socket ConnectSocket(string server, int port)
    {
        Socket s = null;
        IPHostEntry hostEntry = null;

        // Get host related information.
        hostEntry = Dns.GetHostEntry(server);

        // Loop through the AddressList to obtain the supported AddressFamily. This is to avoid
        // an exception that occurs when the host IP Address is not compatible with the address family
        // (typical in the IPv6 case).
        foreach(IPAddress address in hostEntry.AddressList)
        {
            IPEndPoint ipe = new IPEndPoint(address, port);
            Socket tempSocket = 
                new Socket(ipe.AddressFamily, SocketType.Stream, ProtocolType.Tcp);

            tempSocket.Connect(ipe);

            if(tempSocket.Connected)
            {
                s = tempSocket;
                break;
            }
            else
            {
                continue;
            }
        }
        return s;
    }

    // This method requests the home page content for the specified server.
    private static string SocketSendReceive(string server, int port) 
    {
        string request = "GET / HTTP/1.1\r\nHost: " + server + 
            "\r\nConnection: Close\r\n\r\n";
        Byte[] bytesSent = Encoding.ASCII.GetBytes(request);
        Byte[] bytesReceived = new Byte[256];

        // Create a socket connection with the specified server and port.
        Socket s = ConnectSocket(server, port);

        if (s == null)
            return ("Connection failed");

        // Send request to the server.
        s.Send(bytesSent, bytesSent.Length, 0);  

        // Receive the server home page content.
        int bytes = 0;
        string page = "Default HTML page on " + server + ":\r\n";

        // The following will block until te page is transmitted.
        do {
            bytes = s.Receive(bytesReceived, bytesReceived.Length, 0);
            page = page + Encoding.ASCII.GetString(bytesReceived, 0, bytes);
        }
        while (bytes > 0);

        return page;
    }

    public static void Main(string[] args) 
    {
        string host;
        int port = 80;

        if (args.Length == 0)
            // If no server name is passed as argument to this program, 
            // use the current host name as the default.
            host = Dns.GetHostName();
        else
            host = args[0];

        string result = SocketSendReceive(host, port); 
        Console.WriteLine(result);
    }
}

.NET Framework

.NET Framework Client Profile

• SocketPermission  

  Établir une connexion sortante ou accepter une demande entrante.

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Les instances de cette classe sont thread-safe.

Référence

Autres ressources