ChannelFactory Klasse
TOC
Inhaltsverzeichnis reduzieren
Inhaltsverzeichnis erweitern
Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

ChannelFactory-Klasse

 

Erstellt und verwaltet die Kanäle, die von Clients zum Senden von Nachrichten an Dienstendpunkte verwendet werden.

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


public ref class ChannelFactory abstract : CommunicationObject, 
	IChannelFactory, ICommunicationObject, IDisposable

NameBeschreibung
System_CAPS_protmethodChannelFactory()

Initialisiert eine neue Instanz der ChannelFactory-Klasse.

NameBeschreibung
System_CAPS_pubpropertyCredentials

Ruft die Anmeldeinformationen ab, die von Clients für die Kommunikation mit einem Dienstendpunkt über die von der Factory erzeugten Kanäle verwendet werden.

System_CAPS_protpropertyDefaultCloseTimeout

Ruft das Standardzeitintervall ab, das für den Abschluss eines Schließvorgangs bereitgestellt wird.(Setzt "CommunicationObject::DefaultCloseTimeout" außer Kraft.)

System_CAPS_protpropertyDefaultOpenTimeout

Ruft das Zeitintervall ab, das für den Abschluss eines Öffnungsvorgangs bereitgestellt wird.(Setzt "CommunicationObject::DefaultOpenTimeout" außer Kraft.)

System_CAPS_pubpropertyEndpoint

Ruft den Dienstendpunkt ab, zu dem die von der Factory erzeugten Kanäle eine Verbindung aufbauen.

System_CAPS_protpropertyIsDisposed

Ruft einen Wert ab, mit dem angegeben wird, ob das Kommunikationsobjekt verworfen wurde.(Geerbt von CommunicationObject.)

System_CAPS_pubpropertyState

Ruft einen Wert ab, der den aktuellen Zustand des Kommunikationsobjekts angibt.(Geerbt von CommunicationObject.)

System_CAPS_protpropertyThisLock

Ruft die gegenseitig exklusive Sperre ab, die die Klasseninstanz während eines Zustandsübergangs schützt.(Geerbt von CommunicationObject.)

NameBeschreibung
System_CAPS_pubmethodAbort()

Bewirkt, dass ein Kommunikationsobjekt unmittelbar vom aktuellen Zustand in den Schließzustand übergeht.(Geerbt von CommunicationObject.)

System_CAPS_protmethodApplyConfiguration(String^)

Initialisiert die Kanalfactory mit den Verhaltensweisen, die von einer bestimmten Konfigurationsdatei bereitgestellt werden, sowie mit den Verhaltensweisen im Dienstendpunkt der Kanalfactory.

System_CAPS_pubmethodBeginClose(AsyncCallback^, Object^)

Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu schließen.(Geerbt von CommunicationObject.)

System_CAPS_pubmethodBeginClose(TimeSpan, AsyncCallback^, Object^)

Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt mit einem festgelegten Timeout zu schließen.(Geerbt von CommunicationObject.)

System_CAPS_pubmethodBeginOpen(AsyncCallback^, Object^)

Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu öffnen.(Geerbt von CommunicationObject.)

System_CAPS_pubmethodBeginOpen(TimeSpan, AsyncCallback^, Object^)

Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt innerhalb eines festgelegten Zeitraums zu öffnen.(Geerbt von CommunicationObject.)

System_CAPS_pubmethodClose()

Bewirkt, dass ein Kommunikationsobjekt vom aktuellen Zustand in den geschlossenen Zustand übergeht.(Geerbt von CommunicationObject.)

System_CAPS_pubmethodClose(TimeSpan)

Bewirkt den Übergang eines Kommunikationsobjekts innerhalb eines angegebenen Zeitraums vom aktuellen Zustand in den geschlossenen Zustand.(Geerbt von CommunicationObject.)

System_CAPS_protmethodCreateDescription()

Erstellt beim Implementieren in einer abgeleiteten Klasse eine Beschreibung des Dienstendpunkts, der der Kanalfactory zugeordnet ist.

System_CAPS_protmethodCreateFactory()

Erstellt die Kanalfactory für den aktuellen Endpunkt der Factory.

System_CAPS_pubmethodEndClose(IAsyncResult^)

Beendet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu schließen.(Geerbt von CommunicationObject.)

System_CAPS_pubmethodEndOpen(IAsyncResult^)

Beendet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu öffnen.(Geerbt von CommunicationObject.)

System_CAPS_protmethodEnsureOpened()

Öffnet die aktuelle Kanalfactory, sofern diese noch nicht geöffnet ist.

System_CAPS_pubmethodEquals(Object^)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von Object.)

System_CAPS_protmethodFault()

Bewirkt, dass ein Kommunikationsobjekt vom aktuellen Zustand in den Fehlerzustand übergeht.(Geerbt von CommunicationObject.)

System_CAPS_protmethodFinalize()

Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Geerbt von Object.)

System_CAPS_protmethodGetCommunicationObjectType()

Ruft den Typ des Kommunikationsobjekts ab.(Geerbt von CommunicationObject.)

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von Object.)

System_CAPS_pubmethodGetProperty<T>()

Gibt das angeforderte typisierte Objekt von der entsprechenden Ebene im Kanalstapel zurück, wenn es vorhanden ist, oder null, wenn es nicht vorhanden ist.

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von Object.)

System_CAPS_protmethodInitializeEndpoint(Binding^, EndpointAddress^)

Initialisiert den Dienstendpunkt der Kanalfactory mit einer angegebenen Bindung und Adresse.

System_CAPS_protmethodInitializeEndpoint(ServiceEndpoint^)

Initialisiert den Dienstendpunkt der Kanalfactory mit einem angegebenen Endpunkt.

System_CAPS_protmethodInitializeEndpoint(String^, EndpointAddress^)

Initialisiert den Dienstendpunkt der Kanalfactory mit einer angegebenen Adresse und Konfiguration.

System_CAPS_protmethodMemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von Object.)

System_CAPS_protmethodOnAbort()

Beendet die innere Kanalfactory der aktuellen Kanalfactory.(Setzt "CommunicationObject::OnAbort()" außer Kraft.)

System_CAPS_protmethodOnBeginClose(TimeSpan, AsyncCallback^, Object^)

Startet einen asynchronen Schließvorgang in der inneren Kanalfactory der aktuellen Kanalfactory, der ein Statusobjekt zugeordnet ist.(Setzt "CommunicationObject::OnBeginClose(TimeSpan, AsyncCallback^, Object^)" außer Kraft.)

System_CAPS_protmethodOnBeginOpen(TimeSpan, AsyncCallback^, Object^)

Startet einen asynchronen Öffnungsvorgang in der inneren Kanalfactory der aktuellen Kanalfactory, der ein Statusobjekt zugeordnet ist.(Setzt "CommunicationObject::OnBeginOpen(TimeSpan, AsyncCallback^, Object^)" außer Kraft.)

System_CAPS_protmethodOnClose(TimeSpan)

Aufrufe werden in der inneren Kanalfactory mit einem angegebenen Timeout zum Abschluss des Vorgangs geschlossen.(Setzt "CommunicationObject::OnClose(TimeSpan)" außer Kraft.)

System_CAPS_protmethodOnClosed()

Wird während des Übergangs eines Kommunikationsobjekts in den Schließzustand aufgerufen.(Geerbt von CommunicationObject.)

System_CAPS_protmethodOnClosing()

Wird während des Übergangs eines Kommunikationsobjekts in den Schließzustand aufgerufen.(Geerbt von CommunicationObject.)

System_CAPS_protmethodOnEndClose(IAsyncResult^)

Schließt einen asynchronen Schließvorgang in der inneren Kanalfactory der aktuellen Kanalfactory ab.(Setzt "CommunicationObject::OnEndClose(IAsyncResult^)" außer Kraft.)

System_CAPS_protmethodOnEndOpen(IAsyncResult^)

Schließt einen asynchronen Öffnungsvorgang in der inneren Kanalfactory der aktuellen Kanalfactory ab.(Setzt "CommunicationObject::OnEndOpen(IAsyncResult^)" außer Kraft.)

System_CAPS_protmethodOnFaulted()

Fügt Verarbeitung auf einem Kommunikationsobjekt ein, nachdem aufgrund des Aufrufs eines synchronen Fehlervorgangs der Übergang zum Fehlerzustand stattgefunden hat.(Geerbt von CommunicationObject.)

System_CAPS_protmethodOnOpen(TimeSpan)

Aufrufe werden in der inneren Kanalfactory der aktuellen Kanalfactory mit einem angegebenen Timeout zum Abschluss des Vorgangs geöffnet.(Setzt "CommunicationObject::OnOpen(TimeSpan)" außer Kraft.)

System_CAPS_protmethodOnOpened()

Initialisiert eine schreibgeschützte Kopie des ClientCredentials-Objekts für die Kanalfactory.(Setzt "CommunicationObject::OnOpened()" außer Kraft.)

System_CAPS_protmethodOnOpening()

Erstellt die innere Kanalfactory für den aktuellen Kanal.(Setzt "CommunicationObject::OnOpening()" außer Kraft.)

System_CAPS_pubmethodOpen()

Bewirkt den Übergang eines Kommunikationsobjekts aus dem Erstellt-Zustand in den Geöffnet-Zustand.(Geerbt von CommunicationObject.)

System_CAPS_pubmethodOpen(TimeSpan)

Bewirkt den Übergang eines Kommunikationsobjekts innerhalb eines angegebenen Zeitraums vom Erstellt-Zustand in den Geöffnet-Zustand.(Geerbt von CommunicationObject.)

System_CAPS_protmethodThrowIfDisposed()

Löst eine Ausnahme aus, wenn das Kommunikationsobjekt verworfen wird.(Geerbt von CommunicationObject.)

System_CAPS_protmethodThrowIfDisposedOrImmutable()

Löst eine Ausnahme aus, wenn das Kommunikationsobjekt der State-Eigenschaft nicht auf den Created-Zustand festgelegt wurde.(Geerbt von CommunicationObject.)

System_CAPS_protmethodThrowIfDisposedOrNotOpen()

Löst eine Ausnahme aus, wenn sich das Kommunikationsobjekt nicht im Opened-Zustand befindet.(Geerbt von CommunicationObject.)

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von Object.)

NameBeschreibung
System_CAPS_pubeventClosed

Tritt ein, sobald ein Kommunikationsobjekt in den geschlossenen Zustand übergeht.(Geerbt von CommunicationObject.)

System_CAPS_pubeventClosing

Tritt ein, sobald ein Kommunikationsobjekt in den Schließzustand übergeht.(Geerbt von CommunicationObject.)

System_CAPS_pubeventFaulted

Tritt ein, sobald ein Kommunikationsobjekt in den Fehlerzustand übergeht.(Geerbt von CommunicationObject.)

System_CAPS_pubeventOpened

Tritt ein, sobald ein Kommunikationsobjekt in den Geöffnet-Zustand übergeht.(Geerbt von CommunicationObject.)

System_CAPS_pubeventOpening

Tritt ein, sobald ein Kommunikationsobjekt in den Öffnungszustand übergeht.(Geerbt von CommunicationObject.)

NameBeschreibung
System_CAPS_pubinterfaceSystem_CAPS_privmethodIDisposable::Dispose()

Schließt die aktuelle Kanalfactory.

Kanalfactorys, die die IChannelFactory-Schnittstelle und deren zugehörige Kanäle implementieren, werden in der Regel von den Initiatoren eines Kommunikationsmusters verwendet. Listenerfactorys, die die IChannelListener-Schnittstelle und deren zugehörigen Listener implementieren, stellen die Mechanismen bereit, mit denen Kanäle für die Kommunikation akzeptiert werden.

Diese Klasse ist nicht Teil des Kanal- sondern des Dienstmodells. Die CreateFactory-Methode bietet die Mittel zum Erstellen von IChannelFactory für einen Dienstendpunkt. Verwenden Sie sie, um einen Client zu erstellen, der eine Verknüpfung zu einem Schnittstellenvertrag auf dem Dienst herstellt, ohne Metadaten oder Richtlinien zu verwenden.

System_CAPS_noteHinweis

Durch das Festlegen von ChannelFactory.Credentials.Windows.AllowedImpersonationLevel auf TokenImpersonationLevel.Anonymous wird stets eine anonyme Anmeldung ausgeführt, unabhängig von der Identitätswechselebene.

Spezieller Hinweis für Benutzer von Managed C++, die von dieser Klasse ableiten:

  • Fügen Sie den Bereinigungscode in (On)(Begin)Close (and/or OnAbort) ein, nicht in einen Destruktor.

  • Vermeiden Sie Destruktoren: Sie bewirken, dass der Compiler IDisposable automatisch generiert.

  • Vermeiden Sie Member ohne Verweis: Sie können bewirken, dass der Compiler IDisposable automatisch generiert.

  • Vermeiden Sie die Verwendung eines Finalizers: Wenn Sie dennoch einen Finalizer verwenden, sollten Sie die Buildwarnung unterdrücken und SuppressFinalize(Object^) sowie den Finalizer über (On)(Begin)Close (and/or OnAbort) aufrufen, um das ansonsten automatisch generierte IDisposable-Verhalten zu emulieren.

Beim programmgesteuerten Hinzufügen von Verhalten, wird das Verhalten vor dem Erstellen eines Kanals der entsprechenden Behaviors-Eigenschaft in der ChannelFactory hinzugefügt. Ein Codebeispiel finden Sie im Beispielabschnitt.

Im folgenden Codebeispiel wird das programmgesteuerte Einfügen eines Clientverhaltens vor dem Erstellen des Kanalobjekts durch die Factory veranschaulicht.

Derzeit ist kein Code Beispiel verfügbar, oder die Sprache wird nicht unterstützt.

Universal Windows Platform
Verfügbar seit 8
.NET Framework
Verfügbar seit 3.0
Portable Class Library
Unterstützt in: portable .NET platforms
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0

Öffentliche statische (in Visual Basic freigegebene) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Zurück zum Anfang
Anzeigen:
© 2016 Microsoft