StreamUpgradeProvider Klasse

Definition

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.dll

Implementiert einen benutzerdefinierten Upgradeanbieter, der von der abstract-Basisklasse geerbt wird.

public ref class StreamUpgradeProvider abstract : System::ServiceModel::Channels::CommunicationObject

public abstract class StreamUpgradeProvider : System.ServiceModel.Channels.CommunicationObject

type StreamUpgradeProvider = class
    inherit CommunicationObject

Public MustInherit Class StreamUpgradeProvider
Inherits CommunicationObject

Vererbung

Object

CommunicationObject

StreamUpgradeProvider

Abgeleitet

System.ServiceModel.Channels.StreamSecurityUpgradeProvider

Hinweise

Ein Beispiel für ein Streamupgrade ist das Erstellen eines Komprimierungsstreams direkt über dem Transportstream. Um eine Sicherheitsaktualisierung hinzuzufügen, implementieren Sie zusätzlich eine Klasse, die von StreamSecurityUpgradeProvider abgeleitet ist. Sie können mehrere Aktualisierungen implementieren, die die jeweils vorangehende Aktualisierung umschließen.

Der Aktualisierungsvorgang besteht aus folgenden Schritten:

1. Implementieren Sie eine Klasse, die von StreamUpgradeProvider abgeleitet ist.

2. Nehmen Sie eine Registrierung vor. Erstellen Sie dazu ein entsprechendes Bindungselement, und registrieren Sie den Anbieter in einer benutzerdefinierten Bindung.

3. Mit der abgeleiteten Klasse, die Sie implementieren, wird eine Instanz von StreamUpgradeInitiator erstellt. Damit wird zur Laufzeit eine Anforderung an das andere Ende der Verbindung zur Aktualisierung der Kanaltransportebene initialisiert.

4. Mit der abgeleiteten Klasse, die Sie implementieren, wird eine Instanz von StreamUpgradeAcceptor erstellt, die zur Laufzeit die Aktualisierungsanforderung aus dem vorhergehenden Schritt empfängt sowie ggf. die Aktualisierung akzeptiert und den aktualisierten Stream an das andere Ende der Verbindung zurückgibt.

5. Zusätzliche Aktualisierungsanforderungen werden, wie in den vorangehenden zwei Schritten beschrieben, nacheinander verarbeitet.

Konstruktoren

StreamUpgradeProvider()	Initialisiert eine neue Instanz der StreamUpgradeProvider-Klasse.
StreamUpgradeProvider(IDefaultCommunicationTimeouts)	Initialisiert eine neue Instanz der StreamUpgradeProvider-Klasse.

Eigenschaften

DefaultCloseTimeout	Ruft das DefaultCloseTimeout ab.
DefaultOpenTimeout	Ruft das DefaultOpenTimeout ab.
IsDisposed	Ruft einen Wert ab, mit dem angegeben wird, ob das Kommunikationsobjekt verworfen wurde. (Geerbt von CommunicationObject)
State	Ruft einen Wert ab, der den aktuellen Zustand des Kommunikationsobjekts angibt. (Geerbt von CommunicationObject)
ThisLock	Ruft die gegenseitig exklusive Sperre ab, die die Klasseninstanz während eines Zustandsübergangs schützt. (Geerbt von CommunicationObject)

Methoden

Abort()	Bewirkt, dass ein Kommunikationsobjekt unmittelbar vom aktuellen Zustand in den Schließzustand übergeht. (Geerbt von CommunicationObject)
BeginClose(AsyncCallback, Object)	Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu schließen. (Geerbt von CommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)	Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt mit einem festgelegten Timeout zu schließen. (Geerbt von CommunicationObject)
BeginOpen(AsyncCallback, Object)	Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu öffnen. (Geerbt von CommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)	Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt innerhalb eines festgelegten Zeitraums zu öffnen. (Geerbt von CommunicationObject)
Close()	Bewirkt, dass ein Kommunikationsobjekt vom aktuellen Zustand in den geschlossenen Zustand übergeht. (Geerbt von CommunicationObject)
Close(TimeSpan)	Bewirkt den Übergang eines Kommunikationsobjekts innerhalb eines angegebenen Zeitraums vom aktuellen Zustand in den geschlossenen Zustand. (Geerbt von CommunicationObject)
CreateUpgradeAcceptor()	Erstellt eine Instanz von StreamUpgradeAcceptor.
CreateUpgradeInitiator(EndpointAddress, Uri)	Erstellt eine Instanz von StreamUpgradeInitiator.
EndClose(IAsyncResult)	Beendet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu schließen. (Geerbt von CommunicationObject)
EndOpen(IAsyncResult)	Beendet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu öffnen. (Geerbt von CommunicationObject)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
Fault()	Bewirkt, dass ein Kommunikationsobjekt vom aktuellen Zustand in den Fehlerzustand übergeht. (Geerbt von CommunicationObject)
GetCommunicationObjectType()	Ruft den Typ des Kommunikationsobjekts ab. (Geerbt von CommunicationObject)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetProperty<T>()	Bei der Implementierung in einer abgeleiteten Klasse wird eine Eigenschaft des aktuellen Datenstroms abgerufen, der einen Initiator eines Datenstromupgrades darstellt.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnAbort()	Setzt Verarbeitung auf einem Kommunikationsobjekt ein, nachdem aufgrund des Aufrufs eines synchronen Abbruchvorgangs der Übergang zum Schließen-Status eingesetzt hat. (Geerbt von CommunicationObject)
OnBeginClose(TimeSpan, AsyncCallback, Object)	Fügt nach dem Übergang des Kommunikationsobjekts in den Schließzustand aufgrund des Aufrufs eines asynchronen Schließvorgangs Verarbeitungen ein. (Geerbt von CommunicationObject)
OnBeginOpen(TimeSpan, AsyncCallback, Object)	Fügt Verarbeitung auf einem Kommunikationsobjekt ein, nachdem aufgrund des Aufrufs eines asynchronen Öffnungsvorgangs der Übergang in den Öffnungszustand stattgefunden hat. (Geerbt von CommunicationObject)
OnClose(TimeSpan)	Fügt Verarbeitung auf einem Kommunikationsobjekt ein, nachdem aufgrund des Aufrufs eines synchronen Schließvorgangs der Übergang zum Schließenzustand stattgefunden hat. (Geerbt von CommunicationObject)
OnClosed()	Wird während des Übergangs eines Kommunikationsobjekts in den Schließzustand aufgerufen. (Geerbt von CommunicationObject)
OnClosing()	Wird während des Übergangs eines Kommunikationsobjekts in den Schließzustand aufgerufen. (Geerbt von CommunicationObject)
OnEndClose(IAsyncResult)	Beendet beim Schließen eines Kommunikationsobjekts einen asynchronen Vorgang. (Geerbt von CommunicationObject)
OnEndOpen(IAsyncResult)	Beendet beim Öffnen eines Kommunikationsobjekts einen asynchronen Vorgang. (Geerbt von CommunicationObject)
OnFaulted()	Fügt Verarbeitung auf einem Kommunikationsobjekt ein, nachdem aufgrund des Aufrufs eines synchronen Fehlervorgangs der Übergang zum Fehlerzustand stattgefunden hat. (Geerbt von CommunicationObject)
OnOpen(TimeSpan)	Fügt Verarbeitung auf einem Kommunikationsobjekt ein, nachdem der Übergang zum Öffnungsstatus stattgefunden hat, der innerhalb eines festgelegten Zeitintervalls abgeschlossen sein muss. (Geerbt von CommunicationObject)
OnOpened()	Wird während des Übergangs eines Kommunikationsobjekts in den Geöffnet-Zustand aufgerufen. (Geerbt von CommunicationObject)
OnOpening()	Wird während des Übergangs eines Kommunikationsobjekts in den Öffnungszustand aufgerufen. (Geerbt von CommunicationObject)
Open()	Bewirkt den Übergang eines Kommunikationsobjekts aus dem Erstellt-Zustand in den Geöffnet-Zustand. (Geerbt von CommunicationObject)
Open(TimeSpan)	Bewirkt den Übergang eines Kommunikationsobjekts innerhalb eines angegebenen Zeitraums vom Erstellt-Zustand in den Geöffnet-Zustand. (Geerbt von CommunicationObject)
ThrowIfDisposed()	Löst eine Ausnahme aus, wenn das Kommunikationsobjekt verworfen wird. (Geerbt von CommunicationObject)
ThrowIfDisposedOrImmutable()	Löst eine Ausnahme aus, wenn das Kommunikationsobjekt der State-Eigenschaft nicht auf den Created-Zustand festgelegt wurde. (Geerbt von CommunicationObject)
ThrowIfDisposedOrNotOpen()	Löst eine Ausnahme aus, wenn sich das Kommunikationsobjekt nicht im Opened-Zustand befindet. (Geerbt von CommunicationObject)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Ereignisse

Closed	Tritt ein, sobald ein Kommunikationsobjekt in den geschlossenen Zustand übergeht. (Geerbt von CommunicationObject)
Closing	Tritt ein, sobald ein Kommunikationsobjekt in den Schließzustand übergeht. (Geerbt von CommunicationObject)
Faulted	Tritt ein, sobald ein Kommunikationsobjekt in den Fehlerzustand übergeht. (Geerbt von CommunicationObject)
Opened	Tritt ein, sobald ein Kommunikationsobjekt in den Geöffnet-Zustand übergeht. (Geerbt von CommunicationObject)
Opening	Tritt ein, sobald ein Kommunikationsobjekt in den Öffnungszustand übergeht. (Geerbt von CommunicationObject)

Siehe auch

• Benutzerdefinierte Stream-Upgrades