SoapExtension.ChainStream(Stream) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
En cas de substitution dans une classe dérivée, autorise un accès d’extension SOAP à la mémoire tampon contenant la requête ou la réponse 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
Paramètres
- stream
- Stream
Mémoire tampon contenant la requête ou la réponse SOAP.
Retours
Représentant Stream une nouvelle mémoire tampon que cette extension SOAP peut modifier.
Exemples
L’exemple suivant enregistre à la fois les Stream entrées passées ChainStream et Stream les retours à partir des ChainStream variables oldStream membres et newStream, respectivement.
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
Remarques
ChainStream garantit que les extensions SOAP avec la priorité la plus élevée peuvent modifier les données réelles les plus proches du message SOAP envoyé ou retourné sur le câble.
Les extensions SOAP doivent enregistrer les références de l’entrée Stream passée ChainStream et du Stream retour à partir de ChainStream. Si l’extension SOAP est configurée pour s’exécuter avec une méthode de service web XML, la Stream requête SOAP transmise ChainStream contient la requête SOAP sérialisée à l’adresse BeforeDeserializeSoapMessageStage. De même, la Stream référence retournée ChainStream est écrite lorsque la sérialisation se produit et contient donc la réponse SOAP sérialisée dans le AfterSerializeSoapMessageStage.