Partager via

Socket.BeginAccept Méthode

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

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

Surcharges

Nom Description
BeginAccept(AsyncCallback, Object)

Commence une opération asynchrone pour accepter une tentative de connexion entrante.
BeginAccept(Int32, AsyncCallback, Object)

Commence une opération asynchrone pour accepter une tentative de connexion entrante et reçoit le premier bloc de données envoyé par l’application cliente.
BeginAccept(Socket, Int32, AsyncCallback, Object)

Commence une opération asynchrone pour accepter une tentative de connexion entrante à partir d’un socket spécifié et reçoit le premier bloc de données envoyé par l’application cliente.

BeginAccept(AsyncCallback, Object)

Source:
Socket.cs
Source:
Socket.cs
Source:
Socket.cs
Source:
Socket.cs
Source:
Socket.cs

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

public:
 IAsyncResult ^ BeginAccept(AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginAccept(AsyncCallback? callback, object? state);
public IAsyncResult BeginAccept(AsyncCallback callback, object state);
member this.BeginAccept : AsyncCallback * obj -> IAsyncResult
Public Function BeginAccept (callback As AsyncCallback, state As Object) As IAsyncResult

Paramètres

callback
AsyncCallback

Délégué AsyncCallback .

state
Object

Objet qui contient des informations d’état pour cette requête.

Retours

IAsyncResult

Qui IAsyncResult fait référence à la création asynchrone Socket .

Exceptions

ObjectDisposedException

L’objet Socket a été fermé.

InvalidOperationException

Le socket accepté n’écoute pas les connexions. Vous devez appeler et Listen(Int32) avant d’appeler Bind(EndPoint)BeginAccept(AsyncCallback, Object).

- ou -

Le socket accepté est lié.

SocketException

.NET Framework et .NET 5 et versions antérieures uniquement : une erreur s’est produite lors de la tentative d’accès au socket.

Remarques

Important

Il s’agit d’une API de compatibilité. Nous vous déconseillons d’utiliser les méthodes APM (Begin* et End*) pour le nouveau développement. Utilisez plutôt les Taskéquivalents basés sur les valeurs.

Les protocoles orientés connexion peuvent utiliser la BeginAccept méthode pour commencer à accepter les tentatives de connexion entrantes. Avant d’appeler la BeginAccept méthode, vous devez appeler la Listen méthode pour écouter et mettre en file d’attente les demandes de connexion entrantes.

Vous pouvez passer un rappel qui s’implémente AsyncCallbackBeginAccept pour être informé de l’achèvement de l’opération d’acceptation. Notez que si la pile réseau sous-jacente termine l’opération de façon synchrone, le rappel peut être exécuté en ligne, pendant l’appel à BeginAccept. Dans ce cas, la CompletedSynchronously propriété sur le retour IAsyncResult sera définie pour true indiquer que la méthode s’est terminée de façon synchrone. Utilisez la AsyncState propriété de l’objet IAsyncResult d’état passé à la BeginAccept méthode.

L’opération BeginAccept doit être effectuée en appelant la EndAccept méthode. En règle générale, la méthode est appelée par le délégué fourni AsyncCallback . EndAccept bloque le thread appelant jusqu’à ce que l’opération soit terminée.

Pour annuler un appel en attente à la BeginAccept méthode, fermez le Socket. Lorsque la Close méthode est appelée pendant qu’une opération asynchrone est en cours, le rappel fourni à la BeginAccept méthode est appelé. Un appel ultérieur à la EndAccept méthode lève un ObjectDisposedException (avant .NET 7) ou un SocketException (sur .NET 7+) pour indiquer que l’opération a été annulée.

Note

Vous pouvez utiliser la RemoteEndPoint propriété du retourné Socket pour identifier l’adresse réseau et le numéro de port de l’hôte distant.

Note

Si vous recevez un SocketException, utilisez la SocketException.ErrorCode propriété pour obtenir le code d’erreur spécifique.

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.

Note

Le contexte d’exécution (le contexte de sécurité, l’utilisateur emprunt d’identité et le contexte appelant) est mis en cache pour les méthodes asynchrones Socket . Après la première utilisation d’un contexte particulier (une méthode asynchrone Socket spécifique, une instance spécifique et un rappel spécifique Socket ), les utilisations suivantes de ce contexte verront une amélioration des performances.

Voir aussi

S’applique à

BeginAccept(Int32, AsyncCallback, Object)

Source:
Socket.cs
Source:
Socket.cs
Source:
Socket.cs
Source:
Socket.cs
Source:
Socket.cs

Commence une opération asynchrone pour accepter une tentative de connexion entrante et reçoit le premier bloc de données envoyé par l’application cliente.

public:
 IAsyncResult ^ BeginAccept(int receiveSize, AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginAccept(int receiveSize, AsyncCallback? callback, object? state);
public IAsyncResult BeginAccept(int receiveSize, AsyncCallback callback, object state);
member this.BeginAccept : int * AsyncCallback * obj -> IAsyncResult
Public Function BeginAccept (receiveSize As Integer, callback As AsyncCallback, state As Object) As IAsyncResult

Paramètres

receiveSize
Int32

Nombre d’octets à accepter à partir de l’expéditeur.

callback
AsyncCallback

Délégué AsyncCallback .

state
Object

Objet qui contient des informations d’état pour cette requête.

Retours

IAsyncResult

Qui IAsyncResult fait référence à la création asynchrone Socket .

Exceptions

ObjectDisposedException

L’objet Socket a été fermé.

InvalidOperationException

Le socket accepté n’écoute pas les connexions. Vous devez appeler et Listen(Int32) avant d’appeler Bind(EndPoint)BeginAccept(AsyncCallback, Object).

- ou -

Le socket accepté est lié.

ArgumentOutOfRangeException

receiveSize est inférieur à 0.

SocketException

.NET Framework et .NET 5 et versions antérieures uniquement : une erreur s’est produite lors de la tentative d’accès au socket.

Remarques

Important

Il s’agit d’une API de compatibilité. Nous vous déconseillons d’utiliser les méthodes APM (Begin* et End*) pour le nouveau développement. Utilisez plutôt les Taskéquivalents basés sur les valeurs.

Les protocoles orientés connexion peuvent utiliser la BeginAccept méthode pour commencer à accepter les tentatives de connexion entrantes. Avant d’appeler la BeginAccept méthode, vous devez appeler la Listen méthode pour écouter et mettre en file d’attente les demandes de connexion entrantes.

Vous pouvez passer un rappel qui s’implémente AsyncCallbackBeginAccept pour être informé de l’achèvement de l’opération d’acceptation. Notez que si la pile réseau sous-jacente termine l’opération de façon synchrone, le rappel peut être exécuté en ligne, pendant l’appel à BeginAccept. Dans ce cas, la CompletedSynchronously propriété sur le retour IAsyncResult sera définie pour true indiquer que la méthode s’est terminée de façon synchrone. Utilisez la AsyncState propriété de l’objet IAsyncResult d’état passé à la BeginAccept méthode.

L’opération BeginAccept doit être effectuée en appelant la EndAccept méthode. En règle générale, la méthode est appelée par le délégué fourni AsyncCallback . EndAccept bloque le thread appelant jusqu’à ce que l’opération soit terminée.

Pour annuler un appel en attente à la BeginAccept méthode, fermez le Socket. Lorsque la Close méthode est appelée pendant qu’une opération asynchrone est en cours, le rappel fourni à la BeginAccept méthode est appelé. Un appel ultérieur à la EndAccept méthode lève un ObjectDisposedException (avant .NET 7) ou un SocketException (sur .NET 7+) pour indiquer que l’opération a été annulée.

Note

Vous pouvez utiliser la RemoteEndPoint propriété du retourné Socket pour identifier l’adresse réseau et le numéro de port de l’hôte distant.

Note

Si vous recevez un SocketException, utilisez la SocketException.ErrorCode propriété pour obtenir le code d’erreur spécifique.

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.

Note

Le contexte d’exécution (le contexte de sécurité, l’utilisateur emprunt d’identité et le contexte appelant) est mis en cache pour les méthodes asynchrones Socket . Après la première utilisation d’un contexte particulier (une méthode asynchrone Socket spécifique, une instance spécifique et un rappel spécifique Socket ), les utilisations suivantes de ce contexte verront une amélioration des performances.

Voir aussi

S’applique à

BeginAccept(Socket, Int32, AsyncCallback, Object)

Source:
Socket.cs
Source:
Socket.cs
Source:
Socket.cs
Source:
Socket.cs
Source:
Socket.cs

Commence une opération asynchrone pour accepter une tentative de connexion entrante à partir d’un socket spécifié et reçoit le premier bloc de données envoyé par l’application cliente.

public:
 IAsyncResult ^ BeginAccept(System::Net::Sockets::Socket ^ acceptSocket, int receiveSize, AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginAccept(System.Net.Sockets.Socket? acceptSocket, int receiveSize, AsyncCallback? callback, object? state);
public IAsyncResult BeginAccept(System.Net.Sockets.Socket acceptSocket, int receiveSize, AsyncCallback callback, object state);
member this.BeginAccept : System.Net.Sockets.Socket * int * AsyncCallback * obj -> IAsyncResult
Public Function BeginAccept (acceptSocket As Socket, receiveSize As Integer, callback As AsyncCallback, state As Object) As IAsyncResult

Paramètres

acceptSocket
Socket

Objet accepté Socket . Cette valeur peut être null.

receiveSize
Int32

Nombre maximal d’octets à recevoir.

callback
AsyncCallback

Délégué AsyncCallback .

state
Object

Objet qui contient des informations d’état pour cette requête.

Retours

IAsyncResult

Objet IAsyncResult qui fait référence à la création d’objets asynchrones Socket .

Exceptions

ObjectDisposedException

L’objet Socket a été fermé.

InvalidOperationException

Le socket accepté n’écoute pas les connexions. Vous devez appeler et Listen(Int32) avant d’appeler Bind(EndPoint)BeginAccept(AsyncCallback, Object).

- ou -

Le socket accepté est lié.

ArgumentOutOfRangeException

receiveSize est inférieur à 0.

SocketException

.NET Framework et .NET 5 et versions antérieures uniquement : une erreur s’est produite lors de la tentative d’accès au socket.

Remarques

Important

Il s’agit d’une API de compatibilité. Nous vous déconseillons d’utiliser les méthodes APM (Begin* et End*) pour le nouveau développement. Utilisez plutôt les Taskéquivalents basés sur les valeurs.

Les protocoles orientés connexion peuvent utiliser la BeginAccept méthode pour commencer à accepter les tentatives de connexion entrantes. L’opération d’acceptation résultante est représentée par le retour IAsyncResult même s’il peut se terminer de façon synchrone. Avant d’appeler la BeginAccept méthode, vous devez appeler la Listen méthode pour écouter et mettre en file d’attente les demandes de connexion entrantes.

Vous pouvez passer un rappel qui s’implémente AsyncCallbackBeginAccept pour être informé de l’achèvement de l’opération d’acceptation. Notez que si la pile réseau sous-jacente termine l’opération de façon synchrone, le rappel peut être exécuté en ligne, pendant l’appel à BeginAccept. Dans ce cas, la CompletedSynchronously propriété sur le retour IAsyncResult sera définie pour true indiquer que la méthode s’est terminée de façon synchrone. Utilisez la AsyncState propriété de l’objet IAsyncResult d’état passé à la BeginAccept méthode.

L’opération BeginAccept doit être effectuée en appelant la EndAccept méthode. En règle générale, la méthode est appelée par le délégué fourni AsyncCallback . EndAccept bloque le thread appelant jusqu’à ce que l’opération soit terminée.

Pour annuler un appel en attente à la BeginAccept méthode, fermez le Socket. Lorsque la Close méthode est appelée pendant qu’une opération asynchrone est en cours, le rappel fourni à la BeginAccept méthode est appelé. Un appel ultérieur à la EndAccept méthode lève un ObjectDisposedException (avant .NET 7) ou un SocketException (sur .NET 7+) pour indiquer que l’opération a été annulée.

Note

Vous pouvez utiliser la RemoteEndPoint propriété du retourné Socket pour identifier l’adresse réseau et le numéro de port de l’hôte distant.

Note

Si vous recevez un SocketException, utilisez la SocketException.ErrorCode propriété pour obtenir le code d’erreur spécifique.

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.

Note

Le contexte d’exécution (le contexte de sécurité, l’utilisateur emprunt d’identité et le contexte appelant) est mis en cache pour les méthodes asynchrones Socket . Après la première utilisation d’un contexte particulier (une méthode asynchrone Socket spécifique, une instance spécifique et un rappel spécifique Socket ), les utilisations suivantes de ce contexte verront une amélioration des performances.

Voir aussi

S’applique à