SoapClientFormatterSinkProvider Klasse

Referenz

Definition

Namespace:: System.Runtime.Remoting.Channels

Assembly:: System.Runtime.Remoting.dll

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.

Stellt die Implementierung für einen Formatierungssenkenprovider des Clients bereit.

public ref class SoapClientFormatterSinkProvider : System::Runtime::Remoting::Channels::IClientFormatterSinkProvider

public class SoapClientFormatterSinkProvider : System.Runtime.Remoting.Channels.IClientFormatterSinkProvider

type SoapClientFormatterSinkProvider = class
    interface IClientFormatterSinkProvider
    interface IClientChannelSinkProvider

Public Class SoapClientFormatterSinkProvider
Implements IClientFormatterSinkProvider

Vererbung: Object
SoapClientFormatterSinkProvider

Implementiert: IClientChannelSinkProvider IClientFormatterSinkProvider

Hinweise

Ein SoapClientFormatterSinkProvider erstellt Clientformatierersenken, die verwenden, SoapFormatter um Nachrichten für den Clientkanal zu serialisieren, über den Remotingnachrichten fließen.

Die Funktion der Formatierungssenke besteht darin, die erforderlichen Header zu erstellen und die Nachricht in den Stream zu serialisieren. Nachdem die Formatierersenke erreicht wurde, wird an IMessage alle Senken in der Kanalsenkenkette durch die ProcessMessage Aufrufe oder AsyncProcessRequest weitergeleitet. Zu diesem Zeitpunkt wurde die Nachricht bereits serialisiert und wird nur als Information bereitgestellt. Senken, die die Nachricht erstellen oder ändern müssen, müssen in der Senkenkette vor dem Formatierer platziert werden. Dies kann erreicht werden, indem sowohl die IMessageSink IClientChannelSink Schnittstellen als auch implementiert werden. Die Formatierersenke kann später in der Senkenkette platziert werden.

Formatierungssenken verwenden Senkenkonfigurationseigenschaften, um den Kanal zur Laufzeit zu konfigurieren. Senkeneigenschaften können in einer Konfigurationsdatei oder programmgesteuert in einer IDictionaryangegeben werden. In einer Konfigurationsdatei werden alle Werte durch Zeichenfolgen dargestellt, aber beim programmgesteuerten Erstellen einer Eigenschaft IDictionary können Werttypen mit ihren nativen Werten oder mit Zeichenfolgen angegeben werden.

In der folgenden Tabelle sind die Senkenkonfigurationseigenschaften aufgeführt, die für den aktuellen Senkenanbieter angegeben werden können.

Eigenschaft	Beschreibung
`includeVersions`	Gibt an, ob der Formatierer Versionsinformationen enthält. Die verfügbaren Werte sind `true` oder `false`.

Wichtig

Die Verwendung einer instance dieses Objekts mit nicht vertrauenswürdigen Daten oder über einen unsicheren Kanal ist ein Sicherheitsrisiko. Verwenden Sie dieses Objekt nur mit vertrauenswürdigen Daten und über einen sicheren Kanal hinweg. Weitere Informationen finden Sie unter Überprüfen aller Eingaben.

Konstruktoren

SoapClientFormatterSinkProvider()	Initialisiert eine neue Instanz der SoapClientFormatterSinkProvider-Klasse mit Standardwerten.
SoapClientFormatterSinkProvider(IDictionary, ICollection)	Initialisiert eine neue Instanz der SoapClientFormatterSinkProvider-Klasse mit den angegebenen Eigenschaften und Anbieterdaten.

Eigenschaften

Next	Ruft den nächsten IClientChannelSinkProvider in der Senkenanbieterkette ab oder legt diesen fest.

Methoden

CreateSink(IChannelSender, String, Object)	Erstellt eine Senkenkette.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Gilt für:

Freigeben über