Exportieren (0) Drucken
Alle erweitern
Erweitern Minimieren
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

CommunicationState-Enumeration

Definiert die Zustände, in denen ein ICommunicationObject existieren kann.

Namespace:  System.ServiceModel
Assembly:  System.ServiceModel (in System.ServiceModel.dll)

public enum CommunicationState

MembernameBeschreibung
Unterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsClosedGibt an, dass das Kommunikationsobjekt geschlossen wurde und nicht länger verwendbar ist.
Unterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsClosingGibt an, dass das Kommunikationsobjekt in den Zustand Closed übergeht.
Unterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsCreatedGibt an, dass das Kommunikationsobjekt instantiiert wurde und konfigurierbar ist, jedoch noch nicht geöffnet oder bereit für die Verwendung.
Unterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsFaultedGibt an, dass das Kommunikationsobjekt auf einen Fehler gestoßen ist, den es nicht beheben kann und ab dem es nicht mehr verwendbar ist.
Unterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsOpenedGibt an, dass das Kommunikationsobjekt jetzt geöffnet und verwendungsbereit ist.
Unterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsOpeningGibt an, dass das Kommunikationsobjekt vom Zustand Created in den Zustand Opened übergeht.

Diese Enumeration definiert die Zustände, die für alle Kommunikationsobjekte im System gültig sind, einschließlich Kanäle, Listener, Factorys, Verteiler und Diensthosts.

Die Methoden, die die Übergänge zwischen diesen Zuständen und den Ereignissen verwalten, die diesen zugeordnet werden können, werden in der ICommunicationObject-Schnittstelle definiert. Der Zustand eines Objekts kann unter Verwendung der State-Eigenschaft abgerufen werden.

Es gibt vier Hauptzustände und zwei flüchtige Zustände, die ein Kommunikationsobjekt einnehmen kann. Die Hauptzustände sind:

  • Created

  • Opened

  • Closed

  • Faulted

Die zwei flüchtigen Zustände, die ein Kommunikationsobjekt beim Übergang zwischen diesen Hauptzuständen einnehmen kann, sind:

  • Opening

  • Closing

Das Kommunikationsobjekt kann im Zustand Created konfiguriert werden. Es können beispielsweise seine Eigenschaften geändert und seine Ereignisse registriert werden. In diesem Zustand kann keine Eingabe oder Ausgabe erfolgen. Daher können beispielsweise keine Meldungen aus einem Kanal in diesem Zustand gesendet oder von diesem empfangen werden.

Der Zustand Opening ist ein temporärer Zustand, den das Kommunikationsobjekt annimmt, wenn die Open-Methode aufgerufen wird. Sofern nicht anderweitig für abgeleitete Klassen angegeben, können Objekte im Öffnungszustand nicht konfiguriert werden. Dieser Übergangszustand kann nur vom Zustand Created aus angenommen werden.

Die Objekte gehen in den Zustand Opened über, wenn der Öffnungsprozess abgeschlossen ist. Dieser Übergang in den Zustand Opened ist nur vom Zustand Opening aus gültig. Sofern nicht anderweitig für abgeleitete Klassen angegeben, ist die Konfiguration des Objekts nun deaktiviert. Zu diesem Zeitpunkt kann das Objekt in vollem Umfang für die Meldungsübertragung verwendet werden.

Der Zustand Closing ist ein temporärer Zustand, den das Kommunikationsobjekt annimmt, wenn die Close-Methode für ein ordnungsgemäßen Herunterfahren aufgerufen wird, oder wenn das Objekt angebrochen wird. An diesem Punkt wird das Objekt nicht mehr verwendbar (wenn es dies nicht bereits ist). Dieser Übergang ist von jedem Zustand aus gültig, mit Ausnahme des Zustands Closed.

Der Zustand Closed ist gleichwertig mit dem Freigeben, und die Konfiguration des Objekts kann weiterhin geprüft werden.

Der Zustand Faulted wird verwendet, um anzugeben, dass das Objekt in einen Zustand übergegangen ist, in dem es nicht mehr verwendet werden kann. Es gibt zwei primäre Szenarien, in denen dies geschehen kann.

  • Wenn die Open-Methode fehlschlägt, geht das Objekt in den Fehlerzustand über.

  • Wenn ein sitzungsbasierter Kanal einen Fehler feststellt, den er nicht beheben kann, geht er in den Fehlerzustand über. Dies kann beispielsweise geschehen, wenn ein Protokollfehler vorliegt (d. h., eine Protokollmeldung wird zu einem ungültigen Zeitpunkt empfangen), oder wenn der Remoteendpunkt die Sitzung abbricht.

Ein Objekt im Faulted-Zustand ist nicht geschlossen und kann Ressourcen belegen. Die Abort-Methode sollte verwendet werden, um ein Objekt zu schließen, bei dem ein Fehler aufgetreten ist. Wenn Close für ein Objekt im Zustand Faulted aufgerufen wird, so wird eine CommunicationObjectFaultedException ausgelöst, da das Objekt nicht ordnungsgemäß geschlossen werden kann.

.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Portable Klassenbibliothek

Unterstützt in: Portable Klassenbibliothek

.NET für Windows Store-Apps

Unterstützt in: Windows 8

.NET für Windows Phone-Apps

Unterstützt in: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2015 Microsoft