WS_XML_READER_PROPERTY_ID 枚举 (webservices.h)

标识每个 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 一起使用的 ULONGWS_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 一起使用的 ULONGWS_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