ICommunicationObject.Open Methode

Definition

Bewirkt den Übergang eines Kommunikationsobjekts aus dem Erstellt-Zustand in den Geöffnet-Zustand.Causes a communication object to transition from the created state into the opened state.

Überlädt

Open()

Bewirkt den Übergang eines Kommunikationsobjekts aus dem Erstellt-Zustand in den Geöffnet-Zustand.Causes a communication object to transition from the created state into the opened state.

Open(TimeSpan)

Bewirkt den Übergang eines Kommunikationsobjekts innerhalb eines angegebenen Zeitraums vom Erstellt-Zustand in den Geöffnet-Zustand.Causes a communication object to transition from the created state into the opened state within a specified interval of time.

Hinweise

Versionen mit und ohne explizites Timeout werden bereitgestellt.Versions with and without an explicit timeout are provided.

Open()

Bewirkt den Übergang eines Kommunikationsobjekts aus dem Erstellt-Zustand in den Geöffnet-Zustand.Causes a communication object to transition from the created state into the opened state.

public:
 void Open();
public void Open ();
abstract member Open : unit -> unit
Public Sub Open ()

Ausnahmen

ICommunicationObject kann nicht geöffnet werden und hat den Faulted-Zustand angenommen.The ICommunicationObject was unable to be opened and has entered the Faulted state.

Das standardmäßige Öffnungstimeout ist verstrichen, bevor ICommunicationObject den Opened-Zustand annehmen konnte. Es hat jetzt den Faulted-Zustand.The default open timeout elapsed before the ICommunicationObject was able to enter the Opened state and has entered the Faulted state.

Hinweise

Wenn ein ICommunicationObject instanziiert wird, hat es zuerst den Created-Zustand.When an ICommunicationObject is instantiated, it begins in the Created state. 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.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. Aufgrund der Open-Methode nimmt ICommunicationObject den Opening-Zustand an, in dem es verbleibt, bis der Öffnungsvorgang erfolgreich war, die Zeit für den Öffnungsvorgang überschritten wird oder der Vorgang ganz fehlschlägt und das Objekt einen Fehler aufweist oder ICommunicationObject abgebrochen wird.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.

Im Opened-Zustand kann ICommunicationObject verwendet werden (beispielsweise können Nachrichten empfangen werden), es ist jedoch nicht mehr konfigurierbar.In the Opened state, the ICommunicationObject is usable (for example, messages can be received), but it is no longer configurable.

Es gibt auch eine asynchrone Version der Öffnungsmethode, die durch den Aufruf von BeginOpen initiiert wird und durch den Aufruf von EndOpen(IAsyncResult) abgeschlossen wird.There is also an asynchronous version of the open method that is initiated by calling BeginOpen and completed by calling EndOpen(IAsyncResult).

Open(TimeSpan)

Bewirkt den Übergang eines Kommunikationsobjekts innerhalb eines angegebenen Zeitraums vom Erstellt-Zustand in den Geöffnet-Zustand.Causes a communication object to transition from the created state into the opened state within a specified interval of time.

public:
 void Open(TimeSpan timeout);
public void Open (TimeSpan timeout);
abstract member Open : TimeSpan -> unit
Public Sub Open (timeout As TimeSpan)

Parameter

timeout
TimeSpan

Der TimeSpan-Wert, der angibt, welcher Zeitraum für den Sendevorgang bleibt, bevor ein Timeout eintritt.The TimeSpan that specifies how long the send operation has to complete before timing out.

Ausnahmen

ICommunicationObject kann nicht geöffnet werden und hat den Faulted-Zustand angenommen.The ICommunicationObject was unable to be opened and has entered the Faulted state.

Das festgelegte Timeout ist verstrichen, bevor ICommunicationObject den Opened-Zustand annehmen konnte. Es weist jetzt den Faulted-Zustand auf.The specified timeout elapsed before the ICommunicationObject was able to enter the Opened state and has entered the Faulted state.

Hinweise

Wenn ein ICommunicationObject instanziiert wird, hat es zuerst den Created-Zustand.When an ICommunicationObject is instantiated, it begins in the Created state. 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.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. Aufgrund der Open-Methode nimmt ICommunicationObject den Opening-Zustand an, in dem es verbleibt, bis der Öffnungsvorgang erfolgreich war, die Zeit für den Öffnungsvorgang überschritten wird oder der Vorgang ganz fehlschlägt und das Objekt einen Fehler aufweist oder ICommunicationObject abgebrochen wird.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.

Im Opened-Zustand kann ICommunicationObject verwendet werden (beispielsweise können Nachrichten empfangen werden), es ist jedoch nicht mehr konfigurierbar.In the Opened state, the ICommunicationObject is usable (for example, messages can be received), but it is no longer configurable.

Es gibt auch eine asynchrone Version der Öffnungsmethode, die durch den Aufruf von BeginOpen initiiert wird und durch den Aufruf von EndOpen(IAsyncResult) abgeschlossen wird.There is also an asynchronous version of the open method that is initiated by calling BeginOpen and completed by calling EndOpen(IAsyncResult).

Hinweise für Ausführende

Der Vorgang muss eine TimeoutException auslösen, wenn das angegebene timeout überschritten wird.The operation must throw a TimeoutException if the specified timeout is exceeded.

Gilt für: