Compartilhar via


XML Buffer

Um buffer XML fornece armazenamento na memória eficiente para dados XML arbitrários.

Para ler dados de um Buffer XML, use um Leitor XML e chame WsSetInputToBuffer com o Buffer XML. O leitor será posicionado no início do documento.

Para inserir dados em um buffer, use um Gravador XML e chame WsSetOutputToBuffer com o Buffer XML. O gravador será posicionado no final do documento.

Depois que um leitor tiver sido definido como um Buffer XML, além de todas as APIs de Leitor de XML, o WsMoveReader poderá ser usado para navegar pelo leitor pelo documento. WsGetReaderPosition e WsSetReaderPosition também podem ser usados para registrar uma posição no documento e retornar a ele mais tarde.

Depois que um gravador tiver sido definido como um Buffer XML, além de todas as APIs do Gravador XML, o WsMoveWriter poderá ser usado para navegar pelo gravador pelo documento. WsGetWriterPosition e WsSetWriterPosition também podem ser usados para registrar uma posição no documento e retornar a ele mais tarde. O gravador sempre insere dados antes do nó no qual ele está posicionado.

Os nós podem ser excluídos do Buffer XML obtendo a posição do nó usando WsGetReaderPosition ou WsGetWriterPosition e, em seguida, chamando WsRemoveNode com essa posição. Para elementos, isso excluirá o elemento , todos os seus filhos, incluindo seu elemento final correspondente.

Uma posição é representada pelo valor WS_XML_NODE_POSITION. As posições são específicas para um buffer XML específico e são válidas apenas desde que o Buffer XML seja válido.

As seguintes enumerações são usadas com buffers XML:

As seguintes funções são usadas com buffers XML:

O seguinte identificador é usado com buffers XML:

As seguintes estruturas são usadas com buffers XML: