IStreamProvider Rozhraní

Definice

Obor názvů:

System.Xml

Sestavení:

System.Runtime.Serialization.Xml.dll

Zdroj:

IStreamProvider.cs

Představuje rozhraní, které lze implementovat pomocí tříd poskytujících datové proudy.

public interface class IStreamProvider

public interface IStreamProvider

type IStreamProvider = interface

Public Interface IStreamProvider

Poznámky

Při zápisu odchozí zprávy obsahující streamované tělo do zapisovače Message XML se použije posloupnost volání podobná následující v jeho OnWriteBodyContents(XmlDictionaryWriter) implementaci:

• Zapište všechny potřebné informace před datový proud (například levou značku XML).

• Napište datový proud.

• Za datový proud zapište všechny informace (například uzavírací značka XML).

To funguje dobře s kódováními, které se podobají textovému kódování XML. Existují však některá kódování, která neumisťují informace o informační sadě XML (například značky pro počáteční a koncové elementy XML) společně s daty obsaženými v elementech. Například v kódování MTOM je zpráva rozdělena na více částí. Jedna část obsahuje informační sadu XML, která může obsahovat odkazy na jiné části pro skutečný obsah elementu. Vzhledem k tomu, že informační sada XML bude obvykle malá v porovnání se streamovaným obsahem, má smysl ukládat informace do vyrovnávací paměti, zapisovat ji a pak obsah zapsat streamovaným způsobem. To znamená, že v době, kdy je značka uzavírací prvek napsána, jsme ještě neměli zapsat stream.

K tomuto účelu se IStreamProvider používá rozhraní. Rozhraní má metodu GetStream() , která vrací datový proud k zápisu. Správný způsob zápisu streamovaného textu zprávy je OnWriteBodyContents(XmlDictionaryWriter) následující:

• Zapište všechny potřebné informace před datový proud (například levá značka XML).

• WriteValue Volání přetížení na XmlDictionaryWriter , který přebírá IStreamProvider, s implementacíIStreamProvider, která vrací datový proud k zápisu.

• Zapište všechny informace za streamem (například uzavírací značka XML).

Díky tomuto přístupu má zapisovač XML možnost volat GetStream() a zapsat streamovaná data. Například textový a binární zapisovač XML zavolá okamžitě a zapíše streamovaný obsah mezi počáteční a koncové značky. Zapisovač MTOM se může rozhodnout, GetStream() že zavolá později, až bude připraven napsat příslušnou část zprávy.

Metody

GetStream()	Získá datový proud.
ReleaseStream(Stream)	Uvolní datový proud na výstup.