XmlReaderSettings.XmlResolver プロパティ

.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

C#

public XmlResolver XmlResolver { set; }

C++

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

J#

/** @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 検証フラグが設定されていても、スキーマの場所は解決されません。 検証を実行しているときにスキーマを追加すると新しい型が追加されるため、検証しているドキュメントの検証結果を変えることができます。このため、信頼関係のあるソースの外部スキーマだけを解決するようにしてください。

使用例

既定の資格情報で 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)

C#

// 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);

プラットフォーム

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 の外部リソースへのアクセス