XmlReaderSettings.ConformanceLevel プロパティ

.NET Framework クラス ライブラリ リファレンス

XmlReaderSettings.ConformanceLevel プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

XmlReader が従う準拠のレベルを取得または設定します。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Property ConformanceLevel As
 ConformanceLevel

Visual Basic (使用法)

Dim instance As XmlReaderSettings
Dim value As ConformanceLevel

value = instance.ConformanceLevel

instance.ConformanceLevel = value

C#

public ConformanceLevel ConformanceLevel { get;
 set; }

C++

public:
property ConformanceLevel ConformanceLevel {
    ConformanceLevel get ();
    void set (ConformanceLevel value);
}

J#

/** @property */
public ConformanceLevel get_ConformanceLevel ()

/** @property */
public void set_ConformanceLevel (ConformanceLevel
 value)

JScript

public function get ConformanceLevel
 () : ConformanceLevel

public function set ConformanceLevel
 (value : ConformanceLevel)

プロパティ値
ConformanceLevel 値の 1 つ。既定値は ConformanceLevel.Document です。

解説

既定では、Create メソッドで作成された XmlReader オブジェクトは、XmlTextReader クラスより高い準拠性を備えています。XmlTextReader では次の項目に対する準拠性向上の機能は有効になりませんが、Create メソッドで作成されたリーダーでは既定で有効になります。

• 改行と属性値が XML の仕様に従って正規化されます。

• すべてのエンティティは自動的に展開されます。

• リーダーが検証を行わない場合でも、文書型定義に宣言された既定の属性が常に追加されます。

• 正しい XML 名前空間 URI に割り当てられた XML プレフィックスを宣言できます。

• 単一の NotationType 属性宣言の表記名および単一の Enumeration 属性宣言の NmTokens は、すべて区別する必要があります。

詳細については、「XmlReader によるデータ一致チェック」を参照してください。

使用例

XML フラグメントを読み取る XmlReader オブジェクトを作成する例を次に示します。

Visual Basic

Dim xmlFrag As String =
 "<item rk:ID='abc-23'>hammer</item> " &
 _
                                     "<item rk:ID='r2-435'>paint</item>"
 & _
                                     "<item rk:ID='abc-39'>saw</item>"

' Create the XmlNamespaceManager.
Dim nt As New NameTable()
Dim nsmgr As New XmlNamespaceManager(nt)
nsmgr.AddNamespace("rk", "urn:store-items")

' Create the XmlParserContext.
Dim context As New XmlParserContext(Nothing,
 nsmgr, Nothing, XmlSpace.None)

' Create the reader. 
Dim settings As New XmlReaderSettings()
settings.ConformanceLevel = ConformanceLevel.Fragment
Dim reader As XmlReader = XmlReader.Create(New
 StringReader(xmlFrag), settings, context)

C#

string xmlFrag ="<item rk:ID='abc-23'>hammer</item>
 " +
                        "<item rk:ID='r2-435'>paint</item>"
 +
                        "<item rk:ID='abc-39'>saw</item>";

// Create the XmlNamespaceManager.
NameTable nt = new NameTable();
XmlNamespaceManager nsmgr = new XmlNamespaceManager(nt);
nsmgr.AddNamespace("rk", "urn:store-items");

// Create the XmlParserContext.
XmlParserContext context = new XmlParserContext(null,
 nsmgr, null, XmlSpace.None);

// Create the reader. 
XmlReaderSettings settings = new XmlReaderSettings();
settings.ConformanceLevel = ConformanceLevel.Fragment;
XmlReader reader = XmlReader.Create(new StringReader(xmlFrag),
 settings, context);

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
XmlReaderSettings クラス
XmlReaderSettings メンバ
System.Xml 名前空間
その他の技術情報
XML リーダーの作成
XmlReader のデータ一致条件