SoapExtension.ChainStream(Stream) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Quando substituído em uma classe derivada, permite um acesso de extensão SOAP ao buffer de memória que contém a solicitação ou resposta 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 solicitação ou resposta SOAP.
Retornos
Uma Stream representação de um novo buffer de memória que essa extensão SOAP pode modificar.
Exemplos
O exemplo a seguir salva o Stream passado ChainStream para dentro e o Stream retornado nas variáveis oldStream membro ChainStream enewStream, 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 pela transmissão.
As extensões SOAP devem salvar referências do Stream passado para dentro 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.