Share via


WS_XML_READER_PROPERTY_ID列挙 (webservices.h)

各 XML リーダー プロパティが であり、その関連する値を識別します。 この列挙体は、wsCreateReaderWsSetInput、WsSetInputToBuffer、および WsReadXmlBufferFromBytes のパラメーターとして使用される、WS_XML_READER_PROPERTY構造体内で使用されます。 また、 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
1990年に
は、リーダーが文書の最上位レベルで複数の要素と空白以外のスペースを許可するかどうかを指定します。 このプロパティ
WS_XML_READER_MTOM_ENCODINGでは TRUE に設定できません。


このプロパティの既定値は FALSE です
WS_XML_READER_PROPERTY_MAX_ATTRIBUTES
値: 2
リーダーが要素に対して許可する属性の最大数を指定する ULONG


このプロパティの既定値は 128 です。


セキュリティに関する考慮事項については、「 WsCreateReader 」を参照してください。
WS_XML_READER_PROPERTY_READ_DECLARATION
値: 3
リーダーがドキュメントの先頭で xml 宣言を許可するかどうかを指定する BOOL


このプロパティの既定値は TRUE です
WS_XML_READER_PROPERTY_CHARSET
値: 4
xml ドキュメントの文字 セットを返すWS_CHARSET値。 この値は、 でのみ使用できます。
テキスト ドキュメント。


リーダーが WS_CHARSET_AUTO で初期化された場合、これを自動的に決定します
値を表します。 リーダー入力ソースがストリーミングされた後、リーダーはバッファーに格納された十分なデータを持っている必要があります。
では、最初のバイト オーダー マークと xml 宣言を検査します。 「WsFillReader」を参照してください。


リーダーが他の値で初期化された場合、このプロパティは単にその値を返します。
WS_XML_READER_PROPERTY_ROW
値: 5
テキスト xml ドキュメントに対してリーダーが配置されているノードの 0 から始まる行番号を返す ULONGLONG
WS_XML_READER_PROPERTY_COLUMN
値: 6
テキスト xml ドキュメントに対してリーダーが配置されているノードの 0 から始まる列番号を返す ULONGLONG
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
使用するように構成されている場合にWS_XML_READERが使用するバッファーのサイズを指定する ULONG
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と組み合わせてWS_XML_READER_STREAM_INPUTで使用される ULONG
この値は、ルート MIME パーツの最大サイズを指定します。これは、
ドキュメントの xml 部分。 他のエンコーディングで使用する場合や、 で使用する場合は効果がありません
WS_XML_READER_BUFFER_INPUT


このプロパティの既定値は 65536 です。
WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE
値: 11
WS_XML_READER_MTOM_ENCODINGと組み合わせてWS_XML_READER_STREAM_INPUTで使用される 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
任意の時点でスコープ内に出現できる xmlns 一意宣言の最大数を指定する ULONG
ドキュメントの読み取り中。


このプロパティの既定値は 32 です。


セキュリティに関する考慮事項については、「 WsCreateReader 」を参照してください。

要件

   
サポートされている最小のクライアント Windows 7 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリ |UWP アプリ]
Header webservices.h