SoapExtension.ChainStream(Stream) Método

Definição

Namespace:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Quando substituído em uma classe derivada, permite a uma extensão SOAP o acesso ao buffer de memória que contém a resposta ou solicitação 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

Parâmetros

stream

Stream

Um buffer de memória que contém a resposta ou a solicitação SOAP.

Retornos

Stream

Um Stream que representa um novo buffer de memória que essa extensão SOAP pode modificar.

Exemplos

O exemplo a seguir salva tanto o Stream passado ChainStream quanto o Stream retornado ChainStream nas variáveis oldStream de membro e newStream, respectivamente.

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

Comentários

ChainStream garante que as extensões SOAP com a prioridade mais alta possam modificar os dados reais mais próximos da mensagem SOAP enviada ou retornada pelo fio.

As extensões SOAP devem salvar referências do Stream passado ChainStream e do Stream retornado de ChainStream. Se a extensão SOAP estiver configurada para ser executada com um método de serviço Web XML, a Stream passagem conterá a solicitação SOAP serializada na BeforeDeserializeSoapMessageStage.ChainStream Da mesma forma, a Stream referência retornada ChainStream é gravada quando a serialização ocorre e, portanto, contém a resposta SOAP serializada no AfterSerializeSoapMessageStage.