XmlTextReader.EntityHandling プロパティ

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

XmlTextReader.EntityHandling プロパティ

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

リーダーによるエンティティの処理方法を指定する値を取得または設定します。

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

Visual Basic (宣言)

Public Property EntityHandling As
 EntityHandling

Visual Basic (使用法)

Dim instance As XmlTextReader
Dim value As EntityHandling

value = instance.EntityHandling

instance.EntityHandling = value

C#

public EntityHandling EntityHandling { get;
 set; }

C++

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

J#

/** @property */
public EntityHandling get_EntityHandling ()

/** @property */
public void set_EntityHandling (EntityHandling
 value)

JScript

public function get EntityHandling
 () : EntityHandling

public function set EntityHandling
 (value : EntityHandling)

プロパティ値
EntityHandling 値の 1 つ。EntityHandling が指定されていない場合は、既定で EntityHandling.ExpandCharEntities に設定されます。

解説

メモ
Microsoft .NET Framework version 2.0 リリースでは、System.Xml.XmlReader.Create メソッドを使用して XmlReader インスタンスを作成することをお勧めします。これにより、このリリースで導入された新機能を十分に活用できます。詳細については、「XML リーダーの作成」を参照してください。

このプロパティはすぐに変更でき、次の Read 呼び出し後に有効となります。

EntityHandling を ExpandCharEntities に設定すると、属性値の一部だけが正規化されます。リーダーは、隣接するエンティティ参照ノードの内容とは関係なく、個別のテキスト ノードを正規化します。

エンティティ処理モード間の違いを次の XML に示します。

<!DOCTYPE doc [<!ENTITY num "123">]>
    <doc> &#65; &num; </doc>

EntityHandling を ExpandEntities に設定すると、"doc" 要素ノードに、展開したエンティティ テキストを持つ 1 つのテキスト ノードが含まれます。

深さ	ノード型	名前	値
1	Text		A 123

EntityHandling を ExpandCharEntites に設定し、WhitespaceHandling を Significant または All に設定すると、"doc" 要素は、文字エンティティを展開し、一般エンティティをノードとして返します。

深さ	ノード型	名前	値
1	Text		A
1	EntityReference	num
1	SignificantWhitespace

プラットフォーム

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

参照

関連項目
XmlTextReader クラス
XmlTextReader メンバ
System.Xml 名前空間
その他の技術情報
XmlReader による XML の読み取り