XmlReaderSettings.XmlResolver プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

XmlReaderSettings.XmlResolver プロパティ

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

外部ドキュメントへのアクセスに使用する XmlResolver を設定します。

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

Visual Basic (宣言)

Public WriteOnly Property
 XmlResolver As XmlResolver

Visual Basic (使用法)

Dim instance As XmlReaderSettings
Dim value As XmlResolver

instance.XmlResolver = value

public XmlResolver XmlResolver { set; }

C++

public:
property XmlResolver^ XmlResolver {
    void set (XmlResolver^ value);
}

/** @property */
public void set_XmlResolver (XmlResolver value)

JScript

public function set XmlResolver
 (value : XmlResolver)

プロパティ値
外部ドキュメントへのアクセスに使用する XmlResolver。null 参照 (Visual Basic では Nothing) に設定されている場合、XmlReader が外部リソースにアクセスしようとすると、XmlException がスローされます。既定値は、資格情報のない新しい XmlUrlResolver です。

解説

XmlResolver は、XML インスタンスドキュメントを見つけて開いたり、XML インスタンスドキュメントによって参照される外部リソースを見つけて開いたりするために使用されます。これには、エンティティ、DTD、またはスキーマを含めることができます。XmlResolver.Credentials プロパティは、ネットワーク認証に必要な資格情報を指定するために使用できます。

セキュリティに関するメモ
XmlResolver にはユーザー資格情報などの機密情報を格納できるため、XmlReaderSettings オブジェクトをキャッシュしたり、1 つのコンポーネントから別のコンポーネントに XmlReaderSettings オブジェクトを渡す場合には注意が必要です。 XmlSecureResolver は、外部ドキュメントへのアクセスに使用できます。XmlSecureResolver クラスは、XmlResolver オブジェクトをラップし、基になっている XmlResolver がアクセスできるリソースを制限することによって、XmlResolver の別の実装をセキュリティで保護する場合に役立ちます。詳細については、「方法 : XmlSecureResolver クラスを使用する」を参照してください。既定では、XmlReaderSettings オブジェクトの ProcessInlineSchema 検証フラグおよび ProcessSchemaLocation 検証フラグは設定されません。これらのフラグを設定すると、XmlReader のインスタンスドキュメントで検出されたスキーマの場所を解決するときに、XmlReaderSettings オブジェクトの XmlResolver が使用されます。XmlResolver オブジェクトが null 参照 (Visual Basic では Nothing) の場合は、ProcessInlineSchema 検証フラグと ProcessSchemaLocation 検証フラグが設定されていても、スキーマの場所は解決されません。検証を実行しているときにスキーマを追加すると新しい型が追加されるため、検証しているドキュメントの検証結果を変えることができます。このため、信頼関係のあるソースの外部スキーマだけを解決するようにしてください。

セキュリティに関するメモ

XmlResolver にはユーザー資格情報などの機密情報を格納できるため、XmlReaderSettings オブジェクトをキャッシュしたり、1 つのコンポーネントから別のコンポーネントに XmlReaderSettings オブジェクトを渡す場合には注意が必要です。

XmlSecureResolver は、外部ドキュメントへのアクセスに使用できます。XmlSecureResolver クラスは、XmlResolver オブジェクトをラップし、基になっている XmlResolver がアクセスできるリソースを制限することによって、XmlResolver の別の実装をセキュリティで保護する場合に役立ちます。詳細については、「方法 : XmlSecureResolver クラスを使用する」を参照してください。

既定では、XmlReaderSettings オブジェクトの ProcessInlineSchema 検証フラグおよび ProcessSchemaLocation 検証フラグは設定されません。これらのフラグを設定すると、XmlReader のインスタンスドキュメントで検出されたスキーマの場所を解決するときに、XmlReaderSettings オブジェクトの XmlResolver が使用されます。XmlResolver オブジェクトが null 参照 (Visual Basic では Nothing) の場合は、ProcessInlineSchema 検証フラグと ProcessSchemaLocation 検証フラグが設定されていても、スキーマの場所は解決されません。

検証を実行しているときにスキーマを追加すると新しい型が追加されるため、検証しているドキュメントの検証結果を変えることができます。このため、信頼関係のあるソースの外部スキーマだけを解決するようにしてください。

使用例

既定の資格情報で XmlSecureResolver を使用する XmlReader を作成する方法の例を次に示します。

Visual Basic

' Create an XmlSecureResolver with default credentials.
Dim myResolver As New XmlSecureResolver(New
 XmlUrlResolver(), "http://serverName/data/")
myResolver.Credentials = CredentialCache.DefaultCredentials

Dim settings As New XmlReaderSettings()
settings.XmlResolver = myResolver

' Create the reader.
Dim reader As XmlReader = XmlReader.Create("http://serverName/data/books.xml",
 settings)

// Create an XmlSecureResolver with default credentials.
XmlSecureResolver myResolver = new XmlSecureResolver(new
 XmlUrlResolver(), "http://serverName/data/");
myResolver.Credentials = CredentialCache.DefaultCredentials;

XmlReaderSettings settings = new XmlReaderSettings();
settings.XmlResolver = myResolver;

// Create the reader.
XmlReader reader = XmlReader.Create("http://serverName/data/books.xml",
 settings);