ICommunicationObject.BeginOpen Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Comienza una operación asincrónica para abrir un objeto de comunicación.
Sobrecargas
BeginOpen(AsyncCallback, Object) |
Comienza una operación asincrónica para abrir un objeto de comunicación. |
BeginOpen(TimeSpan, AsyncCallback, Object) |
Comienza una operación asincrónica para abrir un objeto de comunicación dentro de un intervalo de tiempo especificado. |
Comentarios
El BeginOpen método hace que un ICommunicationObject elemento entre en el estado en el Opening que permanece hasta que se completa su transición al Opened estado o se produce un error.
Se proporcionan las versiones con y sin un tiempo de espera concreto.
BeginOpen(AsyncCallback, Object)
Comienza una operación asincrónica para abrir un objeto de comunicación.
public:
IAsyncResult ^ BeginOpen(AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginOpen (AsyncCallback callback, object state);
abstract member BeginOpen : AsyncCallback * obj -> IAsyncResult
Public Function BeginOpen (callback As AsyncCallback, state As Object) As IAsyncResult
Parámetros
- callback
- AsyncCallback
Delegado de AsyncCallback que recibe la notificación de la finalización de la operación de apertura asincrónica.
- state
- Object
Objeto, especificado por la aplicación, que contiene la información de estado asociada a la operación de apertura asincrónica.
Devoluciones
IAsyncResult, que hace referencia a la operación de apertura asincrónica.
Excepciones
El ICommunicationObject no pudo abrirse y ha entrado en el estado Faulted.
El tiempo de espera para la apertura predeterminado transcurrió antes de que ICommunicationObject pudiera introducir el estado Opened y ha introducido el estado Faulted.
Comentarios
Cuando se crea una instancia de , ICommunicationObject comienza en el Created estado . 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. El BeginOpen método hace que un ICommunicationObject elemento entre en el estado en el Opening que permanece hasta que la operación abierta se realiza correctamente, la operación abierta agota el tiempo de espera o se produce un error y el objeto se produce un error o ICommunicationObject se anula.
En el Opened estado , ICommunicationObject se puede usar (por ejemplo, se pueden recibir mensajes), pero ya no se puede configurar.
Se aplica a
BeginOpen(TimeSpan, AsyncCallback, Object)
Comienza una operación asincrónica para abrir un objeto de comunicación dentro de un intervalo de tiempo especificado.
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 -> IAsyncResult
Public Function BeginOpen (timeout As TimeSpan, callback As AsyncCallback, state As Object) As IAsyncResult
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.
- callback
- AsyncCallback
Delegado de AsyncCallback que recibe la notificación de la finalización de la operación de apertura asincrónica.
- state
- Object
Objeto, especificado por la aplicación, que contiene la información de estado asociada a la operación de apertura asincrónica.
Devoluciones
IAsyncResult, que hace referencia a la operación de apertura asincrónica.
Excepciones
El ICommunicationObject no pudo abrirse y ha entrado en el estado Faulted.
El tiempo de espera especificado transcurrió antes de que ICommunicationObject pudiera introducir el estado Opened y ha introducido el estado Faulted.
Comentarios
Cuando se crea una instancia de , ICommunicationObject comienza en el Created estado . 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. El Open método hace que un ICommunicationObject elemento entre en el estado en el Opening que permanece hasta que la operación abierta se realiza correctamente, la operación abierta agota el tiempo de espera o se produce un error y el objeto se produce un error o ICommunicationObject se anula.
En el Opened estado , ICommunicationObject se puede usar (por ejemplo, se pueden recibir mensajes), pero ya no se puede configurar.
Notas a los implementadores
La operación debe iniciar un TimeoutException si se supera el especificado timeout
.