StreamUpgradeProvider Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Implementiert einen benutzerdefinierten Upgradeanbieter, der von dieser abstract Basisklasse geerbt wird.
public ref class StreamUpgradeProvider abstract : System::ServiceModel::Channels::CommunicationObjectpublic abstract class StreamUpgradeProvider : System.ServiceModel.Channels.CommunicationObjecttype StreamUpgradeProvider = class
inherit CommunicationObjectPublic MustInherit Class StreamUpgradeProvider
Inherits CommunicationObject- Vererbung
- Abgeleitet
Hinweise
Ein Beispiel für ein Streamupgrade besteht darin, einen Komprimierungsstream direkt über dem Transportdatenstrom zu erstellen. Um ein Sicherheitsupgrade hinzuzufügen, implementieren Sie zusätzlich eine Klasse, die von StreamSecurityUpgradeProvider. Sie können mehrere Upgrades implementieren, die jeweils den vorherigen umschließen.
Der Upgradevorgang umfasst die folgenden Schritte:
Implementieren Sie eine Klasse, die von StreamUpgradeProviderabgeleitet wird.
Registrieren Sie sie. Dazu erstellen Sie ein Bindungselement dafür und registrieren den Anbieter in einer benutzerdefinierten Bindung.
Die abgeleitete Klasse, die Sie implementieren, erstellt eine Instanz von StreamUpgradeInitiator, die zur Laufzeit eine Anforderung an das andere Ende der Verbindung initiiert, um die Kanaltransportebene zu aktualisieren.
Die abgeleitete Klasse, die Sie implementieren, erstellt eine Instanz von StreamUpgradeAcceptor, die zur Laufzeit die Upgradeanforderung aus dem vorherigen Schritt empfängt und, falls möglich, das Upgrade akzeptiert und den aktualisierten Datenstrom an die andere Seite der Verbindung zurückgibt.
Wenn zusätzliche Upgradeanforderungen vorhanden sind, werden sie sequenziell verarbeitet, wie in den vorherigen beiden Schritten beschrieben.
Konstruktoren
| Name | Beschreibung |
|---|---|
| StreamUpgradeProvider() |
Initialisiert eine neue Instanz der StreamUpgradeProvider-Klasse. |
| StreamUpgradeProvider(IDefaultCommunicationTimeouts) |
Initialisiert eine neue Instanz der StreamUpgradeProvider-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| DefaultCloseTimeout |
Ruft den DefaultCloseTimeout ab. |
| DefaultOpenTimeout |
Ruft das DefaultOpenTimeout ab. |
| IsDisposed |
Ruft einen Wert ab, der angibt, ob das Kommunikationsobjekt verworfen wurde. (Geerbt von CommunicationObject) |
| State |
Ruft einen Wert ab, der den aktuellen Status des Kommunikationsobjekts angibt. (Geerbt von CommunicationObject) |
| ThisLock |
Ruft die sich gegenseitig ausschließende Sperre ab, die die Klasseninstanz während eines Zustandsübergangs schützt. (Geerbt von CommunicationObject) |
Methoden
| Name | Beschreibung |
|---|---|
| Abort() |
Bewirkt, dass ein Kommunikationsobjekt sofort vom aktuellen Zustand in den Schließen-Zustand wechselt. (Geerbt von CommunicationObject) |
| BeginClose(AsyncCallback, Object) |
Startet einen asynchronen Vorgang zum Schließen eines Kommunikationsobjekts. (Geerbt von CommunicationObject) |
| BeginClose(TimeSpan, AsyncCallback, Object) |
Startet einen asynchronen Vorgang zum Schließen eines Kommunikationsobjekts mit einem angegebenen Timeout. (Geerbt von CommunicationObject) |
| BeginOpen(AsyncCallback, Object) |
Startet einen asynchronen Vorgang zum Öffnen eines Kommunikationsobjekts. (Geerbt von CommunicationObject) |
| BeginOpen(TimeSpan, AsyncCallback, Object) |
Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt innerhalb eines bestimmten Zeitintervalls zu öffnen. (Geerbt von CommunicationObject) |
| Close() |
Bewirkt, dass ein Kommunikationsobjekt vom aktuellen Zustand in den geschlossenen Zustand wechselt. (Geerbt von CommunicationObject) |
| Close(TimeSpan) |
Bewirkt, dass ein Kommunikationsobjekt innerhalb eines bestimmten Zeitintervalls vom aktuellen Zustand in den geschlossenen Zustand wechselt. (Geerbt von CommunicationObject) |
| CreateUpgradeAcceptor() |
Erstellt eine Instanz von StreamUpgradeAcceptor. |
| CreateUpgradeInitiator(EndpointAddress, Uri) |
Erstellt eine Instanz von StreamUpgradeInitiator. |
| EndClose(IAsyncResult) |
Schließt einen asynchronen Vorgang zum Schließen eines Kommunikationsobjekts ab. (Geerbt von CommunicationObject) |
| EndOpen(IAsyncResult) |
Schließt einen asynchronen Vorgang zum Öffnen eines Kommunikationsobjekts ab. (Geerbt von CommunicationObject) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| Fault() |
Bewirkt, dass ein Kommunikationsobjekt vom aktuellen Zustand in den fehlerhaften Zustand wechselt. (Geerbt von CommunicationObject) |
| GetCommunicationObjectType() |
Ruft den Typ des Kommunikationsobjekts ab. (Geerbt von CommunicationObject) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetProperty<T>() |
Ruft bei der Implementierung in einer abgeleiteten Klasse eine Eigenschaft des aktuellen Datenstroms ab, die einen Initiator eines Datenstromupgrades darstellt. |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| OnAbort() |
Fügt die Verarbeitung in ein Kommunikationsobjekt ein, nachdem es aufgrund des Aufrufs eines synchronen Abbruchvorgangs in den Abschlusszustand wechselt. (Geerbt von CommunicationObject) |
| OnBeginClose(TimeSpan, AsyncCallback, Object) |
Fügt die Verarbeitung nach einem Kommunikationsobjekt aufgrund des Aufrufs eines asynchronen Close-Vorgangs in den Abschlusszustand ein. (Geerbt von CommunicationObject) |
| OnBeginOpen(TimeSpan, AsyncCallback, Object) |
Fügt die Verarbeitung eines Kommunikationsobjekts ein, nachdem es aufgrund des Aufrufs eines asynchronen Geöffneten Vorgangs in den Öffnungszustand wechselt. (Geerbt von CommunicationObject) |
| OnClose(TimeSpan) |
Fügt die Verarbeitung eines Kommunikationsobjekts ein, nachdem es aufgrund des Aufrufs eines synchronen Close-Vorgangs zum Abschlusszustand wechselt. (Geerbt von CommunicationObject) |
| OnClosed() |
Wird während des Übergangs eines Kommunikationsobjekts in den Abschlusszustand aufgerufen. (Geerbt von CommunicationObject) |
| OnClosing() |
Wird während des Übergangs eines Kommunikationsobjekts in den Abschlusszustand aufgerufen. (Geerbt von CommunicationObject) |
| OnEndClose(IAsyncResult) |
Schließt einen asynchronen Vorgang zum Schließen eines Kommunikationsobjekts ab. (Geerbt von CommunicationObject) |
| OnEndOpen(IAsyncResult) |
Schließt einen asynchronen Vorgang beim Öffnen eines Kommunikationsobjekts ab. (Geerbt von CommunicationObject) |
| OnFaulted() |
Fügt die Verarbeitung in ein Kommunikationsobjekt ein, nachdem es aufgrund des Aufrufs eines synchronen Fehlervorgangs in den fehlerhaften Zustand wechselt. (Geerbt von CommunicationObject) |
| OnOpen(TimeSpan) |
Fügt die Verarbeitung für ein Kommunikationsobjekt ein, nachdem es in den Öffnungszustand übergibt, der innerhalb eines bestimmten Zeitintervalls abgeschlossen werden muss. (Geerbt von CommunicationObject) |
| OnOpened() |
Wird während des Übergangs eines Kommunikationsobjekts in den geöffneten Zustand aufgerufen. (Geerbt von CommunicationObject) |
| OnOpening() |
Wird während des Übergangs eines Kommunikationsobjekts in den Öffnungszustand aufgerufen. (Geerbt von CommunicationObject) |
| Open() |
Bewirkt, dass ein Kommunikationsobjekt vom erstellten Zustand in den geöffneten Zustand wechselt. (Geerbt von CommunicationObject) |
| Open(TimeSpan) |
Bewirkt, dass ein Kommunikationsobjekt innerhalb eines bestimmten Zeitintervalls vom erstellten Zustand in den geöffneten Zustand wechselt. (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, das die State Eigenschaft nicht auf den Created Zustand festgelegt ist. (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
| Name | Beschreibung |
|---|---|
| Closed |
Tritt auf, wenn ein Kommunikationsobjekt in den geschlossenen Zustand wechselt. (Geerbt von CommunicationObject) |
| Closing |
Tritt auf, wenn ein Kommunikationsobjekt in den Schließen-Zustand wechselt. (Geerbt von CommunicationObject) |
| Faulted |
Tritt auf, wenn ein Kommunikationsobjekt in den fehlerhaften Zustand wechselt. (Geerbt von CommunicationObject) |
| Opened |
Tritt auf, wenn ein Kommunikationsobjekt in den geöffneten Zustand wechselt. (Geerbt von CommunicationObject) |
| Opening |
Tritt auf, wenn ein Kommunikationsobjekt in den Öffnungszustand wechselt. (Geerbt von CommunicationObject) |