ICommunicationObject.Open 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.
Provoque la transition d'un objet de communication de l'état créé à l'état ouvert.
Surcharges
Open() |
Provoque la transition d'un objet de communication de l'état créé à l'état ouvert. |
Open(TimeSpan) |
Provoque la transition d'un objet de communication de l'état créé à l'état ouvert dans un intervalle de temps spécifié. |
Remarques
Des versions avec et sans délai d'attente explicite sont fournies.
Open()
- Source:
- ICommunicationObject.cs
Provoque la transition d'un objet de communication de l'état créé à l'état ouvert.
public:
void Open();
public void Open ();
abstract member Open : unit -> unit
Public Sub Open ()
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’un ICommunicationObject est instancié, il 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 entraîne l’entrée d’un ICommunicationObject dans l’état Opening où il reste jusqu’à ce que l’opération d’ouverture réussisse, que l’opération d’ouverture expire ou échoue et que l’objet soit défectueux, ou que le ICommunicationObject est abandonné.
Dans l’état Opened , est utilisable (par exemple, les ICommunicationObject messages peuvent être reçus), mais il n’est plus configurable.
Il existe également une version asynchrone de la méthode d'ouverture qui est initiée en appelant BeginOpen et terminée en appelant EndOpen(IAsyncResult).
S’applique à
Open(TimeSpan)
- Source:
- ICommunicationObject.cs
Provoque la transition d'un objet de communication de l'état créé à l'état ouvert dans un intervalle de temps spécifié.
public:
void Open(TimeSpan timeout);
public void Open (TimeSpan timeout);
abstract member Open : TimeSpan -> unit
Public Sub Open (timeout As TimeSpan)
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.
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’un ICommunicationObject est instancié, il 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 entraîne l’entrée d’un ICommunicationObject dans l’état Opening où il reste jusqu’à ce que l’opération d’ouverture réussisse, que l’opération d’ouverture expire ou échoue et que l’objet soit défectueux, ou que le ICommunicationObject est abandonné.
Dans l’état Opened , est utilisable (par exemple, les ICommunicationObject messages peuvent être reçus), mais il n’est plus configurable.
Il existe également une version asynchrone de la méthode d'ouverture qui est initiée en appelant BeginOpen et terminée en appelant EndOpen(IAsyncResult).
Notes pour les responsables de l’implémentation
L’opération doit lever un TimeoutException si le spécifié timeout
est dépassé.