ICommunicationObject.Close Método

Definição

Namespace:

System.ServiceModel

Assembly:

System.ServiceModel.Primitives.dll

Assembly:

System.ServiceModel.dll

Faz com que um objeto de comunicação faça a transição do estado atual para o estado fechado.

Sobrecargas

Close()	Faz com que um objeto de comunicação faça a transição do estado atual para o estado fechado.
Close(TimeSpan)	Faz com que um objeto de comunicação faça a transição do estado atual para o estado fechado.

Close()

Faz com que um objeto de comunicação faça a transição do estado atual para o estado fechado.

public:
 void Close();

public void Close ();

abstract member Close : unit -> unit

Public Sub Close ()

Exceções

CommunicationObjectFaultedException

Close() foi chamado em um objeto no estado Faulted.

TimeoutException

O tempo limite de fechamento padrão decorrido antes de o ICommunicationObject poder ser fechado normalmente.

Comentários

Esse método faz com que uma transição ICommunicationObject normal do Opened estado para o Closed estado. O Close método permite que qualquer trabalho inacabado seja concluído antes de retornar. Por exemplo, conclua o envio de mensagens em buffer).

Ele ICommunicationObject entra no Closing estado e permanece nele até que a transição para o Closed estado seja concluída.

Close retorna quando o Closed estado é atingido.

Se o tempo limite de fechamento padrão se esgotar antes que ele ICommunicationObject seja capaz de fechar normalmente, ele ICommunicationObject será anulado.

Se Close for chamado em Createdum ICommunicationObject estado ou Faulted no estado, Openingele ICommunicationObject será anulado. Se Close for chamado em um ICommunicationObject estado ou Closed no Closing estado, a chamada retornará imediatamente.

Há também uma versão assíncrona do método close que é iniciada pela chamada BeginClose e concluída pela chamada Close.

Close(TimeSpan)

Faz com que um objeto de comunicação faça a transição do estado atual para o estado fechado.

public:
 void Close(TimeSpan timeout);

public void Close (TimeSpan timeout);

abstract member Close : TimeSpan -> unit

Public Sub Close (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

CommunicationObjectFaultedException

Close() foi chamado em um objeto no estado Faulted.

TimeoutException

O tempo limite expirou antes de o ICommunicationObject poder ser fechado normalmente.

Comentários

Esse método faz com que uma ICommunicationObject transição normal do Opened estado para o Closed estado dentro de um intervalo de tempo especificado. O Close método permite que qualquer trabalho inacabado seja concluído antes de retornar. Por exemplo, conclua o envio de mensagens em buffer).

Ele ICommunicationObject entra no Closing estado e permanece nele até que a transição para o Closed estado seja concluída.

Close retorna quando o Closed estado é atingido.

Se o tempo limite passar antes que o ICommunicationObject seja capaz de fechar normalmente, ele ICommunicationObject será anulado.

Se Close for chamado em Createdum ICommunicationObject estado ou Faulted no estado, Openingele ICommunicationObject será anulado. Se Close for chamado em um ICommunicationObject estado ou Closed no Closing estado, a chamada retornará imediatamente.

Há também uma versão assíncrona do método close que é iniciada pela chamada BeginClose e concluída pela chamada Close.

Notas aos Implementadores

A operação deve gerar um TimeoutException caso o especificado timeout seja excedido.