CommunicationObject.Close Метод

Определение

Пространство имен:

System.ServiceModel.Channels

Сборка:

System.ServiceModel.Primitives.dll

Пакет:

System.ServiceModel.Primitives v8.1.0

Вызывает переход объекта связи из текущего состояния в состояние Closed.

Перегрузки

Close()	Вызывает переход объекта связи из текущего состояния в состояние Closed.
Close(TimeSpan)	Вызывает переход объекта связи из его текущего состояния в состояние Closed в течение заданного интервала времени.

Close()

Исходный код:

CommunicationObject.cs

Вызывает переход объекта связи из текущего состояния в состояние Closed.

public:
 virtual void Close();

public void Close ();

abstract member Close : unit -> unit
override this.Close : unit -> unit

Public Sub Close ()

Реализации

Close()

Исключения

InvalidOperationException

Объект связи не находится в состоянии Opened или Opening и не может быть изменен.

ObjectDisposedException

Объект связи находится в состоянии Closing или Closed и не может быть изменен.

CommunicationObjectFaultedException

Объект связи находится в состоянии Faulted и не может быть изменен.

TimeoutException

Принятый по умолчанию интервал времени, выделенный для операции, истек до того, как операция была завершена.

Комментарии

Этот метод приводит к верному переходу объекта CommunicationObject из любого состояния, отличного от состояния Closed, в состояние Closed. Метод Close позволяет завершить всю незавершенную работу перед возвратом. Например, завершить отправку всех сообщений, находящихся в буфере.

Объект CommunicationObject переходит в состояние Closing и остается в нем после вызова метода Close, пока не завершится переход в состояние Closed. Переход заключается в последовательных вызовах методов OnClosing, OnClose(TimeSpan) и OnClosed.

Существует также асинхронная версия метода Close, которая инициируется путем вызова метода BeginClose.

Close(TimeSpan)

Исходный код:

CommunicationObject.cs

Вызывает переход объекта связи из его текущего состояния в состояние Closed в течение заданного интервала времени.

public:
 virtual void Close(TimeSpan timeout);

public void Close (TimeSpan timeout);

abstract member Close : TimeSpan -> unit
override this.Close : TimeSpan -> unit

Public Sub Close (timeout As TimeSpan)

Параметры

timeout

TimeSpan

Значение TimeSpan, которое задает время, выделенное для завершения операции закрытия до истечения времени ожидания.

Реализации

Close(TimeSpan)

Исключения

InvalidOperationException

Объект связи не находится в состоянии Opened или Opening и не может быть изменен.

ObjectDisposedException

Объект связи находится в состоянии Closing или Closed и не может быть изменен.

CommunicationObjectFaultedException

Объект связи находится в состоянии Faulted и не может быть изменен.

TimeoutException

Принятый по умолчанию интервал времени, выделенный для операции, истек до того, как операция была завершена.

Комментарии

Этот метод вызывает верный переход объекта CommunicationObject из любого состояния, отличного от состояния Closed, в состояние Closed в течение заданного интервала времени. Метод Close позволяет завершить всю незавершенную работу перед возвратом. Например, завершить отправку всех сообщений, находящихся в буфере.

Объект CommunicationObject переходит в состояние Closing и остается в нем после вызова метода Close, пока не завершится переход в состояние Closed. Переход заключается в последовательных вызовах методов OnClosing, OnClose(TimeSpan) и OnClosed.

Существует также асинхронная версия метода Close, которая инициируется путем вызова метода BeginClose.