ICommunicationObject.Open ICommunicationObject.Open ICommunicationObject.Open ICommunicationObject.Open Method

Définition

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.

Surcharges

Open() Open() Open() 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) Open(TimeSpan) Open(TimeSpan) 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.

Remarques

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

Open() Open() Open() 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.

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.

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) Open(TimeSpan) Open(TimeSpan) 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)

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.

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.

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