SoapExtension.ChainStream(Stream) Metoda

Definicja

Przestrzeń nazw:

System.Web.Services.Protocols

Zestaw:

System.Web.Services.dll

Po przesłonięciu w klasie pochodnej umożliwia dostęp rozszerzenia SOAP do buforu pamięci zawierającego żądanie lub odpowiedź protokołu SOAP.

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

Parametry

stream

Stream

Bufor pamięci zawierający żądanie lub odpowiedź protokołu SOAP.

Zwraca

Stream

Reprezentujący Stream nowy bufor pamięci, który może modyfikować to rozszerzenie PROTOKOŁU SOAP.

Przykłady

W poniższym przykładzie dane są zapisywane zarówno Stream w zmiennej ChainStream składowej, jak i Stream zwrócone odpowiednio ChainStream w zmiennych oldStream składowych i newStream.

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

Uwagi

ChainStream zapewnia, że rozszerzenia protokołu SOAP o najwyższym prioryfikcie mogą modyfikować rzeczywiste dane znajdujące się najbliżej komunikatu PROTOKOŁU SOAP wysłanego lub zwróconego za pośrednictwem przewodu.

Rozszerzenia protokołu SOAP powinny zapisywać odwołania do przekazanego ChainStream obiektu Stream i Stream zwracane z ChainStream. Jeśli rozszerzenie PROTOKOŁU SOAP jest skonfigurowane do uruchamiania za pomocą metody usługi sieci Web XML, Stream przekazany do ChainStream pliku zawiera serializowane żądanie PROTOKOŁU SOAP w .BeforeDeserializeSoapMessageStage Podobnie odwołanie Stream zwrócone z ChainStream metody jest zapisywane w momencie serializacji i w ten sposób zawiera serializowaną odpowiedź PROTOKOŁU SOAP w elemencie AfterSerializeSoapMessageStage.