Socket Classe

Définition

Implémente l'interface de sockets Berkeley.

public ref class Socket : IDisposable
public class Socket : IDisposable
type Socket = class
    interface IDisposable
Public Class Socket
Implements IDisposable
Héritage
Socket
Implémente

Exemples

L’exemple suivant montre comment la Socket classe peut être utilisée pour envoyer des données à un serveur HTTP, en imprimant la réponse ASCII à la sortie standard. Cet exemple montre comment bloquer le thread appelant jusqu’à ce que la page entière soit reçue.

private static void SendHttpRequest(Uri? uri = null, int port = 80)
{
    uri ??= new Uri("http://example.com");

    // Construct a minimalistic HTTP/1.1 request
    byte[] requestBytes = Encoding.ASCII.GetBytes(@$"GET {uri.AbsoluteUri} HTTP/1.0
Host: {uri.Host}
Connection: Close

");

    // Create and connect a dual-stack socket
    using Socket socket = new Socket(SocketType.Stream, ProtocolType.Tcp);
    socket.Connect(uri.Host, port);

    // Send the request.
    // For the tiny amount of data in this example, the first call to Send() will likely deliver the buffer completely,
    // however this is not guaranteed to happen for larger real-life buffers.
    // The best practice is to iterate until all the data is sent.
    int bytesSent = 0;
    while (bytesSent < requestBytes.Length)
    {
        bytesSent += socket.Send(requestBytes, bytesSent, requestBytes.Length - bytesSent, SocketFlags.None);
    }

    // Do minimalistic buffering assuming ASCII response
    byte[] responseBytes = new byte[256];
    char[] responseChars = new char[256];

    while (true)
    {
        int bytesReceived = socket.Receive(responseBytes);

        // Receiving 0 bytes means EOF has been reached
        if (bytesReceived == 0) break;

        // Convert byteCount bytes to ASCII characters using the 'responseChars' buffer as destination
        int charCount = Encoding.ASCII.GetChars(responseBytes, 0, bytesReceived, responseChars, 0);

        // Print the contents of the 'responseChars' buffer to Console.Out
        Console.Out.Write(responseChars, 0, charCount);
    }
}

L’exemple suivant illustre le même scénario HTTP GET, utilisant des API asynchrones basées sur des tâches, tout en transférant un CancellationToken vers les méthodes asynchrones, ce qui rend l’opération entière annulable.

Conseil

Socketles méthodes asynchrones qui ne prennent pas de CancellationToken retournent généralement un Task, qui est alloué sur le tas. Les surcharges annulables sont toujours ValueTaskretournées ; leur utilisation permet de réduire les allocations dans le code hautes performances.

private static async Task SendHttpRequestAsync(Uri? uri = null, int port = 80, CancellationToken cancellationToken = default)
{
    uri ??= new Uri("http://example.com");

    // Construct a minimalistic HTTP/1.1 request
    byte[] requestBytes = Encoding.ASCII.GetBytes(@$"GET {uri.AbsoluteUri} HTTP/1.1
Host: {uri.Host}
Connection: Close

");

    // Create and connect a dual-stack socket
    using Socket socket = new Socket(SocketType.Stream, ProtocolType.Tcp);
    await socket.ConnectAsync(uri.Host, port, cancellationToken);

    // Send the request.
    // For the tiny amount of data in this example, the first call to SendAsync() will likely deliver the buffer completely,
    // however this is not guaranteed to happen for larger real-life buffers.
    // The best practice is to iterate until all the data is sent.
    int bytesSent = 0;
    while (bytesSent < requestBytes.Length)
    {
        bytesSent += await socket.SendAsync(requestBytes.AsMemory(bytesSent), SocketFlags.None);
    }

    // Do minimalistic buffering assuming ASCII response
    byte[] responseBytes = new byte[256];
    char[] responseChars = new char[256];

    while (true)
    {
        int bytesReceived = await socket.ReceiveAsync(responseBytes, SocketFlags.None, cancellationToken);

        // Receiving 0 bytes means EOF has been reached
        if (bytesReceived == 0) break;

        // Convert byteCount bytes to ASCII characters using the 'responseChars' buffer as destination
        int charCount = Encoding.ASCII.GetChars(responseBytes, 0, bytesReceived, responseChars, 0);

        // Print the contents of the 'responseChars' buffer to Console.Out
        await Console.Out.WriteAsync(responseChars.AsMemory(0, charCount), cancellationToken);
    }
}

Remarques

Pour plus d’informations sur cette API, consultez Remarques supplémentaires sur l’API pour Socket.

Constructeurs

Socket(AddressFamily, SocketType, ProtocolType)

Initialise une nouvelle instance de la classe Socket en utilisant la famille d'adresses, le type de socket et le protocole spécifiés.

Socket(SafeSocketHandle)

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

Socket(SocketInformation)

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

Socket(SocketType, ProtocolType)

Initialise une nouvelle instance de la classe Socket à l'aide du type de socket et du protocole 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.

Propriétés

AddressFamily

Obtient la famille d'adresses de Socket.

Available

Obtient la quantité de données reçues du réseau et disponibles pour la lecture.

Blocking

Obtient ou définit une valeur qui indique si Socket est en mode blocage.

Connected

Obtient une valeur qui indique si Socket est connecté à un hôte distant depuis la dernière opération Send ou Receive.

DontFragment

Récupère ou définit une valeur qui spécifie si Socket autorise la fragmentation des datagrammes IP (protocole Internet).

DualMode

Obtient ou définit une valeur qui spécifie si est Socket un socket double mode utilisé pour IPv4 et IPv6.

EnableBroadcast

Obtient ou définit une Boolean valeur qui spécifie si le Socket peut envoyer des paquets de diffusion.

ExclusiveAddressUse

Obtient ou définit une valeur Boolean qui spécifie si Socket n'autorise qu'un seul processus à se lier à un port.

Handle

Obtient le handle du système d'exploitation pour Socket.

IsBound

Obtient une valeur qui indique si Socket est lié à un port local spécifique.

LingerState

Obtient ou définit une valeur qui spécifie si Socket doit différer la fermeture d'un socket lors d'une tentative d'envoi de l'ensemble des données en attente.

LocalEndPoint

Obtient le point de terminaison local.

MulticastLoopback

Obtient ou définit une valeur spécifiant si les paquets multicast sortants sont remis à l'application émettrice.

NoDelay

Obtient ou définit une valeur Boolean spécifiant si le flux de données Socket utilise l'algorithme Nagle.

OSSupportsIPv4

Indique si le système d'exploitation et les cartes réseau sous-jacents prennent en charge le protocole IPv4 (Internet Protocol version 4).

OSSupportsIPv6

Indique si le système d'exploitation et les cartes réseau sous-jacents prennent en charge le protocole IPv6 (Internet Protocol version 6).

OSSupportsUnixDomainSockets

Indique si le système d’exploitation sous-jacent prend en charge les sockets de domaine Unix.

ProtocolType

Obtient le type de protocole de Socket.

ReceiveBufferSize

Obtient ou définit une valeur spécifiant la taille de la mémoire tampon de réception de Socket.

ReceiveTimeout

Obtient ou définit une valeur spécifiant la durée après laquelle un appel Receive synchrone doit expirer.

RemoteEndPoint

Obtient le point de terminaison distant.

SafeHandle

Obtient un SafeSocketHandle qui représente le descripteur de socket que l’objet Socket actuel encapsule.

SendBufferSize

Obtient ou définit une valeur spécifiant la taille de la mémoire tampon d'envoi de Socket.

SendTimeout

Obtient ou définit une valeur spécifiant la durée après laquelle un appel Send synchrone doit expirer.

SocketType

Obtient le type de Socket.

SupportsIPv4
Obsolète.
Obsolète.
Obsolète.

Obtient une valeur indiquant si la prise en charge d'IPv4 est disponible et active sur l'hôte en cours.

SupportsIPv6
Obsolète.
Obsolète.
Obsolète.

Obtient une valeur qui indique si le Framework prend en charge le protocole IPv6 pour certains membres Dns obsolètes.

Ttl

Obtient ou définit une valeur qui spécifie la durée de vie des paquets IP (Internet Protocol) envoyés par Socket.

UseOnlyOverlappedIO
Obsolète.

Obtient ou définit une valeur qui spécifie si le socket doit utiliser uniquement le mode d’E/S avec chevauchement. Sur .NET 5+ (y compris les versions de .NET Core), la valeur est toujours false.

Méthodes

Accept()

Crée un nouveau Socket pour une connexion nouvellement créée.

AcceptAsync()

Accepte une connexion entrante.

AcceptAsync(CancellationToken)

Accepte une connexion entrante.

AcceptAsync(Socket)

Accepte une connexion entrante.

AcceptAsync(Socket, CancellationToken)

Accepte une connexion entrante.

AcceptAsync(SocketAsyncEventArgs)

Démarre une opération asynchrone pour accepter une tentative de connexion entrante.

BeginAccept(AsyncCallback, Object)

Démarre une opération asynchrone pour accepter une tentative de connexion entrante.

BeginAccept(Int32, AsyncCallback, Object)

Lance une opération asynchrone d'acceptation d'une tentative de connexion entrante et reçoit le premier bloc de données envoyé par l'application cliente.

BeginAccept(Socket, Int32, AsyncCallback, Object)

Lance une opération asynchrone d'acceptation d'une tentative de connexion entrante provenant d'un socket spécifié et reçoit le premier bloc de données envoyé par l'application cliente.

BeginConnect(EndPoint, AsyncCallback, Object)

Démarre une demande asynchrone pour une connexion d'hôte distant.

BeginConnect(IPAddress, Int32, AsyncCallback, Object)

Démarre une demande asynchrone pour une connexion d'hôte distant. L’hôte est spécifié par IPAddress et un numéro de port.

BeginConnect(IPAddress[], Int32, AsyncCallback, Object)

Démarre une demande asynchrone pour une connexion d'hôte distant. L’hôte est spécifié par un tableau IPAddress et un numéro de port.

BeginConnect(String, Int32, AsyncCallback, Object)

Démarre une demande asynchrone pour une connexion d'hôte distant. L’hôte est spécifié par un nom d’hôte et un numéro de port.

BeginDisconnect(Boolean, AsyncCallback, Object)

Lance une demande asynchrone de déconnexion d'un point de terminaison distant.

BeginReceive(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object)

Démarre la réception asynchrone de données à partir d'un Socket connecté.

BeginReceive(Byte[], Int32, Int32, SocketFlags, SocketError, AsyncCallback, Object)

Démarre la réception asynchrone de données à partir d'un Socket connecté.

BeginReceive(IList<ArraySegment<Byte>>, SocketFlags, AsyncCallback, Object)

Démarre la réception asynchrone de données à partir d'un Socket connecté.

BeginReceive(IList<ArraySegment<Byte>>, SocketFlags, SocketError, AsyncCallback, Object)

Démarre la réception asynchrone de données à partir d'un Socket connecté.

BeginReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint, AsyncCallback, Object)

Démarre la réception asynchrone de données à partir d'un périphérique réseau spécifié.

BeginReceiveMessageFrom(Byte[], Int32, Int32, SocketFlags, EndPoint, AsyncCallback, Object)

Démarre la réception asynchrone du nombre spécifié d’octets de données dans l’emplacement spécifié de la mémoire tampon de données, à l’aide du SocketFlags spécifié et stocke le point de terminaison ainsi que les informations sur le paquet.

BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object)

Envoie des données de façon asynchrone à un Socket connecté.

BeginSend(Byte[], Int32, Int32, SocketFlags, SocketError, AsyncCallback, Object)

Envoie des données de façon asynchrone à un Socket connecté.

BeginSend(IList<ArraySegment<Byte>>, SocketFlags, AsyncCallback, Object)

Envoie des données de façon asynchrone à un Socket connecté.

BeginSend(IList<ArraySegment<Byte>>, SocketFlags, SocketError, AsyncCallback, Object)

Envoie des données de façon asynchrone à un Socket connecté.

BeginSendFile(String, AsyncCallback, Object)

Envoie le fichier fileName à un objet Socket connecté à l'aide de l'indicateur UseDefaultWorkerThread.

BeginSendFile(String, Byte[], Byte[], TransmitFileOptions, AsyncCallback, Object)

Envoie de façon asynchrone un fichier et des mémoires tampon de données à un objet Socket connecté.

BeginSendTo(Byte[], Int32, Int32, SocketFlags, EndPoint, AsyncCallback, Object)

Envoie des données de façon asynchrone à un hôte distant spécifique.

Bind(EndPoint)

Associe Socket à un point de terminaison local.

CancelConnectAsync(SocketAsyncEventArgs)

Annule une requête asynchrone pour une connexion d'hôte distant.

Close()

Ferme la connexion Socket et libère toutes les ressources associées.

Close(Int32)

Ferme la connexion Socket et libère toutes les ressources associées avec un délai d’attente spécifié pour permettre l’envoi des données en file d’attente.

Connect(EndPoint)

Établit une connexion à un hôte distant.

Connect(IPAddress, Int32)

Établit une connexion à un hôte distant. L’hôte est spécifié par une adresse IP et un numéro de port.

Connect(IPAddress[], Int32)

Établit une connexion à un hôte distant. L’hôte est spécifié par un tableau d’adresses IP et un numéro de port.

Connect(String, Int32)

Établit une connexion à un hôte distant. L’hôte est spécifié par un nom d’hôte et un numéro de port.

ConnectAsync(EndPoint)

Établit une connexion à un hôte distant.

ConnectAsync(EndPoint, CancellationToken)

Établit une connexion à un hôte distant.

ConnectAsync(IPAddress, Int32)

Établit une connexion à un hôte distant.

ConnectAsync(IPAddress, Int32, CancellationToken)

Établit une connexion à un hôte distant.

ConnectAsync(IPAddress[], Int32)

Établit une connexion à un hôte distant.

ConnectAsync(IPAddress[], Int32, CancellationToken)

Établit une connexion à un hôte distant.

ConnectAsync(SocketAsyncEventArgs)

Démarre une demande asynchrone pour une connexion à un hôte distant.

ConnectAsync(SocketType, ProtocolType, SocketAsyncEventArgs)

Démarre une demande asynchrone pour une connexion à un hôte distant.

ConnectAsync(String, Int32)

Établit une connexion à un hôte distant.

ConnectAsync(String, Int32, CancellationToken)

Établit une connexion à un hôte distant.

Disconnect(Boolean)

Ferme la connexion de socket et autorise la réutilisation du socket.

DisconnectAsync(Boolean, CancellationToken)

Déconnecte un socket connecté de l’hôte distant.

DisconnectAsync(SocketAsyncEventArgs)

Lance une demande asynchrone de déconnexion d'un point de terminaison distant.

Dispose()

Libère toutes les ressources utilisées par l'instance actuelle de la classe Socket.

Dispose(Boolean)

Libère les ressources non managées utilisées par Socket et supprime éventuellement les ressources managées.

DuplicateAndClose(Int32)

Duplique la référence de socket pour le processus cible et ferme le socket pour ce processus.

EndAccept(Byte[], IAsyncResult)

Accepte de manière asynchrone une tentative de connexion entrante et crée un nouvel objet Socket pour gérer les communications de l'hôte distant. Cette méthode retourne une mémoire tampon qui contient les données initiales transférées.

EndAccept(Byte[], Int32, IAsyncResult)

Accepte de manière asynchrone une tentative de connexion entrante et crée un nouvel objet Socket pour gérer les communications de l'hôte distant. Cette méthode retourne une mémoire tampon qui contient les données initiales et le nombre d'octets transférés.

EndAccept(IAsyncResult)

Accepte de manière asynchrone une tentative de connexion entrante et crée un nouveau Socket pour gérer les communications de l'hôte distant.

EndConnect(IAsyncResult)

Met fin à une demande de connexion asynchrone en attente.

EndDisconnect(IAsyncResult)

Met fin à une demande de déconnexion asynchrone en attente.

EndReceive(IAsyncResult)

Met fin à une lecture asynchrone en attente.

EndReceive(IAsyncResult, SocketError)

Met fin à une lecture asynchrone en attente.

EndReceiveFrom(IAsyncResult, EndPoint)

Met fin à une lecture asynchrone en attente à partir d'un point de terminaison spécifique.

EndReceiveMessageFrom(IAsyncResult, SocketFlags, EndPoint, IPPacketInformation)

Met fin à une lecture asynchrone en attente à partir d'un point de terminaison spécifique. Cette méthode révèle également davantage d'informations sur le paquet que EndReceiveFrom(IAsyncResult, EndPoint).

EndSend(IAsyncResult)

Met fin à un envoi asynchrone en attente.

EndSend(IAsyncResult, SocketError)

Met fin à un envoi asynchrone en attente.

EndSendFile(IAsyncResult)

Met fin à un envoi asynchrone en attente d'un fichier.

EndSendTo(IAsyncResult)

Met fin à un envoi asynchrone en attente vers un emplacement spécifique.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
Finalize()

Libère les ressources utilisées par la classe Socket.

GetHashCode()

Retourne une valeur de hachage pour une instance de Socket.

GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetRawSocketOption(Int32, Int32, Span<Byte>)

Obtient une valeur d’option de socket à l’aide d’identificateurs de nom et de niveau propres à la plateforme.

GetSocketOption(SocketOptionLevel, SocketOptionName)

Retourne la valeur d'une option Socket spécifiée, représentée sous la forme d'un objet.

GetSocketOption(SocketOptionLevel, SocketOptionName, Byte[])

Retourne la valeur de l'option Socket spécifiée sous la forme d'un tableau d'octets.

GetSocketOption(SocketOptionLevel, SocketOptionName, Int32)

Retourne la valeur de l'option Socket spécifiée dans un tableau.

GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
IOControl(Int32, Byte[], Byte[])

Définit les modes de fonctionnement de bas niveau de Socket à l'aide de codes de contrôle numériques.

IOControl(IOControlCode, Byte[], Byte[])

Définit les modes de fonctionnement de bas niveau de Socket à l'aide de l'énumération IOControlCode afin de spécifier les codes de contrôle.

Listen()

Met Socket dans un état d'écoute.

Listen(Int32)

Met Socket dans un état d'écoute.

MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
Poll(Int32, SelectMode)

Détermine l'état de Socket.

Poll(TimeSpan, SelectMode)

Détermine l'état de Socket.

Receive(Byte[])

Reçoit les données d'un Socket lié dans une mémoire tampon de réception.

Receive(Byte[], Int32, Int32, SocketFlags)

Reçoit le nombre spécifié d'octets d'un Socket lié dans la position d'offset spécifiée de la mémoire tampon de réception, à l'aide du SocketFlags spécifié.

Receive(Byte[], Int32, Int32, SocketFlags, SocketError)

Reçoit les données d'un Socket lié dans une mémoire tampon de réception, à l'aide du SocketFlags spécifié.

Receive(Byte[], Int32, SocketFlags)

Reçoit le nombre spécifié d'octets de données d'un Socket lié dans une mémoire tampon de réception, à l'aide du SocketFlags spécifié.

Receive(Byte[], SocketFlags)

Reçoit les données d'un Socket lié dans une mémoire tampon de réception, à l'aide du SocketFlags spécifié.

Receive(IList<ArraySegment<Byte>>)

Reçoit les données d'un Socket lié dans la liste des mémoires tampon de réception.

Receive(IList<ArraySegment<Byte>>, SocketFlags)

Reçoit les données d'un Socket lié dans la liste des mémoires tampon de réception, à l'aide du SocketFlags spécifié.

Receive(IList<ArraySegment<Byte>>, SocketFlags, SocketError)

Reçoit les données d'un Socket lié dans la liste des mémoires tampon de réception, à l'aide du SocketFlags spécifié.

Receive(Span<Byte>)

Reçoit les données d'un Socket lié dans une mémoire tampon de réception.

Receive(Span<Byte>, SocketFlags)

Reçoit les données d'un Socket lié dans une mémoire tampon de réception, à l'aide du SocketFlags spécifié.

Receive(Span<Byte>, SocketFlags, SocketError)

Reçoit les données d'un Socket lié dans une mémoire tampon de réception, à l'aide du SocketFlags spécifié.

ReceiveAsync(ArraySegment<Byte>)

Reçoit des données à partir d’un socket connecté.

ReceiveAsync(ArraySegment<Byte>, SocketFlags)

Reçoit des données à partir d’un socket connecté.

ReceiveAsync(IList<ArraySegment<Byte>>)

Reçoit des données à partir d’un socket connecté.

ReceiveAsync(IList<ArraySegment<Byte>>, SocketFlags)

Reçoit des données à partir d’un socket connecté.

ReceiveAsync(Memory<Byte>, CancellationToken)

Reçoit des données à partir d’un socket connecté.

ReceiveAsync(Memory<Byte>, SocketFlags, CancellationToken)

Reçoit des données à partir d’un socket connecté.

ReceiveAsync(SocketAsyncEventArgs)

Démarre une demande asynchrone pour recevoir les données d'un objet Socket connecté.

ReceiveFrom(Byte[], EndPoint)

Reçoit un datagramme dans la mémoire tampon de données et stocke le point de terminaison.

ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)

Reçoit le nombre d’octets de données spécifié dans l’emplacement de la mémoire tampon spécifié à l’aide des SocketFlags et stocke le point de terminaison.

ReceiveFrom(Byte[], Int32, SocketFlags, EndPoint)

Reçoit le nombre spécifié d'octets dans la mémoire tampon de données, à l'aide du SocketFlags spécifié et stocke le point de terminaison.

ReceiveFrom(Byte[], SocketFlags, EndPoint)

Reçoit un datagramme dans la mémoire tampon de données à l'aide du SocketFlags spécifié et stocke le point de terminaison.

ReceiveFrom(Span<Byte>, EndPoint)

Reçoit un datagramme dans la mémoire tampon de données et stocke le point de terminaison.

ReceiveFrom(Span<Byte>, SocketFlags, EndPoint)

Reçoit un datagramme dans la mémoire tampon de données à l'aide du SocketFlags spécifié et stocke le point de terminaison.

ReceiveFrom(Span<Byte>, SocketFlags, SocketAddress)

Reçoit un datagramme dans la mémoire tampon de données à l'aide du SocketFlags spécifié et stocke le point de terminaison.

ReceiveFromAsync(ArraySegment<Byte>, EndPoint)

Reçoit des données et retourne le point de terminaison de l’hôte d’envoi.

ReceiveFromAsync(ArraySegment<Byte>, SocketFlags, EndPoint)

Reçoit des données et retourne le point de terminaison de l’hôte d’envoi.

ReceiveFromAsync(Memory<Byte>, EndPoint, CancellationToken)

Reçoit des données et retourne le point de terminaison de l’hôte d’envoi.

ReceiveFromAsync(Memory<Byte>, SocketFlags, EndPoint, CancellationToken)

Reçoit des données et retourne le point de terminaison de l’hôte d’envoi.

ReceiveFromAsync(Memory<Byte>, SocketFlags, SocketAddress, CancellationToken)

Reçoit un datagramme dans la mémoire tampon de données à l'aide du SocketFlags spécifié et stocke le point de terminaison.

ReceiveFromAsync(SocketAsyncEventArgs)

Démarre la réception asynchrone de données à partir d'un périphérique réseau spécifié.

ReceiveMessageFrom(Byte[], Int32, Int32, SocketFlags, EndPoint, IPPacketInformation)

Reçoit le nombre d’octets de données spécifié à l’emplacement de la mémoire tampon spécifié à l’aide des SocketFlags spécifiés, puis stocke les informations de paquet et de point de terminaison.

ReceiveMessageFrom(Span<Byte>, SocketFlags, EndPoint, IPPacketInformation)

Reçoit le nombre d’octets de données spécifié à l’emplacement de la mémoire tampon spécifié à l’aide des socketFlags spécifiés, puis stocke les informations de paquet et de point de terminaison.

ReceiveMessageFromAsync(ArraySegment<Byte>, EndPoint)

Reçoit des données et retourne des informations supplémentaires sur l’expéditeur du message.

ReceiveMessageFromAsync(ArraySegment<Byte>, SocketFlags, EndPoint)

Reçoit des données et retourne des informations supplémentaires sur l’expéditeur du message.

ReceiveMessageFromAsync(Memory<Byte>, EndPoint, CancellationToken)

Reçoit des données et retourne des informations supplémentaires sur l’expéditeur du message.

ReceiveMessageFromAsync(Memory<Byte>, SocketFlags, EndPoint, CancellationToken)

Reçoit des données et retourne des informations supplémentaires sur l’expéditeur du message.

ReceiveMessageFromAsync(SocketAsyncEventArgs)

Démarre la réception asynchrone du nombre spécifié d'octets de données dans l'emplacement spécifié de la mémoire tampon de données, à l'aide du SocketFlags spécifié et stocke le point de terminaison ainsi que les informations sur le paquet.

Select(IList, IList, IList, Int32)

Détermine l’état d’un ou plusieurs sockets.

Select(IList, IList, IList, TimeSpan)

Détermine l’état d’un ou plusieurs sockets.

Send(Byte[])

Envoie des données à un Socket connecté.

Send(Byte[], Int32, Int32, SocketFlags)

Envoie le nombre spécifié d’octets de données à un Socket connecté, à part de l’offset spécifié et avec le SocketFlags spécifié.

Send(Byte[], Int32, Int32, SocketFlags, SocketError)

Envoie le nombre spécifié d’octets de données à un Socket connecté, à part de l’offset spécifié et avec le SocketFlags spécifié.

Send(Byte[], Int32, SocketFlags)

Reçoit le nombre spécifié d'octets de données à un Socket connecté, à l'aide du SocketFlags spécifié.

Send(Byte[], SocketFlags)

Envoie des données à un Socket connecté à l'aide du SocketFlags spécifié.

Send(IList<ArraySegment<Byte>>)

Envoie le jeu de mémoires tampon dans la liste à un Socket connecté.

Send(IList<ArraySegment<Byte>>, SocketFlags)

Envoie le jeu de mémoires tampon dans la liste à un Socket connecté, à l'aide du SocketFlags spécifié.

Send(IList<ArraySegment<Byte>>, SocketFlags, SocketError)

Envoie le jeu de mémoires tampon dans la liste à un Socket connecté, à l'aide du SocketFlags spécifié.

Send(ReadOnlySpan<Byte>)

Envoie des données à un Socket connecté.

Send(ReadOnlySpan<Byte>, SocketFlags)

Envoie des données à un Socket connecté à l'aide du SocketFlags spécifié.

Send(ReadOnlySpan<Byte>, SocketFlags, SocketError)

Envoie des données à un Socket connecté à l'aide du SocketFlags spécifié.

SendAsync(ArraySegment<Byte>)

Envoie des données sur un socket connecté.

SendAsync(ArraySegment<Byte>, SocketFlags)

Envoie des données sur un socket connecté.

SendAsync(IList<ArraySegment<Byte>>)

Envoie des données sur un socket connecté.

SendAsync(IList<ArraySegment<Byte>>, SocketFlags)

Envoie des données sur un socket connecté.

SendAsync(ReadOnlyMemory<Byte>, CancellationToken)

Envoie des données sur un socket connecté.

SendAsync(ReadOnlyMemory<Byte>, SocketFlags, CancellationToken)

Envoie des données sur un socket connecté.

SendAsync(SocketAsyncEventArgs)

Envoie des données de façon asynchrone à un objet Socket connecté.

SendFile(String)

Envoie le fichier fileName à un objet Socket connecté avec l'indicateur de transmission UseDefaultWorkerThread.

SendFile(String, Byte[], Byte[], TransmitFileOptions)

Envoie le fileName et les tampons de données du fichier à un objet Socket connecté à l’aide de la valeur TransmitFileOptions spécifiée.

SendFile(String, ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, TransmitFileOptions)

Envoie le fileName et les tampons de données du fichier à un objet Socket connecté à l’aide de la valeur TransmitFileOptions spécifiée.

SendFileAsync(String, CancellationToken)

Envoie le fichier fileName à un objet connecté Socket .

SendFileAsync(String, ReadOnlyMemory<Byte>, ReadOnlyMemory<Byte>, TransmitFileOptions, CancellationToken)

Envoie le fileName et les tampons de données du fichier à un objet Socket connecté à l’aide de la valeur TransmitFileOptions spécifiée.

SendPacketsAsync(SocketAsyncEventArgs)

Envoie une collection de fichiers ou des données mises en mémoire tampon de façon asynchrone à un objet Socket connecté.

SendTo(Byte[], EndPoint)

Envoie les données au point de terminaison spécifié.

SendTo(Byte[], Int32, Int32, SocketFlags, EndPoint)

Envoie le nombre spécifié d'octets de données au point de terminaison spécifié, en commençant à l'emplacement spécifié dans la mémoire tampon et en utilisant le SocketFlags spécifié.

SendTo(Byte[], Int32, SocketFlags, EndPoint)

Envoie le nombre spécifié d'octets de données au point de terminaison spécifié à l'aide du SocketFlags spécifié.

SendTo(Byte[], SocketFlags, EndPoint)

Envoie des données à un point de terminaison spécifique à l'aide du SocketFlags spécifié.

SendTo(ReadOnlySpan<Byte>, EndPoint)

Envoie les données au point de terminaison spécifié.

SendTo(ReadOnlySpan<Byte>, SocketFlags, EndPoint)

Envoie des données à un point de terminaison spécifique à l'aide du SocketFlags spécifié.

SendTo(ReadOnlySpan<Byte>, SocketFlags, SocketAddress)

Envoie des données à un point de terminaison spécifique à l'aide du SocketFlags spécifié.

SendToAsync(ArraySegment<Byte>, EndPoint)

Envoie des données à l’hôte distant spécifié.

SendToAsync(ArraySegment<Byte>, SocketFlags, EndPoint)

Envoie des données à l’hôte distant spécifié.

SendToAsync(ReadOnlyMemory<Byte>, EndPoint, CancellationToken)

Envoie des données à l’hôte distant spécifié.

SendToAsync(ReadOnlyMemory<Byte>, SocketFlags, EndPoint, CancellationToken)

Envoie des données à l’hôte distant spécifié.

SendToAsync(ReadOnlyMemory<Byte>, SocketFlags, SocketAddress, CancellationToken)

Envoie des données à un point de terminaison spécifique à l'aide du SocketFlags spécifié.

SendToAsync(SocketAsyncEventArgs)

Envoie des données de façon asynchrone à un hôte distant spécifique.

SetIPProtectionLevel(IPProtectionLevel)

Définit le niveau de protection IP sur un socket.

SetRawSocketOption(Int32, Int32, ReadOnlySpan<Byte>)

Définit une valeur d’option de socket à l’aide d’identificateurs de nom et de niveau propres à la plateforme.

SetSocketOption(SocketOptionLevel, SocketOptionName, Boolean)

Affecte la valeur Socket spécifiée à l'option Boolean spécifiée.

SetSocketOption(SocketOptionLevel, SocketOptionName, Byte[])

Affecte la valeur spécifiée à l'option Socket spécifiée représentée sous la forme d'un tableau d'octets.

SetSocketOption(SocketOptionLevel, SocketOptionName, Int32)

Affecte la valeur entière spécifiée à l'option Socket spécifiée.

SetSocketOption(SocketOptionLevel, SocketOptionName, Object)

Affecte la valeur spécifiée à l'option Socket spécifiée représentée sous la forme d'un objet.

Shutdown(SocketShutdown)

Désactive les envois et les réceptions sur un Socket.

ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

Implémentations d’interfaces explicites

IDisposable.Dispose()

Cette API prend en charge l'infrastructure du produit et n'est pas destinée à être utilisée directement à partir de votre code.

Libère toutes les ressources utilisées par Socket.

Méthodes d’extension

AcceptAsync(Socket)

Effectue une opération asynchrone pour accepter une tentative de connexion entrante sur le socket.

AcceptAsync(Socket, Socket)

Effectue une opération asynchrone pour accepter une tentative de connexion entrante sur le socket.

ConnectAsync(Socket, EndPoint)

Établit une connexion à un hôte distant.

ConnectAsync(Socket, EndPoint, CancellationToken)

Établit une connexion à un hôte distant.

ConnectAsync(Socket, IPAddress, Int32)

Établit une connexion à un hôte distant. L’hôte est spécifié par une adresse IP et un numéro de port.

ConnectAsync(Socket, IPAddress, Int32, CancellationToken)

Établit une connexion à un hôte distant, qui est spécifié par une adresse IP et un numéro de port.

ConnectAsync(Socket, IPAddress[], Int32)

Établit une connexion à un hôte distant. L’hôte est spécifié par un tableau d’adresses IP et un numéro de port.

ConnectAsync(Socket, IPAddress[], Int32, CancellationToken)

Établit une connexion à un hôte distant, qui est spécifié par un tableau d’adresses IP et un numéro de port.

ConnectAsync(Socket, String, Int32)

Établit une connexion à un hôte distant. L’hôte est spécifié par un nom d’hôte et un numéro de port.

ConnectAsync(Socket, String, Int32, CancellationToken)

Établit une connexion à un hôte distant, qui est spécifié par un nom d'hôte et un numéro de port.

ReceiveAsync(Socket, ArraySegment<Byte>, SocketFlags)

Reçoit des données à partir d’un socket connecté.

ReceiveAsync(Socket, IList<ArraySegment<Byte>>, SocketFlags)

Reçoit des données à partir d’un socket connecté.

ReceiveAsync(Socket, Memory<Byte>, SocketFlags, CancellationToken)

Reçoit des données à partir d’un socket connecté.

ReceiveFromAsync(Socket, ArraySegment<Byte>, SocketFlags, EndPoint)

Reçoit des données à partir d’un périphérique réseau spécifié.

ReceiveMessageFromAsync(Socket, ArraySegment<Byte>, SocketFlags, EndPoint)

Reçoit le nombre d’octets de données spécifié à l’emplacement de la mémoire tampon spécifié à l’aide des SocketFlags spécifiés, puis stocke les informations de paquet et de point de terminaison.

SendAsync(Socket, ArraySegment<Byte>, SocketFlags)

Envoie des données à un socket connecté.

SendAsync(Socket, IList<ArraySegment<Byte>>, SocketFlags)

Envoie des données à un socket connecté.

SendAsync(Socket, ReadOnlyMemory<Byte>, SocketFlags, CancellationToken)

Envoie des données à un socket connecté.

SendToAsync(Socket, ArraySegment<Byte>, SocketFlags, EndPoint)

Envoie des données de façon asynchrone à un hôte distant spécifique.

S’applique à

Cohérence de thread

Il est sûr d’effectuer une opération d’envoi et de réception simultanément sur un Socket instance, mais il n’est pas recommandé d’émettre simultanément plusieurs appels d’envoi ou de réception. Selon l’implémentation de la plateforme sous-jacente, cela peut entraîner un entrelacement involontaire des données pour les envois ou les réceptions volumineux ou multi-tampons.

Voir aussi