ICommunicationObject.Open Método

Definición

Hace que un objeto de comunicación pase del estado creado al estado abierto.Causes a communication object to transition from the created state into the opened state.

Sobrecargas

Open()

Hace que un objeto de comunicación pase del estado creado al estado abierto.Causes a communication object to transition from the created state into the opened state.

Open(TimeSpan)

Hace que un objeto de comunicación pase del estado creado al estado abierto dentro de un intervalo de tiempo especificado.Causes a communication object to transition from the created state into the opened state within a specified interval of time.

Comentarios

Se proporcionan las versiones con y sin un tiempo de espera concreto.Versions with and without an explicit timeout are provided.

Open()

Hace que un objeto de comunicación pase del estado creado al estado abierto.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 ()

Excepciones

El ICommunicationObject no pudo abrirse y ha entrado en el estado Faulted.The ICommunicationObject was unable to be opened and has entered the Faulted state.

El tiempo de espera para la apertura predeterminado transcurrió antes de que ICommunicationObject pudiera introducir el estado Opened y ha introducido el estado Faulted.The default open timeout elapsed before the ICommunicationObject was able to enter the Opened state and has entered the Faulted state.

Comentarios

Cuando se crea una instancia de un ICommunicationObject, comienza en el estado Created.When an ICommunicationObject is instantiated, it begins in the Created state. En el estado Created, el objeto se puede configurar (por ejemplo, se pueden establecer las propiedades o registrar los eventos), pero no se puede usar todavía para enviar o recibir mensajes.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. El método Open hace que un ICommunicationObject entre en el estado Opening en el que permanece hasta que la operación de apertura se realiza correctamente, se agota el tiempo de espera o se produce un error en la operación de apertura, se genera un error en el objeto o se anula el ICommunicationObject.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.

En el estado Opened, el ICommunicationObject se puede usar (por ejemplo, se pueden recibir mensajes), pero ya no es configurable.In the Opened state, the ICommunicationObject is usable (for example, messages can be received), but it is no longer configurable.

Existe también una versión asincrónica del método de apertura que se inicia llamando a BeginOpen y se completa llamando a 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)

Hace que un objeto de comunicación pase del estado creado al estado abierto dentro de un intervalo de tiempo especificado.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)

Parámetros

timeout
TimeSpan

El objeto TimeSpan que especifica el tiempo con el que cuenta la operación de envío para completarse antes de que se agote el tiempo de espera.The TimeSpan that specifies how long the send operation has to complete before timing out.

Excepciones

El ICommunicationObject no pudo abrirse y ha entrado en el estado Faulted.The ICommunicationObject was unable to be opened and has entered the Faulted state.

El tiempo de espera especificado transcurrió antes de que ICommunicationObject pudiera introducir el estado Opened y ha introducido el estado Faulted.The specified timeout elapsed before the ICommunicationObject was able to enter the Opened state and has entered the Faulted state.

Comentarios

Cuando se crea una instancia de un ICommunicationObject, comienza en el estado Created.When an ICommunicationObject is instantiated, it begins in the Created state. En el estado Created, el objeto se puede configurar (por ejemplo, se pueden establecer las propiedades o registrar los eventos), pero no se puede usar todavía para enviar o recibir mensajes.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. El método Open hace que un ICommunicationObject entre en el estado Opening en el que permanece hasta que la operación de apertura se realiza correctamente, se agota el tiempo de espera o se produce un error en la operación de apertura, se genera un error en el objeto o se anula el ICommunicationObject.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.

En el estado Opened, el ICommunicationObject se puede usar (por ejemplo, se pueden recibir mensajes), pero ya no es configurable.In the Opened state, the ICommunicationObject is usable (for example, messages can be received), but it is no longer configurable.

Existe también una versión asincrónica del método de apertura que se inicia llamando a BeginOpen y se completa llamando a EndOpen(IAsyncResult).There is also an asynchronous version of the open method that is initiated by calling BeginOpen and completed by calling EndOpen(IAsyncResult).

Notas a los implementadores

La operación debe iniciar una TimeoutException si se supera el timeout especificado.The operation must throw a TimeoutException if the specified timeout is exceeded.

Se aplica a