Share via


XML Buffer

Un buffer XML fornisce un archivio in memoria efficiente per dati XML arbitrari.

Per leggere i dati da un buffer XML, usare un lettore XML e chiamare WsSetInputToBuffer con il buffer XML. Il lettore verrà posizionato all'inizio del documento.

Per inserire dati in un buffer, usare un writer XML e chiamare WsSetOutputToBuffer con il buffer XML. Il writer verrà posizionato alla fine del documento.

Dopo che un lettore è stato impostato su un buffer XML, oltre a tutte le API lettore XML, WsMoveReader può essere usato per esplorare il lettore nel documento. WsGetReaderPosition e WsSetReaderPosition possono essere usati anche per registrare una posizione nel documento e tornare in un secondo momento.

Dopo che un writer è stato impostato su un buffer XML, oltre a tutte le API writer XML, È possibile usare WsMoveWriter per spostarsi nel writer attraverso il documento. WsGetWriterPosition e WsSetWriterPosition possono essere usati anche per registrare una posizione nel documento e tornare in un secondo momento. Il writer inserisce sempre i dati prima del nodo in cui è posizionato.

I nodi possono essere eliminati dal buffer XML ottenendo la posizione del nodo usando WsGetReaderPosition o WsGetWriterPosition e quindi chiamando WsRemoveNode con tale posizione. Per gli elementi, l'elemento verrà eliminato, tutti i relativi elementi figlio, incluso l'elemento finale corrispondente.

Una posizione è rappresentata dal valore WS_XML_NODE_POSITION. Le posizioni sono specifiche di un particolare buffer XML e sono valide solo se il buffer XML è valido.

Le enumerazioni seguenti vengono usate con i buffer XML:

Le funzioni seguenti vengono usate con i buffer XML:

L'handle seguente viene usato con i buffer XML:

Le strutture seguenti vengono usate con i buffer XML: