ICommunicationObject.BeginOpen Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicia uma operação assíncrona para abrir um objeto de comunicação.
Sobrecargas
| 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. |
Comentários
O BeginOpen método faz com que um ICommunicationObject usuário entre no Opening estado em que permanece até que sua transição para o Opened estado seja concluída ou falhe.
Versões com e sem um tempo limite explícito são fornecidas.
BeginOpen(AsyncCallback, Object)
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 delegado AsyncCallback que recebe a notificação da conclusão da operação de abertura assíncrona.
- state
- Object
Um objeto, especificado pelo aplicativo, que contém informações de estado associadas à operação de abertura assíncrona.
Retornos
O IAsyncResult que faz referência à operação de abertura assíncrona.
Exceções
O ICommunicationObject não pôde ser aberto e entrou no estado Faulted.
O tempo limite padrão especificado expirou antes do ICommunicationObject entrar no estado Opened e ele entrou no estado Faulted.
Comentários
Quando uma ICommunicationObject instância é instanciada, ela começa no Created estado. Created No estado, o objeto pode ser configurado (por exemplo, propriedades podem ser definidas ou eventos podem ser registrados), mas ainda não é utilizável enviar ou receber mensagens. O BeginOpen método faz com que um ICommunicationObject usuário entre no estado em Opening que permanece até que a operação aberta seja bem-sucedida, a operação aberta atingirá o tempo limite ou falhará e o objeto ficará com falha ou será ICommunicationObject anulado.
Opened No estado, é ICommunicationObject utilizável (por exemplo, mensagens podem ser recebidas), mas não é mais configurável.
Aplica-se a
BeginOpen(TimeSpan, AsyncCallback, Object)
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
O TimeSpan que especifica quanto tempo a operação de envio tem para ser concluída antes de atingir o tempo limite.
- callback
- AsyncCallback
O delegado AsyncCallback que recebe a notificação da conclusão da operação de abertura assíncrona.
- state
- Object
Um objeto, especificado pelo aplicativo, que contém informações de estado associadas à operação de abertura assíncrona.
Retornos
O IAsyncResult que faz referência à operação de abertura assíncrona.
Exceções
O ICommunicationObject não pôde ser aberto e entrou no estado Faulted.
O tempo limite especificado expirou antes do ICommunicationObject entrar no estado Opened e ele entrou no estado Faulted.
Comentários
Quando uma ICommunicationObject instância é instanciada, ela começa no Created estado. Created No estado, o objeto pode ser configurado (por exemplo, propriedades podem ser definidas ou eventos podem ser registrados), mas ainda não é utilizável enviar ou receber mensagens. O Open método faz com que um ICommunicationObject usuário entre no estado em Opening que permanece até que a operação aberta seja bem-sucedida, a operação aberta atingirá o tempo limite ou falhará e o objeto ficará com falha ou será ICommunicationObject anulado.
Opened No estado, é ICommunicationObject utilizável (por exemplo, mensagens podem ser recebidas), mas não é mais configurável.
Notas aos Implementadores
A operação deve gerar um TimeoutException caso o especificado timeout seja excedido.