CommunicationObject.Open Метод

Определение

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

System.ServiceModel.Channels

Сборка:

System.ServiceModel.Primitives.dll

Пакет:

System.ServiceModel.Primitives v6.2.0

Вызывает переход объекта связи из состояния Created в состояние Opened.

Перегрузки

Open()	Вызывает переход объекта связи из состояния Created в состояние Opened.
Open(TimeSpan)	Вызывает переход объекта связи из состояния Created в состояние Opened в течение заданного интервала времени.

Комментарии

При вызове метода Open объект CommunicationObject переходит в состояние Opening; кроме того, вызываются методы OnOpening, Open и OnOpened. Метод OnOpened завершает вызов метода Open, устанавливая для объекта состояние Opened.

Open()

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

CommunicationObject.cs

Вызывает переход объекта связи из состояния Created в состояние Opened.

public:
 virtual void Open();

public void Open ();

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

Public Sub Open ()

Реализации

Open()

Исключения

InvalidOperationException

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

ObjectDisposedException

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

CommunicationObjectFaultedException

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

TimeoutException

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

Комментарии

При создании объекта CommunicationObject он находится в состоянии Created. Объект, находящийся в состоянии Created, можно настраивать (например, задавать свойства или регистрировать события), но все еще нельзя использовать для отправки или приема сообщений. При вызове метода Open объект CommunicationObject переходит в состояние Opening; кроме того, вызываются методы OnOpening, Open и OnOpened. Метод OnOpened завершает вызов метода Open, устанавливая для объекта состояние Opened.

В поле

состоянии Opened объект CommunicationObject можно использовать (например, можно получать сообщения), но уже нельзя настраивать.

Также существует асинхронная версия метода Open, которая инициируется путем вызова метода OnBeginOpen(TimeSpan, AsyncCallback, Object) и завершается путем вызова метода EndOpen.

Получение учетных данных для проверки подлинности Windows

При использовании проверки подлинности Windows учетные данные, используемые службой, основаны на текущем потоке контекста. Учетные данные получаются при вызове метода Open.

Примечание

При использовании асинхронных вызовов учетные данные получаются при вызове метода BeginOpen. Однако нельзя гарантировать актуальность полученных учетных данных. Например, для вызова метода могли использоваться учетные данные другого пользователя. Дополнительные сведения см. в статье Безопасность сообщений с помощью клиента Windows.

См. также раздел

• BeginOpen(AsyncCallback, Object)
• Безопасность сообщений с клиентом Windows

Open(TimeSpan)

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

CommunicationObject.cs

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

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)

Параметры

timeout

TimeSpan

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

Реализации

Open(TimeSpan)

Исключения

InvalidOperationException

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

ObjectDisposedException

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

CommunicationObjectFaultedException

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

TimeoutException

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

Комментарии

При создании объекта CommunicationObject он находится в состоянии Created. Объект, находящийся в состоянии Created, можно настраивать (например, задавать свойства или регистрировать события), но все еще нельзя использовать для отправки или приема сообщений. При вызове метода Open объект CommunicationObject переходит в состояние Opening; кроме того, вызываются методы OnOpening, Open и OnOpened. Метод OnOpened завершает вызов метода Open, устанавливая для объекта состояние Opened.

В поле

состоянии Opened объект CommunicationObject можно использовать (например, можно получать сообщения), но уже нельзя настраивать.

Также существует асинхронная версия метода Open, которая инициируется путем вызова метода BeginOpen и завершается путем вызова метода EndOpen.