ICommunicationObject.Open 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.
Faz com que um objeto de comunicação faça a transição do estado criado para o estado aberto.
Sobrecargas
| Name | Description |
|---|---|
| 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 dentro de um intervalo de tempo especificado. |
Observações
São fornecidas versões com e sem timeout explícito.
Open()
- Origem:
- ICommunicationObject.cs
- Origem:
- ICommunicationObject.cs
- Origem:
- ICommunicationObject.cs
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 -> unitPublic Sub Open ()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 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.
Existe também uma versão assíncrona do método aberto que é iniciada ao chamar BeginOpen e completada ao chamar EndOpen(IAsyncResult).
Aplica-se a
Open(TimeSpan)
- Origem:
- ICommunicationObject.cs
- Origem:
- ICommunicationObject.cs
- Origem:
- ICommunicationObject.cs
Faz com que um objeto de comunicação faça a transição do estado criado para o estado aberto dentro de um intervalo de tempo especificado.
public:
void Open(TimeSpan timeout);public void Open(TimeSpan timeout);abstract member Open : TimeSpan -> unitPublic Sub Open (timeout As TimeSpan)Parâmetros
- timeout
- TimeSpan
Isso TimeSpan especifica quanto tempo a operação de envio tem de ser concluída antes de expirar.
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.
Existe também uma versão assíncrona do método aberto que é iniciada ao chamar BeginOpen e completada ao chamar EndOpen(IAsyncResult).
Notas para Implementadores
A operação deve lançar a TimeoutException se o especificado timeout for ultrapassado.
