ICommunicationObject.Close Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Вызывает переход объекта связи из текущего состояния в состояние Closed.
Перегрузки
Close() |
Вызывает переход объекта связи из текущего состояния в состояние Closed. |
Close(TimeSpan) |
Вызывает переход объекта связи из текущего состояния в состояние Closed. |
Close()
Вызывает переход объекта связи из текущего состояния в состояние Closed.
public:
void Close();
public void Close ();
abstract member Close : unit -> unit
Public Sub Close ()
Исключения
Время ожидания закрытия по умолчанию истекло до правильного закрытия ICommunicationObject.
Комментарии
Этот метод вызывает ICommunicationObject корректное переход от Opened состояния к состоянию Closed . Метод Close позволяет завершить всю незавершенную работу перед возвратом. Например, завершить отправку всех сообщений, находящихся в буфере.
Он ICommunicationObject переходит в Closing состояние и остается в нем до завершения перехода к состоянию Closed .
Close возвращается после Closed достижения состояния.
Если время ожидания закрытия по умолчанию истекает до того, как ICommunicationObject он сможет закрыться корректно, ICommunicationObject прерван.
Если Close вызывается в объекте CreatedICommunicationObject , Openingили Faulted состоянии, ICommunicationObject он прерван. Если Close вызывается в объекте ICommunicationObject Closing или Closed состоянии, вызов возвращается немедленно.
Существует также асинхронная версия метода close, инициируемого вызовом BeginClose и завершенным путем вызова Close.
Применяется к
Close(TimeSpan)
Вызывает переход объекта связи из текущего состояния в состояние Closed.
public:
void Close(TimeSpan timeout);
public void Close (TimeSpan timeout);
abstract member Close : TimeSpan -> unit
Public Sub Close (timeout As TimeSpan)
Параметры
- timeout
- TimeSpan
Значение TimeSpan, указывающее время, выделенное для завершения операции отправки до истечения времени ожидания.
Исключения
Время ожидания истекло до верного закрытия ICommunicationObject.
Комментарии
Этот метод приводит ICommunicationObject к корректному переходу от Opened состояния к состоянию Closed в течение заданного интервала времени. Метод Close позволяет завершить всю незавершенную работу перед возвратом. Например, завершить отправку всех сообщений, находящихся в буфере.
Он ICommunicationObject переходит в Closing состояние и остается в нем до завершения перехода к состоянию Closed .
Close возвращается после Closed достижения состояния.
Если время ожидания истекает до того, как ICommunicationObject сможет корректно закрыться, ICommunicationObject прервано.
Если Close вызывается в объекте CreatedICommunicationObject , Openingили Faulted состоянии, ICommunicationObject он прерван. Если Close вызывается в объекте ICommunicationObject Closing или Closed состоянии, вызов возвращается немедленно.
Существует также асинхронная версия метода close, инициируемого вызовом BeginClose и завершенным путем вызова Close.
Примечания для тех, кто реализует этот метод
Операция должна вызывать исключение TimeoutException , если указанное timeout
превышено.