ICommunicationObject.BeginOpen Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Inicia uma operação assíncrona para abrir um objeto de comunicação.
Sobrecargas
| Name | Description |
|---|---|
| BeginOpen(AsyncCallback, Object) |
Inicia uma operação assíncrona para abrir um objeto de comunicação. |
| BeginOpen(TimeSpan, AsyncCallback, Object) |
Inicia uma operação assíncrona para abrir um objeto de comunicação dentro de um intervalo de tempo especificado. |
Observações
O BeginOpen método faz com que um ICommunicationObject entre no Opening estado onde permanece até que a sua transição para o Opened estado seja concluída ou falhe.
São fornecidas versões com e sem timeout explícito.
BeginOpen(AsyncCallback, Object)
- Origem:
- ICommunicationObject.cs
- Origem:
- ICommunicationObject.cs
- Origem:
- ICommunicationObject.cs
Inicia uma operação assíncrona para abrir um objeto de comunicação.
public:
IAsyncResult ^ BeginOpen(AsyncCallback ^ callback, System::Object ^ state);public IAsyncResult BeginOpen(AsyncCallback callback, object state);abstract member BeginOpen : AsyncCallback * obj -> IAsyncResultPublic Function BeginOpen (callback As AsyncCallback, state As Object) As IAsyncResultParâmetros
- callback
- AsyncCallback
O AsyncCallback delegado que recebe a notificação da conclusão da operação aberta assíncrona.
- state
- Object
Um objeto, especificado pela aplicação, que contém informação de estado associada à operação aberta assíncrona.
Devoluções
O IAsyncResult que faz referência à operação aberta assíncrona.
Exceções
Não ICommunicationObject foi possível abrir e entrou no Faulted estado.
O tempo limite de abertura por defeito passou antes de conseguir ICommunicationObject entrar no Opened estado e já ter entrado nesse Faulted estado.
Observações
Quando um ICommunicationObject é instanciado, começa no Created estado. No Created estado, o objeto pode ser configurado (por exemplo, propriedades podem ser definidas ou eventos podem ser registados), mas ainda não é utilizável para enviar ou receber mensagens. O BeginOpen método faz com que um ICommunicationObject entre no Opening estado em que permanece até que a operação aberta seja bem-sucedida, a operação aberta expire ou falhe e o objeto fique com falha, ou o ICommunicationObject seja abortado.
No Opened estado, o ICommunicationObject é utilizável (por exemplo, podem ser recebidas mensagens), mas já não é configurável.
Aplica-se a
BeginOpen(TimeSpan, AsyncCallback, Object)
- Origem:
- ICommunicationObject.cs
- Origem:
- ICommunicationObject.cs
- Origem:
- ICommunicationObject.cs
Inicia uma operação assíncrona para abrir um objeto de comunicação dentro de um intervalo de tempo 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 -> IAsyncResultPublic Function BeginOpen (timeout As TimeSpan, callback As AsyncCallback, state As Object) As IAsyncResultParâmetros
- timeout
- TimeSpan
Isso TimeSpan especifica quanto tempo a operação de envio tem de ser concluída antes de expirar.
- callback
- AsyncCallback
O AsyncCallback delegado que recebe a notificação da conclusão da operação aberta assíncrona.
- state
- Object
Um objeto, especificado pela aplicação, que contém informação de estado associada à operação aberta assíncrona.
Devoluções
O IAsyncResult que faz referência à operação aberta assíncrona.
Exceções
Não ICommunicationObject foi possível abrir e entrou no Faulted estado.
O tempo de espera especificado passou antes de ele ICommunicationObject poder entrar no Opened estado e ter entrado no Faulted estado.
Observações
Quando um ICommunicationObject é instanciado, começa no Created estado. No Created estado, o objeto pode ser configurado (por exemplo, propriedades podem ser definidas ou eventos podem ser registados), mas ainda não é utilizável para enviar ou receber mensagens. O Open método faz com que um ICommunicationObject entre no Opening estado em que permanece até que a operação aberta seja bem-sucedida, a operação aberta expire ou falhe e o objeto fique com falha, ou o ICommunicationObject seja abortado.
No Opened estado, o ICommunicationObject é utilizável (por exemplo, podem ser recebidas mensagens), mas já não é configurável.
Notas para Implementadores
A operação deve lançar a TimeoutException se o especificado timeout for ultrapassado.
