ICommunicationObject.BeginOpen Метод

Определение

Начинает асинхронную операцию закрытия объекта связи.Begins an asynchronous operation to close a communication object.

Перегрузки

BeginOpen(AsyncCallback, Object)

Начинает асинхронную операцию открытия объекта связи.Begins an asynchronous operation to open a communication object.

BeginOpen(TimeSpan, AsyncCallback, Object)

Начинает асинхронную операцию открытия объекта связи в течение заданного интервала времени.Begins an asynchronous operation to open a communication object within a specified interval of time.

Комментарии

BeginOpenМетод приводит к тому, что ICommunicationObject он переходит в Opening состояние, где оно остается до Opened завершения или сбоя перехода в состояние.The BeginOpen method causes an ICommunicationObject to enter into the Opening state where it remains until its transition to the Opened state is completed or fails.

Имеются версии с явно заданным временем ожидания и без него.Versions with and without an explicit timeout are provided.

BeginOpen(AsyncCallback, Object)

Начинает асинхронную операцию открытия объекта связи.Begins an asynchronous operation to open a communication object.

public:
 IAsyncResult ^ BeginOpen(AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginOpen (AsyncCallback callback, object state);
abstract member BeginOpen : AsyncCallback * obj -> IAsyncResult
Public Function BeginOpen (callback As AsyncCallback, state As Object) As IAsyncResult

Параметры

callback
AsyncCallback

Делегат AsyncCallback, принимающий уведомление о завершении асинхронной операции открытия.The AsyncCallback delegate that receives notification of the completion of the asynchronous open operation.

state
Object

Заданный приложением объект, который содержит сведения о состоянии, связанные с асинхронной операцией открытия.An object, specified by the application, that contains state information associated with the asynchronous open operation.

Возвращаемое значение

IAsyncResult

Объект IAsyncResult, который ссылается на асинхронную операцию открытия.The IAsyncResult that references the asynchronous open operation.

Исключения

Не удалось открыть объект ICommunicationObject, и он перешел в состояние Faulted.The ICommunicationObject was unable to be opened and has entered the Faulted state.

Время ожидания открытия по умолчанию истекло до перехода объекта ICommunicationObject в состояние Opened, и он перешел в состояние Faulted.The default open timeout elapsed before the ICommunicationObject was able to enter the Opened state and has entered the Faulted state.

Комментарии

При ICommunicationObject создании экземпляра он начинается в Created состоянии.When an ICommunicationObject is instantiated, it begins in the Created state. Объект, находящийся в состоянии Created, можно настраивать (например, задавать свойства или регистрировать события), но все еще нельзя использовать для отправки или приема сообщений.In the Created state, the object can be configured (for example, properties can be set, or events can be registered), but it is not yet usable to send or receive messages. BeginOpenМетод заставляет ответ переключаться ICommunicationObject в состояние, в Opening котором оно остается до тех пор, пока операция открытия не завершится успешно, время ожидания операции открытия истекло или произойдет сбой, и объект станет неисправным, или ICommunicationObject прерывается.The BeginOpen method causes an ICommunicationObject to enter into the Opening state where it remains until the open operation succeeds, the open operation times out or fails and the object becomes faulted, or the ICommunicationObject is aborted.

В Opened состоянии ICommunicationObject можно использовать (например, сообщения могут быть получены), но оно больше не настраивается.In the Opened state, the ICommunicationObject is usable (for example, messages can be received), but it is no longer configurable.

Применяется к

BeginOpen(TimeSpan, AsyncCallback, Object)

Начинает асинхронную операцию открытия объекта связи в течение заданного интервала времени.Begins an asynchronous operation to open a communication object within a specified interval of time.

public:
 IAsyncResult ^ BeginOpen(TimeSpan timeout, AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginOpen (TimeSpan timeout, AsyncCallback callback, object state);
abstract member BeginOpen : TimeSpan * AsyncCallback * obj -> IAsyncResult
Public Function BeginOpen (timeout As TimeSpan, callback As AsyncCallback, state As Object) As IAsyncResult

Параметры

timeout
TimeSpan

Значение TimeSpan, указывающее время, выделенное для завершения операции отправки до истечения времени ожидания.The TimeSpan that specifies how long the send operation has to complete before timing out.

callback
AsyncCallback

Делегат AsyncCallback, принимающий уведомление о завершении асинхронной операции открытия.The AsyncCallback delegate that receives notification of the completion of the asynchronous open operation.

state
Object

Заданный приложением объект, который содержит сведения о состоянии, связанные с асинхронной операцией открытия.An object, specified by the application, that contains state information associated with the asynchronous open operation.

Возвращаемое значение

IAsyncResult

Объект IAsyncResult, который ссылается на асинхронную операцию открытия.The IAsyncResult that references the asynchronous open operation.

Исключения

Не удалось открыть объект ICommunicationObject, и он перешел в состояние Faulted.The ICommunicationObject was unable to be opened and has entered the Faulted state.

Заданное время ожидания истекло до перехода объекта ICommunicationObject в состояние Opened, и он перешел в состояние Faulted.The specified timeout elapsed before the ICommunicationObject was able to enter the Opened state and has entered the Faulted state.

Комментарии

При ICommunicationObject создании экземпляра он начинается в Created состоянии.When an ICommunicationObject is instantiated, it begins in the Created state. Объект, находящийся в состоянии Created, можно настраивать (например, задавать свойства или регистрировать события), но все еще нельзя использовать для отправки или приема сообщений.In the Created state, the object can be configured (for example, properties can be set, or events can be registered), but it is not yet usable to send or receive messages. OpenМетод заставляет ответ переключаться ICommunicationObject в состояние, в Opening котором оно остается до тех пор, пока операция открытия не завершится успешно, время ожидания операции открытия истекло или произойдет сбой, и объект станет неисправным, или ICommunicationObject прерывается.The Open method causes an ICommunicationObject to enter into the Opening state where it remains until the open operation succeeds, the open operation times out or fails and the object becomes faulted, or the ICommunicationObject is aborted.

В Opened состоянии ICommunicationObject можно использовать (например, сообщения могут быть получены), но оно больше не настраивается.In the Opened state, the ICommunicationObject is usable (for example, messages can be received), but it is no longer configurable.

Примечания для тех, кто реализует этот метод

Операция должна вызывать исключение, TimeoutException Если указанное значение timeout превышено.The operation must throw a TimeoutException if the specified timeout is exceeded.

Применяется к