CommunicationObject.Open Método

Definição

Faz com que um objeto de comunicação faça a transição do estado criado para o estado aberto.Causes a communication object to transition from the created state into the opened state.

Sobrecargas

Open()

Faz com que um objeto de comunicação faça a transição do estado criado para o estado aberto.Causes a communication object to transition from the created state into the opened state.

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.Causes a communication object to transition from the created state into the opened state within a specified interval of time.

Comentários

Quando chamado, o método Open faz com que um CommunicationObject entre no estado Opening e chame OnOpening, Open e OnOpened.When called, the Open method causes a CommunicationObject to enter into the Opening state and calls OnOpening, Open, and OnOpened. O método OnOpened conclui o método Open definindo o estado do objeto para o estado Opened.The OnOpened method completes the Open method by setting the state of the object to the Opened state.

Open()

Faz com que um objeto de comunicação faça a transição do estado criado para o estado aberto.Causes a communication object to transition from the created state into the opened state.

public:
 virtual void Open();
public void Open ();
abstract member Open : unit -> unit
override this.Open : unit -> unit
Public Sub Open ()

Implementações

Exceções

O objeto de comunicação não está em um estado Opened ou Opening e não pode ser modificado.The communication object is not in a Opened or Opening state and cannot be modified.

O objeto de comunicação está em um estado Closing ou Closed e não pode ser modificado.The communication object is in a Closing or Closed state and cannot be modified.

O objeto de comunicação está em um estado Faulted e não pode ser modificado.The communication object is in a Faulted state and cannot be modified.

O intervalo de tempo padrão alocado para a operação foi excedido antes que a operação tivesse sido concluída.The default interval of time that was allotted for the operation was exceeded before the operation was completed.

Comentários

Quando um CommunicationObject é instanciado, ele começa no estado de Created.When a CommunicationObject is instantiated, it begins in the Created state. No estado Created, o objeto pode ser configurado (por exemplo, as propriedades podem ser definidas ou os eventos podem ser registrados), mas ele ainda não é utilizável para enviar ou receber mensagens.In the Created state, the object can be configured (for example, properties can be set, or events can be registered), but it is not yet usable to send or receive messages. Quando chamado, o método Open faz com que um CommunicationObject entre no estado Opening e chame OnOpening, Open e OnOpened.When called, the Open method causes a CommunicationObject to enter into the Opening state and calls OnOpening, Open, and OnOpened. O método OnOpened conclui o método Open definindo o estado do objeto para o estado Opened.The OnOpened method completes the Open method by setting the state of the object to the Opened state.

NoIn the

Opened, o CommunicationObject é utilizável (por exemplo, mensagens podem ser recebidas), mas não é mais configurável.Opened state, the CommunicationObject is usable (for example, messages can be received), but it is no longer configurable.

Também há uma versão assíncrona do método Open que é iniciada chamando OnBeginOpen(TimeSpan, AsyncCallback, Object) e concluída chamando EndOpen.There is also an asynchronous version of the open method that is initiated by calling OnBeginOpen(TimeSpan, AsyncCallback, Object) and completed by calling EndOpen.

Captura de credenciais com autenticação do WindowsCredentials Capture with Windows Authentication

Ao usar a autenticação do Windows, as credenciais usadas pelo serviço são baseadas no thread de contexto atual.When using Windows authentication, credentials used by the service are based on the current context thread. As credenciais são obtidas quando o método Open é chamado.The credentials are obtained when the Open method is called.

Observação

Para chamadas assíncronas, as credenciais são capturadas quando o BeginOpen é invocado.For asynchronous calls, credentials are captured when the BeginOpen is invoked. No entanto, as credenciais reais não podem ser garantidas.However, the actual credentials cannot be guaranteed. Ou seja, as credenciais do chamador podem ser alternadas para outra identidade.That is, the credentials of the caller may be switched to another identity. Para obter mais informações, consulte segurança de mensagem com um cliente Windows.For more information, see Message Security with a Windows Client.

Veja também

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.Causes a communication object to transition from the created state into the opened state within a specified interval of time.

public:
 virtual void Open(TimeSpan timeout);
public void Open (TimeSpan timeout);
abstract member Open : TimeSpan -> unit
override this.Open : TimeSpan -> unit
Public Sub Open (timeout As TimeSpan)

Parâmetros

timeout
TimeSpan

O TimeSpan que especifica quanto tempo a operação de abertura tem para ser concluída antes de atingir o tempo limite.The TimeSpan that specifies how long the open operation has to complete before timing out.

Implementações

Exceções

O objeto de comunicação não está em um estado Opened ou Opening e não pode ser modificado.The communication object is not in a Opened or Opening state and cannot be modified.

O objeto de comunicação está em um estado Closing ou Closed e não pode ser modificado.The communication object is in a Closing or Closed state and cannot be modified.

O objeto de comunicação está em um estado Faulted e não pode ser modificado.The communication object is in a Faulted state and cannot be modified.

O intervalo de tempo padrão alocado para a operação foi excedido antes que a operação tivesse sido concluída.The default interval of time that was allotted for the operation was exceeded before the operation was completed.

Comentários

Quando um CommunicationObject é instanciado, ele começa no estado de Created.When a CommunicationObject is instantiated, it begins in the Created state. No estado Created, o objeto pode ser configurado (por exemplo, as propriedades podem ser definidas ou os eventos podem ser registrados), mas ele ainda não é utilizável para enviar ou receber mensagens.In the Created state, the object can be configured (for example, properties can be set, or events can be registered), but it is not yet usable to send or receive messages. Quando chamado, o método Open faz com que um CommunicationObject entre no estado Opening e chame OnOpening, Open e OnOpened.When called, the Open method causes a CommunicationObject to enter into the Opening state and calls OnOpening, Open, and OnOpened. O método OnOpened conclui o método Open definindo o estado do objeto para o estado Opened.The OnOpened method completes the Open method by setting the state of the object to the Opened state.

NoIn the

Opened, o CommunicationObject é utilizável (por exemplo, mensagens podem ser recebidas), mas não é mais configurável.Opened state, the CommunicationObject is usable (for example, messages can be received), but it is no longer configurable.

Também há uma versão assíncrona do método Open que é iniciada chamando BeginOpen e concluída chamando EndOpen.There is also an asynchronous version of the open method that is initiated by calling BeginOpen and completed by calling EndOpen.

Aplica-se a