ICommunicationObject.BeginOpen ICommunicationObject.BeginOpen ICommunicationObject.BeginOpen ICommunicationObject.BeginOpen Method

Définition

Commence une opération asynchrone pour fermer un objet de communication.Begins an asynchronous operation to close a communication object.

Surcharges

BeginOpen(AsyncCallback, Object) BeginOpen(AsyncCallback, Object) BeginOpen(AsyncCallback, Object) BeginOpen(AsyncCallback, Object)

Commence une opération asynchrone pour ouvrir un objet de communication.Begins an asynchronous operation to open a communication object.

BeginOpen(TimeSpan, AsyncCallback, Object) BeginOpen(TimeSpan, AsyncCallback, Object) BeginOpen(TimeSpan, AsyncCallback, Object) BeginOpen(TimeSpan, AsyncCallback, Object)

Commence une opération asynchrone pour ouvrir un objet de communication dans un intervalle de temps spécifié.Begins an asynchronous operation to open a communication object within a specified interval of time.

Remarques

La méthode BeginOpen provoque l'entrée d'un ICommunicationObject dans l'état Opening où il reste jusqu'à ce que sa transition à l'état Opened soit terminée ou échoue.The BeginOpen method causes an ICommunicationObject to enter into the Opening state where it remains until its transition to the Opened state is completed or fails.

Des versions avec et sans délai d'attente explicite sont fournies.Versions with and without an explicit timeout are provided.

BeginOpen(AsyncCallback, Object) BeginOpen(AsyncCallback, Object) BeginOpen(AsyncCallback, Object) BeginOpen(AsyncCallback, Object)

Commence une opération asynchrone pour ouvrir un objet de communication.Begins an asynchronous operation to open a communication object.

public:
 IAsyncResult ^ BeginOpen(AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginOpen (AsyncCallback callback, object state);
abstract member BeginOpen : AsyncCallback * obj -> IAsyncResult
Public Function BeginOpen (callback As AsyncCallback, state As Object) As IAsyncResult

Paramètres

callback
AsyncCallback AsyncCallback AsyncCallback AsyncCallback

Le délégué AsyncCallback qui reçoit la notification de la fin de l'opération d'ouverture asynchrone.The AsyncCallback delegate that receives notification of the completion of the asynchronous open operation.

state
Object Object Object Object

Objet, spécifié par l'application, qui contient des informations d'état associées à l'opération d'ouverture asynchrone.An object, specified by the application, that contains state information associated with the asynchronous open operation.

Retours

IAsyncResult qui fait référence à l'opération asynchrone d'ouverture.The IAsyncResult that references the asynchronous open operation.

Exceptions

L'ICommunicationObject n'a pas pu être ouvert et est entré dans l'état Faulted.The ICommunicationObject was unable to be opened and has entered the Faulted state.

Le délai d'attente d'ouverture par défaut s'est écoulé avant que le ICommunicationObject ait pu entrer dans l'état Opened et est entré l'état Faulted.The default open timeout elapsed before the ICommunicationObject was able to enter the Opened state and has entered the Faulted state.

Remarques

Lorsqu'un ICommunicationObject est instancié, il commence dans l'état Created.When an ICommunicationObject is instantiated, it begins in the Created state. Dans l'état Created, l'objet peut être configuré (par exemple, les propriétés peuvent être définies ou les événements peuvent être enregistrés), mais il n'est pas cependant pas utilisable pour l'envoi ou la réception de messages.In the Created state, the object can be configured (for example, properties can be set, or events can be registered), but it is not yet usable to send or receive messages. La méthode BeginOpen provoque l'entrée d'un ICommunicationObject dans l'état Opening où il reste jusqu'à ce que l'opération d'ouverture aboutisse, que le délai de l'opération soit dépassé ou qu'elle échoue et que l'objet entre dans un état d'erreur, ou que l'ICommunicationObject soit abandonné.The BeginOpen method causes an ICommunicationObject to enter into the Opening state where it remains until the open operation succeeds, the open operation times out or fails and the object becomes faulted, or the ICommunicationObject is aborted.

Dans l'état Opened, l'ICommunicationObject est utilisable (par exemple, les messages peuvent être reçus), mais il n'est plus configurable.In the Opened state, the ICommunicationObject is usable (for example, messages can be received), but it is no longer configurable.

BeginOpen(TimeSpan, AsyncCallback, Object) BeginOpen(TimeSpan, AsyncCallback, Object) BeginOpen(TimeSpan, AsyncCallback, Object) BeginOpen(TimeSpan, AsyncCallback, Object)

Commence une opération asynchrone pour ouvrir un objet de communication dans un intervalle de temps spécifié.Begins an asynchronous operation to open a communication object within a specified interval of time.

public:
 IAsyncResult ^ BeginOpen(TimeSpan timeout, AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginOpen (TimeSpan timeout, AsyncCallback callback, object state);
abstract member BeginOpen : TimeSpan * AsyncCallback * obj -> IAsyncResult
Public Function BeginOpen (timeout As TimeSpan, callback As AsyncCallback, state As Object) As IAsyncResult

Paramètres

timeout
TimeSpan TimeSpan TimeSpan TimeSpan

TimeSpan qui spécifie le délai d'exécution de l'opération d'envoi avant dépassement du délai d'attente.The TimeSpan that specifies how long the send operation has to complete before timing out.

callback
AsyncCallback AsyncCallback AsyncCallback AsyncCallback

Le délégué AsyncCallback qui reçoit la notification de la fin de l'opération d'ouverture asynchrone.The AsyncCallback delegate that receives notification of the completion of the asynchronous open operation.

state
Object Object Object Object

Objet, spécifié par l'application, qui contient des informations d'état associées à l'opération d'ouverture asynchrone.An object, specified by the application, that contains state information associated with the asynchronous open operation.

Retours

IAsyncResult qui fait référence à l'opération asynchrone d'ouverture.The IAsyncResult that references the asynchronous open operation.

Exceptions

L'ICommunicationObject n'a pas pu être ouvert et est entré dans l'état Faulted.The ICommunicationObject was unable to be opened and has entered the Faulted state.

Le délai d'attente spécifié s'est écoulé avant que le ICommunicationObject ait pu entrer dans l'état Opened et est entré l'état Faulted.The specified timeout elapsed before the ICommunicationObject was able to enter the Opened state and has entered the Faulted state.

Remarques

Lorsqu'un ICommunicationObject est instancié, il commence dans l'état Created.When an ICommunicationObject is instantiated, it begins in the Created state. Dans l'état Created, l'objet peut être configuré (par exemple, les propriétés peuvent être définies ou les événements peuvent être enregistrés), mais il n'est pas cependant pas utilisable pour l'envoi ou la réception de messages.In the Created state, the object can be configured (for example, properties can be set, or events can be registered), but it is not yet usable to send or receive messages. La méthode Open provoque l'entrée d'un ICommunicationObject dans l'état Opening où il reste jusqu'à ce que l'opération d'ouverture aboutisse, que le délai de l'opération soit dépassé ou qu'elle échoue et que l'objet entre dans un état d'erreur, ou que l'ICommunicationObject soit abandonné.The Open method causes an ICommunicationObject to enter into the Opening state where it remains until the open operation succeeds, the open operation times out or fails and the object becomes faulted, or the ICommunicationObject is aborted.

Dans l'état Opened, l'ICommunicationObject est utilisable (par exemple, les messages peuvent être reçus), mais il n'est plus configurable.In the Opened state, the ICommunicationObject is usable (for example, messages can be received), but it is no longer configurable.

Notes pour les responsables de l’implémentation

L'opération doit lever une TimeoutException si le timeout spécifié est dépassé.The operation must throw a TimeoutException if the specified timeout is exceeded.

S’applique à