WS_XML_READER_PROPERTY_ID 枚举 (webservices.h)

项目
08/27/2023

标识每个 XML 读取器属性及其关联的值。此枚举在 WS_XML_READER_PROPERTY 结构中使用，该结构用作 WsCreateReader、 WsSetInput、 WsSetInputToBuffer 和 WsReadXmlBufferFromBytes 的参数。它还直接用作 WsGetReaderProperty 的参数。

语法

typedef enum {
  WS_XML_READER_PROPERTY_MAX_DEPTH = 0,
  WS_XML_READER_PROPERTY_ALLOW_FRAGMENT = 1,
  WS_XML_READER_PROPERTY_MAX_ATTRIBUTES = 2,
  WS_XML_READER_PROPERTY_READ_DECLARATION = 3,
  WS_XML_READER_PROPERTY_CHARSET = 4,
  WS_XML_READER_PROPERTY_ROW = 5,
  WS_XML_READER_PROPERTY_COLUMN = 6,
  WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE = 7,
  WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE = 8,
  WS_XML_READER_PROPERTY_IN_ATTRIBUTE = 9,
  WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE = 10,
  WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE = 11,
  WS_XML_READER_PROPERTY_MAX_MIME_PARTS = 12,
  WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES = 13,
  WS_XML_READER_PROPERTY_MAX_NAMESPACES = 14
} WS_XML_READER_PROPERTY_ID;

常量


`WS_XML_READER_PROPERTY_MAX_DEPTH` 值： 0 一个 ULONG，指定读者将允许的文档的最大深度。任何点的深度都通过嵌套的起始元素数来测量。深度为 0 会阻止读取任何起始元素。此属性默认为 32。有关安全注意事项，请参阅 WsCreateReader 。
`WS_XML_READER_PROPERTY_ALLOW_FRAGMENT` 值：1 一个 BOOL ，指定读取器是否允许在文档的顶层使用多个元素和非空格。此属性对于WS_XML_READER_MTOM_ENCODING，可能不会设置为 TRUE。此属性默认为 FALSE。
`WS_XML_READER_PROPERTY_MAX_ATTRIBUTES` 值： 2 一个 ULONG，指定读取器对元素允许的最大属性数。此属性默认为 128。有关安全注意事项，请参阅 WsCreateReader 。
`WS_XML_READER_PROPERTY_READ_DECLARATION` 值： 3 一个 BOOL，指定读取者是否应允许文档开头的 xml 声明。此属性默认为 TRUE。
`WS_XML_READER_PROPERTY_CHARSET` 值： 4 返回 xml 文档的字符集的WS_CHARSET 值。此值仅适用于文本文档。如果读取器是使用 WS_CHARSET_AUTO初始化的，则它将自动确定此值。读取器输入源经过流式传输，然后读取器必须有足够的缓冲数据才能检查初始字节顺序标记和 xml 声明。请参阅 WsFillReader。如果读取器是使用任何其他值初始化的，则此属性仅返回该值。
`WS_XML_READER_PROPERTY_ROW` 值： 5 一个 ULONGLONG，返回读取器为文本 xml 文档定位的节点的从 0 开始的行号。
`WS_XML_READER_PROPERTY_COLUMN` 值： 6 一个 ULONGLONG，返回读取器为文本 xml 文档定位的节点的从 0 开始的列号。
`WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE` 值： 7 一个 ULONG，指定由使用的内部缓冲区的剪裁大小用于执行 UTF-16 到 UTF-8 转换的WS_XML_READER。增加此值使用更多内存，但在处理 UTF-16 编码文档时可以减少分配。此属性默认为 4096。
`WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE` 值： 8 一个 ULONG，指定WS_XML_READER在配置为使用时将使用的缓冲区的大小 WS_XML_READER_STREAM_INPUT。增加此值会占用更多内存，但可以减少调用WS_READ_CALLBACK 的次数。此属性默认为 4096。
`WS_XML_READER_PROPERTY_IN_ATTRIBUTE` 值： 9 指示已调用 WsReadStartAttribute ，并且读取器为定位在属性内容上。
`WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE` 值： 10 与 WS_XML_READER_MTOM_ENCODING 一起使用的 ULONG WS_XML_READER_STREAM_INPUT。此值指定根 MIME 部件的最大大小，该部件包含文档的 xml 部分。当与其他编码一起使用或与 WS_XML_READER_BUFFER_INPUT。此属性默认为 65536。
`WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE` 值： 11 与 WS_XML_READER_MTOM_ENCODING 一起使用的 ULONG WS_XML_READER_STREAM_INPUT。此值指定文档中可能出现的任何 MIME 标头组的最大大小。当与其他编码一起使用或与 WS_XML_READER_BUFFER_INPUT一起使用时，它不起作用。此属性默认为 256。
`WS_XML_READER_PROPERTY_MAX_MIME_PARTS` 值： 12 与 WS_XML_READER_MTOM_ENCODING 一起使用的ULONG。此值指定 MIME 部件的最大数目可能显示在文档中的。与其他编码一起使用时，它不起作用。此属性默认为 4096。
`WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES` 值： 13 与 WS_XML_READER_TEXT_ENCODING 一起使用的BOOL。将此设置为 TRUE 可允许字符引用 XML 1.0 认为无效的字符数。将此属性设置为 TRUE 可能会影响互操作性。此属性默认为 FALSE。
`WS_XML_READER_PROPERTY_MAX_NAMESPACES` 值： 14 一个 ULONG，它指定在任何时间点可能出现在范围内的最大 xmlns 唯一声明数阅读文档时。此属性默认为 32。有关安全注意事项，请参阅 WsCreateReader 。

要求


最低受支持的客户端	Windows 7 [桌面应用 \|UWP 应用]
最低受支持的服务器	Windows Server 2008 R2 [桌面应用 \|UWP 应用]
标头	webservices.h

通过

WS_XML_READER_PROPERTY_ID 枚举 (webservices.h)

语法

常量

要求

反馈

其他资源