Vyrovnávací paměť XML
Vyrovnávací paměť XML poskytuje efektivní úložiště v paměti pro libovolná data XML.
Ke čtení dat z vyrovnávací paměti XML použijte čtečku XML a volání WsSetInputToBuffer s vyrovnávací pamětí XML. Čtečka bude umístěna na začátku dokumentu.
Chcete-li vložit data do vyrovnávací paměti, použijte zapisovač XML a volání WsSetOutputToBuffer s vyrovnávací pamětí XML. Zapisovač bude umístěn na konci dokumentu.
Jakmile je čtečka nastavena na vyrovnávací paměť XML, kromě všech rozhraní API čtečky XML WsMoveReader lze použít k procházení čtečky v dokumentu. WsGetReaderPosition a WsSetReaderPosition lze také použít k zaznamenání pozice v dokumentu a návrat k němu později.
Jakmile je zapisovač nastaven na vyrovnávací paměť XML, kromě všech rozhraní XML Writer API, WsMoveWriter lze použít k procházení zapisovače dokumentu. WsGetWriterPosition a WsSetWriterPosition lze také použít k zaznamenání pozice v dokumentu a návrat k ní později. Zapisovač vždy vloží data před uzel, do kterého se umístí.
Uzly mohou být odstraněny z vyrovnávací paměti XML získáním pozice uzlu pomocí WsGetReaderPosition nebo WsGetWriterPosition a potom voláním WsRemoveNode s danou pozicí. U elementů se tím odstraní prvek, všechny jeho podřízené položky včetně odpovídajícího koncového prvku.
Pozice je reprezentována hodnotou WS_XML_NODE_POSITION. Pozice jsou specifické pro konkrétní vyrovnávací paměť XML a jsou platné pouze za předpokladu, že vyrovnávací paměť XML je platná.
Následující výčty se používají s vyrovnávacími paměťmi XML:
V vyrovnávacích pamětích XML se používají následující funkce:
Následující popisovač se používá s vyrovnávacími paměťmi XML:
Následující struktury se používají s vyrovnávacími paměťmi XML: