ICommunicationObject.BeginOpen Metoda

Definicja

Przestrzeń nazw:

System.ServiceModel

Zestaw:

System.ServiceModel.Primitives.dll

Zestaw:

System.ServiceModel.dll

Rozpoczyna operację asynchroniczną, aby otworzyć obiekt komunikacji.

Przeciążenia

BeginOpen(AsyncCallback, Object)	Rozpoczyna operację asynchroniczną, aby otworzyć obiekt komunikacji.
BeginOpen(TimeSpan, AsyncCallback, Object)	Rozpoczyna operację asynchroniczną, aby otworzyć obiekt komunikacji w określonym przedziale czasu.

Uwagi

Metoda BeginOpen powoduje ICommunicationObject wprowadzenie Opening do stanu, w którym pozostaje do momentu zakończenia przejścia do Opened stanu lub niepowodzenia.

Dostępne są wersje z jawnym limitem czasu i bez tego limitu czasu.

BeginOpen(AsyncCallback, Object)

Rozpoczyna operację asynchroniczną, aby otworzyć obiekt komunikacji.

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

Parametry

callback

AsyncCallback

Delegat AsyncCallback , który otrzymuje powiadomienie o zakończeniu operacji otwierania asynchronicznego.

state

Object

Obiekt określony przez aplikację zawierający informacje o stanie skojarzone z operacją otwierania asynchronicznego.

Zwraca

IAsyncResult

Element IAsyncResult odwołujący się do operacji otwierania asynchronicznego.

Wyjątki

CommunicationException

Nie ICommunicationObject można otworzyć pliku i wszedł do Faulted stanu.

TimeoutException

Domyślny limit czasu otwierania upłynął, zanim ICommunicationObject był w stanie wprowadzić Opened stan i został wprowadzony w Faulted stan.

Uwagi

Po utworzeniu ICommunicationObject Created wystąpienia obiektu zaczyna się w stanie. Created W stanie można skonfigurować obiekt (na przykład można ustawić właściwości lub zdarzenia można zarejestrować), ale nie można go jeszcze używać do wysyłania lub odbierania komunikatów. Metoda BeginOpen powoduje ICommunicationObject przejście Opening do stanu, w którym pozostaje do momentu pomyślnego otwarcia operacji, limit czasu operacji otwierania lub niepowodzenie, a obiekt zostanie uszkodzony lub ICommunicationObject przerwany.

Opened W stanie ICommunicationObject jest to możliwe do użycia (na przykład można odbierać komunikaty), ale nie jest już konfigurowalne.

BeginOpen(TimeSpan, AsyncCallback, Object)

Rozpoczyna operację asynchroniczną, aby otworzyć obiekt komunikacji w określonym przedziale czasu.

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

Parametry

timeout

TimeSpan

Określa TimeSpan , jak długo operacja wysyłania musi zakończyć się przed upływem limitu czasu.

callback

AsyncCallback

Delegat AsyncCallback , który otrzymuje powiadomienie o zakończeniu operacji otwierania asynchronicznego.

state

Object

Obiekt określony przez aplikację zawierający informacje o stanie skojarzone z operacją otwierania asynchronicznego.

Zwraca

IAsyncResult

Element IAsyncResult odwołujący się do operacji otwierania asynchronicznego.

Wyjątki

CommunicationException

Nie ICommunicationObject można otworzyć pliku i wszedł do Faulted stanu.

TimeoutException

Określony limit czasu upłynął, zanim ICommunicationObject był w stanie wprowadzić Opened stan i został wprowadzony w Faulted stan.

Uwagi

Po utworzeniu ICommunicationObject Created wystąpienia obiektu zaczyna się w stanie. Created W stanie można skonfigurować obiekt (na przykład można ustawić właściwości lub zdarzenia można zarejestrować), ale nie można go jeszcze używać do wysyłania lub odbierania komunikatów. Metoda Open powoduje ICommunicationObject przejście Opening do stanu, w którym pozostaje do momentu pomyślnego otwarcia operacji, limit czasu operacji otwierania lub niepowodzenie, a obiekt zostanie uszkodzony lub ICommunicationObject przerwany.

Opened W stanie ICommunicationObject jest to możliwe do użycia (na przykład można odbierać komunikaty), ale nie jest już konfigurowalne.

Uwagi dotyczące implementowania

Operacja musi zgłaszać wartość TimeoutException , jeśli określona wartość timeout zostanie przekroczona.