ICommunicationObject.BeginOpen Méthode

Définition

Espace de noms:

System.ServiceModel

Assembly:

System.ServiceModel.Primitives.dll

Assembly:

System.ServiceModel.dll

Commence une opération asynchrone pour ouvrir un objet de communication.

Surcharges

BeginOpen(AsyncCallback, Object)	Commence une opération asynchrone pour ouvrir un objet de communication.
BeginOpen(TimeSpan, AsyncCallback, Object)	Commence une opération asynchrone pour ouvrir un objet de communication dans un intervalle de temps spécifié.

Remarques

La BeginOpen méthode provoque une ICommunicationObject entrée dans l’état Opening où elle reste jusqu’à ce que sa transition vers l’état Opened soit terminée ou échoue.

Des versions avec et sans délai d'attente explicite sont fournies.

BeginOpen(AsyncCallback, Object)

Commence une opération asynchrone pour ouvrir un objet de communication.

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

Le délégué AsyncCallback qui reçoit la notification de la fin de l'opération d'ouverture asynchrone.

state

Object

Objet, spécifié par l'application, qui contient des informations d'état associées à l'opération d'ouverture asynchrone.

Retours

IAsyncResult

IAsyncResult qui fait référence à l'opération asynchrone d'ouverture.

Exceptions

CommunicationException

L'ICommunicationObject n'a pas pu être ouvert et est entré dans l'état Faulted.

TimeoutException

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.

Remarques

Lorsqu’une ICommunicationObject instanciation est instanciée, elle commence dans l’état Created . 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. La BeginOpen méthode provoque une ICommunicationObject entrée dans l’état Opening où elle reste jusqu’à ce que l’opération ouverte réussisse, l’opération ouverte expire ou échoue et l’objet devient défectueux ou l’objet ICommunicationObject est abandonné.

Dans l’état Opened , il ICommunicationObject est utilisable (par exemple, les messages peuvent être reçus), mais il n’est plus configurable.

BeginOpen(TimeSpan, AsyncCallback, Object)

Commence une opération asynchrone pour ouvrir un objet de communication dans un intervalle de temps spécifié.

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 qui spécifie le délai d'exécution de l'opération d'envoi avant dépassement du délai d'attente.

callback

AsyncCallback

Le délégué AsyncCallback qui reçoit la notification de la fin de l'opération d'ouverture asynchrone.

state

Object

Objet, spécifié par l'application, qui contient des informations d'état associées à l'opération d'ouverture asynchrone.

Retours

IAsyncResult

IAsyncResult qui fait référence à l'opération asynchrone d'ouverture.

Exceptions

CommunicationException

L'ICommunicationObject n'a pas pu être ouvert et est entré dans l'état Faulted.

TimeoutException

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.

Remarques

Lorsqu’une ICommunicationObject instanciation est instanciée, elle commence dans l’état Created . 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. La Open méthode provoque une ICommunicationObject entrée dans l’état Opening où elle reste jusqu’à ce que l’opération ouverte réussisse, l’opération ouverte expire ou échoue et l’objet devient défectueux ou l’objet ICommunicationObject est abandonné.

Dans l’état Opened , il ICommunicationObject est utilisable (par exemple, les messages peuvent être reçus), mais il n’est plus configurable.

Notes pour les responsables de l’implémentation

L’opération doit lever une TimeoutException valeur si la valeur spécifiée timeout est dépassée.