SoapExtension.ChainStream(Stream) Methode
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.
Wenn sie in einer abgeleiteten Klasse überschrieben werden, ermöglicht eine SOAP-Erweiterung den Zugriff auf den Speicherpuffer, der die SOAP-Anforderung oder -Antwort enthält.
public:
virtual System::IO::Stream ^ ChainStream(System::IO::Stream ^ stream);
public virtual System.IO.Stream ChainStream(System.IO.Stream stream);
abstract member ChainStream : System.IO.Stream -> System.IO.Stream
override this.ChainStream : System.IO.Stream -> System.IO.Stream
Public Overridable Function ChainStream (stream As Stream) As Stream
Parameter
- stream
- Stream
Ein Speicherpuffer, der die SOAP-Anforderung oder -Antwort enthält.
Gibt zurück
Eine Stream Darstellung eines neuen Speicherpuffers, den diese SOAP-Erweiterung ändern kann.
Beispiele
Im folgenden Beispiel werden sowohl die Stream übergebenen ChainStream als auch die Stream von ChainStream den Membervariablen oldStream zurückgegebenen Elemente bzw newStream. die Rückgabe gespeichert.
public:
virtual Stream^ ChainStream( Stream^ stream ) override
{
oldStream = stream;
newStream = gcnew MemoryStream;
return newStream;
}
public override Stream ChainStream( Stream stream ){
oldStream = stream;
newStream = new MemoryStream();
return newStream;
}
Public Overrides Function ChainStream(stream As Stream) As Stream
m_oldStream = stream
m_newStream = New MemoryStream()
Return m_newStream
End Function
Hinweise
ChainStream stellt sicher, dass SOAP-Erweiterungen mit der höchsten Priorität die tatsächlichen Daten ändern können, die der SOAP-Nachricht am nächsten kommen, die über das Kabel gesendet oder zurückgegeben werden.
SOAP-Erweiterungen sollten Verweise auf die Stream übergebenen ChainStream und von Stream der zurückgegebenen ChainStreamDatei speichern. Wenn die SOAP-Erweiterung für die Ausführung mit einer XML-Webdienstmethode konfiguriert ist, enthält die Stream übergebene ChainStream SOAP-Anforderung die serialisierte SOAP-Anforderung an der BeforeDeserializeSoapMessageStage. Ebenso wird der Stream zurückgegebene ChainStream Verweis beim Auftreten der Serialisierung in die Serialisierung geschrieben und enthält somit die serialisierte SOAP-Antwort in der AfterSerializeSoapMessageStage.