ICommunicationObject.BeginOpen Método

Definição

Namespace:

System.ServiceModel

Assembly:

System.ServiceModel.Primitives.dll

Assembly:

System.ServiceModel.dll

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

Public Function BeginOpen (callback As AsyncCallback, state As Object) As IAsyncResult

Parâ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

IAsyncResult

O IAsyncResult que faz referência à operação de abertura assíncrona.

Exceções

CommunicationException

O ICommunicationObject não pôde ser aberto e entrou no estado Faulted.

TimeoutException

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.

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

Public Function BeginOpen (timeout As TimeSpan, callback As AsyncCallback, state As Object) As IAsyncResult

Parâ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

IAsyncResult

O IAsyncResult que faz referência à operação de abertura assíncrona.

Exceções

CommunicationException

O ICommunicationObject não pôde ser aberto e entrou no estado Faulted.

TimeoutException

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.