Compartilhar via


XML Buffer

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

Para ler dados de um Buffer XML, use um de 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 XML, 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, WsMoveWriter poderão ser usados 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ó ao 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 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ó são válidas 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:

  • WsCreateXmlBuffer
  • WsRemoveNode

O identificador a seguir é usado com buffers XML:

As estruturas a seguir são usadas com buffers XML: