CommunicationObject.Close Method

Definition

Bewirkt, dass ein Kommunikationsobjekt vom aktuellen Zustand in den geschlossenen Zustand übergeht. Causes a communication object to transition from its current state into the closed state.

Überlädt

Close()

Bewirkt, dass ein Kommunikationsobjekt vom aktuellen Zustand in den geschlossenen Zustand übergeht. Causes a communication object to transition from its current state into the closed state.

Close(TimeSpan)

Bewirkt den Übergang eines Kommunikationsobjekts innerhalb eines angegebenen Zeitraums vom aktuellen Zustand in den geschlossenen Zustand. Causes a communication object to transition from its current state into the closed state within a specified interval of time.

Close()

Bewirkt, dass ein Kommunikationsobjekt vom aktuellen Zustand in den geschlossenen Zustand übergeht. Causes a communication object to transition from its current state into the closed state.

public void Close ();
Implementiert
Ausnahmen

Das Kommunikationsobjekt befindet sich nicht in einem Opened-Zustand oder einem Opening-Zustand und kann nicht geändert werden. The communication object is not in a Opened or Opening state and cannot be modified.

Das Kommunikationsobjekt befindet sich in einem Closing-Zustand oder einem Closed-Zustand und kann nicht geändert werden. The communication object is in a Closing or Closed state and cannot be modified.

Das Kommunikationsobjekt befindet sich in einem Faulted-Zustand und kann nicht geändert werden. The communication object is in a Faulted state and cannot be modified.

Das Standardzeitintervall, das dem Vorgang zugewiesen wurde, wurde vor dem Abschluss des Vorgangs überschritten. The default interval of time that was allotted for the operation was exceeded before the operation was completed.

Hinweise

Mit dieser Methode kann ein CommunicationObject ordnungsgemäß von einem beliebigen Zustand, mit Ausnahme des Closed-Zustands, in den Closed-Zustand übergehen.This method causes a CommunicationObject to gracefully transition from any state, other than the Closed state, into the Closed state. Mit der Close-Methode können unerledigte Aufgaben vor der Rückgabe abgeschlossen werden.The Close method allows any unfinished work to be completed before returning. Schließen Sie z. B. den Versand von gepufferten Nachrichten ab.For example, finish sending any buffered messages.

Das CommunicationObject geht in den Closing-Zustand über und behält ihn auch nachdem die Close-Methode aufgerufen wurde bei, bis der Übergang in den Closed-Zustand abgeschlossen ist.The CommunicationObject enters the Closing state and remains in it after the Close method is called until the transition to the Closed state is completed. Der Übergang besteht aus aufeinander folgenden Aufrufen von OnClosing, OnClose(TimeSpan) und OnClosed.The transition consists of making successive calls to OnClosing, OnClose(TimeSpan), and OnClosed.

Es gibt auch eine asynchrone Version der Schließen-Methode, die durch den Aufruf von BeginClose initiiert wird.There is also an asynchronous version of the close method that is initiated by calling BeginClose.

Close(TimeSpan)

Bewirkt den Übergang eines Kommunikationsobjekts innerhalb eines angegebenen Zeitraums vom aktuellen Zustand in den geschlossenen Zustand. Causes a communication object to transition from its current state into the closed state within a specified interval of time.

public void Close (TimeSpan timeout);
Parameter
timeout
TimeSpan

Die TimeSpan, die angibt, welcher Zeitraum für das Schließen bleibt, bevor ein Timeout auftritt. The TimeSpan that specifies how long the close operation has to complete before timing out.

Implementiert
Ausnahmen

Das Kommunikationsobjekt befindet sich nicht in einem Opened-Zustand oder einem Opening-Zustand und kann nicht geändert werden. The communication object is not in a Opened or Opening state and cannot be modified.

Das Kommunikationsobjekt befindet sich in einem Closing-Zustand oder einem Closed-Zustand und kann nicht geändert werden. The communication object is in a Closing or Closed state and cannot be modified.

Das Kommunikationsobjekt befindet sich in einem Faulted-Zustand und kann nicht geändert werden. The communication object is in a Faulted state and cannot be modified.

Das Standardzeitintervall, das dem Vorgang zugewiesen wurde, wurde vor dem Abschluss des Vorgangs überschritten. The default interval of time that was allotted for the operation was exceeded before the operation was completed.

Hinweise

Mit dieser Methode kann ein CommunicationObject ordnungsgemäß und in einem angegebenen Zeitraum von einem beliebigen Zustand, mit Ausnahme des Closed-Zustands, in den Closed-Zustand übergehen.This method causes a CommunicationObject to gracefully transition from any state, other than the Closed state, into the Closed state within a specified interval of time. Mit der Close-Methode können unerledigte Aufgaben vor der Rückgabe abgeschlossen werden.The Close method allows any unfinished work to be completed before returning. Schließen Sie z. B. den Versand von gepufferten Nachrichten ab.For example, finish sending any buffered messages.

Das CommunicationObject geht in den Closing-Zustand über und behält ihn auch nachdem die Close-Methode aufgerufen wurde bei, bis der Übergang in den Closed-Zustand abgeschlossen ist.The CommunicationObject enters the Closing state and remains in it after the Close method is called until the transition to the Closed state is completed. Der Übergang besteht aus aufeinander folgenden Aufrufen von OnClosing, OnClose(TimeSpan) und OnClosed.The transition consists of making successive calls to OnClosing, OnClose(TimeSpan) and OnClosed.

Es gibt auch eine asynchrone Version der Schließen-Methode, die durch den Aufruf von BeginClose initiiert wird.There is also an asynchronous version of the close method that is initiated by calling BeginClose.

Gilt für: