XML 缓冲区为任意 XML 数据提供高效的内存中存储。
若要从 XML 缓冲区读取数据,请使用 XML 读取器,并使用 XML 缓冲区调用 WsSetInputToBuffer。 阅读器将定位在文档的开头。
若要将数据插入缓冲区,请使用 XML 编写器 并使用 XML 缓冲区调用 WsSetOutputToBuffer。 编写器将放置在文档的末尾。
将读取器设置为 XML 缓冲区后,除了所有 XML 读取器 API 之外,WsMoveReader 还可用于在文档中导航读取器。 WsGetReaderPosition 和 WsSetReaderPosition 也可用于记录文档中的位置,稍后返回该位置。
将编写器设置为 XML 缓冲区后,除了所有 XML 编写器 API 之外,WsMoveWriter 还可用于在文档中导航编写器。 WsGetWriterPosition 和 WsSetWriterPosition 也可用于记录文档中的位置,稍后返回该位置。 编写器始终在放置数据的节点之前插入数据。
可以通过使用 WsGetReaderPosition 或 WsGetWriterPosition,然后调用 具有该位置的 WsRemoveNode,从而从 XML 缓冲区中删除节点。 对于元素,这将删除元素及其所有子元素,包括其匹配的结束元素。
位置由值 WS_XML_NODE_POSITION表示。 位置特定于特定的 XML 缓冲区,并且只要 XML 缓冲区有效,就有效。
以下枚举与 XML 缓冲区一起使用:
以下函数用于 XML 缓冲区:
以下句柄与 XML 缓冲区一起使用:
以下结构与 XML 缓冲区一起使用: