外部リソースの解決

2008-09-17

更新 : November 2007

XmlDocument クラスでは、外部のドキュメント型定義 (DTD)、エンティティ、スキーマなど、XML データのインラインでないリソースを検索するときに XmlDocument の XmlResolver プロパティを使用します。これらのリソースは、ネットワーク上やローカルドライブ上にあり、URI (Uniform Resource Identifier) で識別できます。そのため、XmlDocument は、ドキュメント内にある EntityReference ノードを解決し、外部の DTD またはスキーマに基づいてドキュメントを検証することができます。

完全に信頼されている XmlDocument

XmlResolver プロパティは、XmlDocument.Load メソッドの機能に影響を与えることがあります。XmlDocument オブジェクトが完全に信頼されている場合の XmlDocument.XmlResolver プロパティの動作を次の表に示します。Load への入力が TextReader、String、Stream、または URI である場合の XmlDocument.Load メソッドが対象です。XmlDocument が XmlReader から読み込まれた場合の Load メソッドは対象外です。

XmlResolver プロパティ	機能	メモ
プロパティが、以前作成され、ユーザーの設定したプロパティを持っている XmlResolver クラスに設定されている。	XmlDocument は、ファイル名を解決するために指定された XmlResolver を使用し、DTD、エンティティ、スキーマなどの外部リソースへの参照を解決します。 XmlResolver は、XmlDocument のノードの追加や編集に必要な外部リソースを解決するときにも使用されます。	XmlDocument に指定された XmlResolver は、外部リソースの検索と解決が必要な場合に常に使用されるリゾルバです。
プロパティが null (Microsoft Visual Basic .NET では Nothing) に設定されている。	外部のスキーマや DTD の検索など、外部リソースを必要とする機能はサポートされていません。外部エンティティの解決も行われず、解決が必要なエンティティノードの挿入などの編集機能もサポートされません。	XmlDocument は、ファイルを匿名で読み込みます。他のリソースを解決しようとはしません。
プロパティが設定されておらず、既定状態のままである。	ファイル名を解決したり、外部の DTD、エンティティ、スキーマを検索するときは、NULL 資格情報を持つ XmlUrlResolver のインスタンスが作成され、XmlDocument によって使用されます。ノードを編集するときは、null 資格情報が使用されます。

プロパティが、以前作成され、ユーザーの設定したプロパティを持っている XmlResolver クラスに設定されている。

XmlDocument は、ファイル名を解決するために指定された XmlResolver を使用し、DTD、エンティティ、スキーマなどの外部リソースへの参照を解決します。

XmlResolver は、XmlDocument のノードの追加や編集に必要な外部リソースを解決するときにも使用されます。

XmlDocument に指定された XmlResolver は、外部リソースの検索と解決が必要な場合に常に使用されるリゾルバです。

プロパティが null (Microsoft Visual Basic .NET では Nothing) に設定されている。

外部のスキーマや DTD の検索など、外部リソースを必要とする機能はサポートされていません。外部エンティティの解決も行われず、解決が必要なエンティティノードの挿入などの編集機能もサポートされません。

XmlDocument は、ファイルを匿名で読み込みます。他のリソースを解決しようとはしません。

プロパティが設定されておらず、既定状態のままである。

ファイル名を解決したり、外部の DTD、エンティティ、スキーマを検索するときは、NULL 資格情報を持つ XmlUrlResolver のインスタンスが作成され、XmlDocument によって使用されます。ノードを編集するときは、null 資格情報が使用されます。

Load への入力が XmlReader であり、XmlDocument が完全に信頼されている場合の XmlDocument.Load メソッドを次の表に示します。

XmlResolver プロパティ	機能	メモ
XmlDocument で使用される XmlResolver クラスが、XmlReader で使用されるクラスと同じである。	XmlDocument は、XmlReader に割り当てられた XmlResolver を使用します。 XmlDocument は XmlReader から XmlResolver を取得しているため、XmlDocument の信頼レベルにかかわらず、XmlDocument.Resolver プロパティは設定できません。XmlDocument の XmlResolver プロパティを設定することによって XmlReaders の XmlResolver の設定をオーバーライドすることはできません。	XmlReader は、XmlTextReader、XmlValidatingReader、または独自に作成したリーダーにすることができます。使用するリーダーでエンティティ解決がサポートされている場合は、外部エンティティが解決されます。渡されたリーダーでエンティティ参照がサポートされていない場合は、エンティティ参照は解決されません。

XmlDocument で使用される XmlResolver クラスが、XmlReader で使用されるクラスと同じである。

XmlDocument は、XmlReader に割り当てられた XmlResolver を使用します。

XmlDocument は XmlReader から XmlResolver を取得しているため、XmlDocument の信頼レベルにかかわらず、XmlDocument.Resolver プロパティは設定できません。XmlDocument の XmlResolver プロパティを設定することによって XmlReaders の XmlResolver の設定をオーバーライドすることはできません。

XmlReader は、XmlTextReader、XmlValidatingReader、または独自に作成したリーダーにすることができます。使用するリーダーでエンティティ解決がサポートされている場合は、外部エンティティが解決されます。渡されたリーダーでエンティティ参照がサポートされていない場合は、エンティティ参照は解決されません。

信頼性の高くない XmlDocument

オブジェクトの信頼性が高くない場合の XmlDocument.XmlResolver プロパティの動作を次の表に示します。Load への入力が TextReader、String、Stream、または URI である場合の XmlDocument.Load メソッドが対象です。XmlDocument が XmlReader から読み込まれた場合の Load メソッドは対象外です。

XmlResolver プロパティ	機能	メモ
信頼性が高くないシナリオでは、XmlResolver プロパティは null 以外に設定できない。	ファイル名を解決したり、外部の DTD、エンティティ、スキーマを検索するときは、null 資格情報を持つ XmlUrlResolver のインスタンスが作成され、XmlDocument によって使用されます。ノードを編集するときは、null 資格情報が使用されます。	この動作は、XmlResolver プロパティが設定されておらず、既定状態のままである場合と同じ動作になります。 XmlDocument では、すべての処理で、匿名のアクセス許可を使用します。
プロパティが null (Microsoft Visual Basic .NET では Nothing) に設定されている。	外部のスキーマや DTD の検索など、外部リソースを必要とする機能はサポートされていません。外部エンティティの解決も行われず、解決が必要なエンティティノードの挿入などの編集機能もサポートされません。	プロパティが null の場合の動作は、XmlDocument の信頼性の高低に関係なく、同じです。
プロパティが設定されておらず、既定状態のままである。	ファイル名を解決したり、外部の DTD、エンティティ、スキーマを検索するときは、null 資格情報を持つ XmlUrlResolver のインスタンスが作成され、XmlDocument によって使用されます。ノードを編集するときは、null 資格情報が使用されます。	XmlDocument では、すべての処理で、匿名のアクセス許可を使用します。

信頼性が高くないシナリオでは、XmlResolver プロパティは null 以外に設定できない。

ファイル名を解決したり、外部の DTD、エンティティ、スキーマを検索するときは、null 資格情報を持つ XmlUrlResolver のインスタンスが作成され、XmlDocument によって使用されます。ノードを編集するときは、null 資格情報が使用されます。

この動作は、XmlResolver プロパティが設定されておらず、既定状態のままである場合と同じ動作になります。

XmlDocument では、すべての処理で、匿名のアクセス許可を使用します。

プロパティが null (Microsoft Visual Basic .NET では Nothing) に設定されている。

プロパティが null の場合の動作は、XmlDocument の信頼性の高低に関係なく、同じです。

プロパティが設定されておらず、既定状態のままである。

XmlDocument では、すべての処理で、匿名のアクセス許可を使用します。

Load への入力が XmlReader であり、XmlDocument の信頼性が高くない場合の XmlDocument.Load メソッドを次の表に示します。

XmlResolver プロパティ	機能	メモ
XmlDocument で使用される XmlResolver クラスが、XmlReader で使用されるクラスと同じである。	XmlDocument は、XmlReader に割り当てられた XmlResolver を使用します。 XmlDocument は XmlReader から XmlResolver を取得しているため、XmlDocument の信頼レベルにかかわらず、XmlDocument.Resolver プロパティは設定できません。XmlDocument の XmlResolver プロパティを設定することによって XmlReaders の XmlResolver の設定をオーバーライドすることはできません。	XmlTextReader、検証用の XmlReader、または独自に作成したリーダーを XmlReader として使用できます。使用するリーダーでエンティティ解決がサポートされている場合は、外部エンティティが解決されます。渡されたリーダーでエンティティ参照がサポートされていない場合は、エンティティ参照は解決されません。

XmlDocument で使用される XmlResolver クラスが、XmlReader で使用されるクラスと同じである。

XmlDocument は、XmlReader に割り当てられた XmlResolver を使用します。

XmlTextReader、検証用の XmlReader、または独自に作成したリーダーを XmlReader として使用できます。使用するリーダーでエンティティ解決がサポートされている場合は、外部エンティティが解決されます。渡されたリーダーでエンティティ参照がサポートされていない場合は、エンティティ参照は解決されません。

XmlResolver が正しい資格情報を持つように設定すれば、外部リソースにアクセスできます。

メモ :
XmlResolver プロパティを取得する方法はありません。これは、資格情報が設定されている XmlResolver をユーザーが再利用するのを防ぐためです。また、XmlTextReader または検証用の XmlReader を使用して、リゾルバが設定されている XmlDocument を読み込んだ場合、XmlDocument は、セキュリティリスクを回避するために、Load フェーズの後、これらのリーダーのリゾルバをキャッシュしません。

XmlResolver プロパティを取得する方法はありません。これは、資格情報が設定されている XmlResolver をユーザーが再利用するのを防ぐためです。また、XmlTextReader または検証用の XmlReader を使用して、リゾルバが設定されている XmlDocument を読み込んだ場合、XmlDocument は、セキュリティリスクを回避するために、Load フェーズの後、これらのリーダーのリゾルバをキャッシュしません。

詳細については、「XmlResolver を使用したリソースの解決」を参照してください。

参照

概念

XML ドキュメントオブジェクトモデル (DOM)

次の方法で共有

外部リソースの解決

完全に信頼されている XmlDocument

信頼性の高くない XmlDocument

参照

概念

その他のリソース