ICommunicationObject.BeginOpen Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> IAsyncResultPublic Function BeginOpen (callback As AsyncCallback, state As Object) As IAsyncResultParamè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 qui fait référence à l'opération asynchrone d'ouverture.
Exceptions
L'ICommunicationObject n'a pas pu être ouvert et est entré dans l'état Faulted.
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.
S’applique à
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 -> IAsyncResultPublic Function BeginOpen (timeout As TimeSpan, callback As AsyncCallback, state As Object) As IAsyncResultParamè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 qui fait référence à l'opération asynchrone d'ouverture.
Exceptions
L'ICommunicationObject n'a pas pu être ouvert et est entré dans l'état Faulted.
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.