WS_XML_READER_PROPERTY_ID列舉 (webservices.h)

識別每個 XML 讀取器屬性是 及其相關聯的值。 此列舉用於WS_XML_READER_PROPERTY結構內，做為WsCreateReader、WsSetInput、WsSetInputToBuffer和WsReadXmlBufferFromBytes的參數。 它也會直接作為 WsGetReaderProperty的參數使用。

Syntax

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_STREAM_INPUT搭配WS_XML_READER_MTOM_ENCODING使用的ULONG。 這個值會指定根 MIME 元件的大小上限，也就是包含的元件 檔的 xml 部分。 搭配其他編碼使用或搭配使用時，它沒有任何作用 WS_XML_READER_BUFFER_INPUT。 此屬性預設為 65536。
WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE 值： 11 搭配WS_XML_READER_STREAM_INPUT搭配WS_XML_READER_MTOM_ENCODING使用的ULONG。 這個值會指定任何可能出現在檔中之 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