新しいエンティティ参照の作成
CreateEntityReference メソッドによって新しい XmlEntityReference ノードを作成できます。DOM は、参照されているエンティティ名が既に宣言されているかどうかを確認します。宣言されている場合は、エンティティ宣言ノードから XmlEntityReference ノードの子ノードがコピーされます。一致するエンティティ宣言がない場合、エンティティ参照ノードには、唯一の子として空のテキスト ノードが追加されます。XmlEntityReference ノードの子ノードは別のノードのコピーなので、これらの子ノードは読み取り専用になり、変更はできません。
ノードがコピーされるとき、そのエンティティ参照が存在する位置のスコープに、名前空間が適用されていることがあります。生成される要素ノードまたは属性ノードの構成は、この名前空間の影響を受けます。
メモ DOM が EntityReference に子ノードを追加するのは、ドキュメントに EntityReference ノードを挿入するときだけです。新しく作成された EntityReference ノードには、子ノードはありません。
XmlDataDocument は XmlDocument の派生クラスですが、XmlDataDocument ではエンティティ参照の作成をサポートしていません。EntityReference の子が読み取り専用であるためです。EntityReference ノードの子の範囲は、複数の領域にまたがることができます。この場合は、EntityReference の一部を含む領域と関連付けられている行の部分が読み取り専用になります。