ICommunicationObject.Open 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.
Faz com que um objeto de comunicação faça a transição do estado criado para o estado aberto.
Sobrecargas
Open() |
Faz com que um objeto de comunicação faça a transição do estado criado para o estado aberto. |
Open(TimeSpan) |
Faz com que um objeto de comunicação faça a transição do estado criado para o estado aberto em um intervalo de tempo especificado. |
Comentários
Versões com e sem um tempo limite explícito são fornecidas.
Open()
Faz com que um objeto de comunicação faça a transição do estado criado para o estado aberto.
public:
void Open();
public void Open ();
abstract member Open : unit -> unit
Public Sub Open ()
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 Open método faz com que uma ICommunicationObject entrada no Opening estado em que permanece até que a operação aberta seja bem-sucedida, a operação aberta atingirá o tempo limite ou falhará e o objeto se tornará com falha ou a ICommunicationObject operação será anulada.
Opened No estado, o ICommunicationObject valor é utilizável (por exemplo, mensagens podem ser recebidas), mas não é mais configurável.
Há também uma versão assíncrona do método aberto que é iniciada chamando BeginOpen e concluída chamando EndOpen(IAsyncResult).
Aplica-se a
Open(TimeSpan)
Faz com que um objeto de comunicação faça a transição do estado criado para o estado aberto em um intervalo de tempo especificado.
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
O TimeSpan que especifica quanto tempo a operação de envio tem para ser concluída antes de atingir o tempo limite.
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 uma ICommunicationObject entrada no Opening estado em que permanece até que a operação aberta seja bem-sucedida, a operação aberta atingirá o tempo limite ou falhará e o objeto se tornará com falha ou a ICommunicationObject operação será anulada.
Opened No estado, o ICommunicationObject valor é utilizável (por exemplo, mensagens podem ser recebidas), mas não é mais configurável.
Há também uma versão assíncrona do método aberto que é iniciada chamando BeginOpen e concluída chamando EndOpen(IAsyncResult).
Notas aos Implementadores
A operação deve gerar um TimeoutException se o especificado timeout
for excedido.