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