ICommunicationObject.Open Method

Definition

Provoque la transition d'un objet de communication de l'état créé à l'état ouvert.Causes a communication object to transition from the created state into the opened state.

Overloads

Open()

Provoque la transition d'un objet de communication de l'état créé à l'état ouvert.Causes a communication object to transition from the created state into the opened state.

Open(TimeSpan)

Provoque la transition d'un objet de communication de l'état créé à l'état ouvert dans un intervalle de temps spécifié.Causes a communication object to transition from the created state into the opened state within a specified interval of time.

Remarks

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

Open()

Provoque la transition d'un objet de communication de l'état créé à l'état ouvert.Causes a communication object to transition from the created state into the opened state.

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.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.

Remarks

Lorsqu’un ICommunicationObject est instancié, il commence à 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 amène un ICommunicationObject à entrer dans le Opening État où il reste jusqu’à ce que l’opération d’ouverture aboutisse, que l’opération d’ouverture expire ou échoue et que l’objet soit défaillant ou que le 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, le 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.

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).There is also an asynchronous version of the open method that is initiated by calling BeginOpen and completed by calling EndOpen(IAsyncResult).

Open(TimeSpan)

Provoque la transition d'un objet de communication de l'état créé à l'état ouvert dans un intervalle de temps spécifié.Causes a communication object to transition from the created state into the opened state within a specified interval of time.

public:
 void Open(TimeSpan timeout);
public void Open (TimeSpan timeout);
abstract member Open : TimeSpan -> unit
Public Sub Open (timeout As TimeSpan)

Parameters

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.The TimeSpan that specifies how long the send operation has to complete before timing out.

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.

Remarks

Lorsqu’un ICommunicationObject est instancié, il commence à 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 amène un ICommunicationObject à entrer dans le Opening État où il reste jusqu’à ce que l’opération d’ouverture aboutisse, que l’opération d’ouverture expire ou échoue et que l’objet soit défaillant ou que le 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, le 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.

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).There is also an asynchronous version of the open method that is initiated by calling BeginOpen and completed by calling EndOpen(IAsyncResult).

Notes to Implementers

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.

Applies to