共用方式為

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