ICommunicationObject.BeginOpen Methode

Definition

Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu öffnen.

Überlädt

BeginOpen(AsyncCallback, Object)

Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu öffnen.

BeginOpen(TimeSpan, AsyncCallback, Object)

Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt innerhalb eines festgelegten Zeitraums zu öffnen.

Hinweise

Die BeginOpen Methode verursacht einen ICommunicationObject Einstieg in den Opening Zustand, in dem Opened er bleibt, bis der Übergang zum Zustand abgeschlossen ist oder fehlschlägt.

Versionen mit und ohne explizites Timeout werden bereitgestellt.

BeginOpen(AsyncCallback, Object)

Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu öffnen.

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

Parameter

callback
AsyncCallback

Der AsyncCallback-Delegat, der die Benachrichtigung erhält, dass der asynchrone Öffnungsvorgang abgeschlossen wurde.

state
Object

Ein durch die Anwendung festgelegtes Objekt, das dem asynchronen Öffnungsvorgang zugeordnete Zustandsinformationen enthält.

Gibt zurück

IAsyncResult

Der IAsyncResult-Wert, der auf den asynchronen Öffnungsvorgang verweist.

Ausnahmen

ICommunicationObject kann nicht geöffnet werden und hat den Faulted-Zustand angenommen.

Das standardmäßige Öffnungstimeout ist verstrichen, bevor ICommunicationObject den Opened-Zustand annehmen konnte. Es hat jetzt den Faulted-Zustand.

Hinweise

Wenn ein ICommunicationObject Instanziiert wird, beginnt er im Created Zustand. Im Created-Zustand kann das Objekt konfiguriert werden (so können beispielsweise Eigenschaften eingerichtet oder Ereignisse registriert werden), es kann jedoch noch nicht zum Versenden und Empfangen von Nachrichten verwendet werden. Die BeginOpen Methode führt ICommunicationObject dazu, dass eine Eingabe in den Opening Zustand erfolgt, in dem es bleibt, bis der geöffnete Vorgang erfolgreich verläuft, der geöffnete Vorgang ausfällt oder fehlschlägt und das Objekt fehlschlägt, oder das ICommunicationObject Objekt wird abgebrochen.

Opened Im Zustand ist die ICommunicationObject Verwendung (z. B. Nachrichten können empfangen werden), aber es ist nicht mehr konfigurierbar.

Gilt für:

BeginOpen(TimeSpan, AsyncCallback, Object)

Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt innerhalb eines festgelegten Zeitraums zu öffnen.

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

Parameter

timeout
TimeSpan

Der TimeSpan-Wert, der angibt, welcher Zeitraum für den Sendevorgang bleibt, bevor ein Timeout eintritt.

callback
AsyncCallback

Der AsyncCallback-Delegat, der die Benachrichtigung erhält, dass der asynchrone Öffnungsvorgang abgeschlossen wurde.

state
Object

Ein durch die Anwendung festgelegtes Objekt, das dem asynchronen Öffnungsvorgang zugeordnete Zustandsinformationen enthält.

Gibt zurück

IAsyncResult

Der IAsyncResult-Wert, der auf den asynchronen Öffnungsvorgang verweist.

Ausnahmen

ICommunicationObject kann nicht geöffnet werden und hat den Faulted-Zustand angenommen.

Das festgelegte Timeout ist verstrichen, bevor ICommunicationObject den Opened-Zustand annehmen konnte. Es weist jetzt den Faulted-Zustand auf.

Hinweise

Wenn ein ICommunicationObject Instanziiert wird, beginnt er im Created Zustand. Im Created-Zustand kann das Objekt konfiguriert werden (so können beispielsweise Eigenschaften eingerichtet oder Ereignisse registriert werden), es kann jedoch noch nicht zum Versenden und Empfangen von Nachrichten verwendet werden. Die Open Methode führt ICommunicationObject dazu, dass eine Eingabe in den Opening Zustand erfolgt, in dem es bleibt, bis der geöffnete Vorgang erfolgreich verläuft, der geöffnete Vorgang ausfällt oder fehlschlägt und das Objekt fehlschlägt, oder das ICommunicationObject Objekt wird abgebrochen.

Opened Im Zustand ist die ICommunicationObject Verwendung (z. B. Nachrichten können empfangen werden), aber es ist nicht mehr konfigurierbar.

Hinweise für Ausführende

Der Vorgang muss einen TimeoutException Auslösen, wenn der angegebene timeout Wert überschritten wird.

Gilt für: