XmlValidatingReader.XmlResolver プロパティ

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

XmlValidatingReader.XmlResolver プロパティ

外部ドキュメント型定義 (DTD) およびスキーマ位置参照を解決するために使用する XmlResolver を設定します。XmlResolver は、XML スキーマ定義言語 (XSD) スキーマで見つかったインポート要素またはインクルード要素を処理するためにも使用されます。

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

Visual Basic (宣言)

Public WriteOnly Property
 XmlResolver As XmlResolver

Visual Basic (使用法)

Dim instance As XmlValidatingReader
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) に設定されていると、外部リソースが解決されません。 .NET Framework バージョン 1.1 では、呼び出し元が完全に信頼されていなければ XmlResolver を指定できません。

解説

メモ
Microsoft .NET Framework version 2.0 では、XmlValidatingReader クラスは使用されなくなりました。検証を実行する XmlReader のインスタンスは、XmlReaderSettings クラスおよび Create メソッドを使用して作成できます。詳細については、「XmlReader による XML データの検証」を参照してください。

XmlResolver は、検証プロセスを完了するために必要な DTD、エンティティ、またはスキーマを読み込むために使用します。

このプロパティはいつでも設定でき、次の Read 呼び出しの後に有効となります。このプロパティを null 参照 (Visual Basic では Nothing) に設定すると、リーダーは外部参照を解決する必要がないと判断します。この場合、リーダーは、リソースがある場合、内部リソースだけを検証します。

.NET Framework バージョン 1.1 では、このプロパティが設定されていない場合、アプリケーションの信頼性レベルによって既定の動作が決まります。

Fully trusted code: リーダーは、ユーザー資格情報を持たない既定の XmlUrlResolver を使用します。ネットワーク リソースへのアクセスに認証が要求される場合、XmlResolver プロパティを使用して必要な資格情報で XmlResolver を指定してください。

Semi-trusted code: XmlResolver プロパティが null 参照 (Visual Basic では Nothing) に設定されています。外部リソースが解決されていません。

スキーマを使用して検証を行う場合は、Schemas プロパティを使用して XmlSchemaCollection を指定することにより、手間のかかる読み込みプロセスを回避できます。

使用例

XmlResolver プロパティを使用して、ネットワーク DTD ファイルのアクセスに必要な資格情報を指定する例を次に示します。

Visual Basic

' Create the reader.
Dim txtreader as XmlTextReader = new
 XmlTextReader("book5.xml")
Dim reader as XmlValidatingReader = new
 XmlValidatingReader(txtreader)
txtreader.WhitespaceHandling = WhitespaceHandling.None

' Set the credentials necessary to access the DTD file stored on the
 network.
Dim resolver as XmlUrlResolver = new
 XmlUrlResolver()
resolver.Credentials = System.Net.CredentialCache.DefaultCredentials
reader.XmlResolver = resolver

' Display each of the element nodes.
while (reader.Read())
   select case reader.NodeType
     case XmlNodeType.Element:
       Console.Write("<{0}>", reader.Name)
     case XmlNodeType.Text:
       Console.Write(reader.Value)
     case XmlNodeType.DocumentType:
       Console.Write("<!DOCTYPE {0} [{1}]", reader.Name,
 reader.Value)
     case XmlNodeType.EntityReference:
       Console.Write(reader.Name)
     case XmlNodeType.EndElement:
       Console.Write("</{0}>", reader.Name)
   end select        
end while           

C#

// Create the reader.
XmlTextReader txtreader = new XmlTextReader("book5.xml");
XmlValidatingReader reader = new XmlValidatingReader(txtreader);
txtreader.WhitespaceHandling = WhitespaceHandling.None;

// Set the credentials necessary to access the DTD file stored on the
 network.
XmlUrlResolver resolver = new XmlUrlResolver();
resolver.Credentials = System.Net.CredentialCache.DefaultCredentials;
reader.XmlResolver = resolver;

// Display each of the element nodes.
while (reader.Read()){
   switch (reader.NodeType){
     case XmlNodeType.Element:
       Console.Write("<{0}>", reader.Name);
       break;
     case XmlNodeType.Text:
       Console.Write(reader.Value);
       break;
     case XmlNodeType.DocumentType:
       Console.Write("<!DOCTYPE {0} [{1}]", reader.Name, reader.Value);
       break;
     case XmlNodeType.EntityReference:
       Console.Write(reader.Name);
       break;
     case XmlNodeType.EndElement:
       Console.Write("</{0}>", reader.Name);
       break;
  }        
}           

C++

   // Create the reader. -> 
   XmlTextReader^ txtreader = gcnew XmlTextReader( "book5.xml" );
   XmlValidatingReader^ reader = gcnew XmlValidatingReader( txtreader );
   txtreader->WhitespaceHandling = WhitespaceHandling::None;
   
   // Set the credentials necessary to access the DTD file stored on the
 network.
   XmlUrlResolver^ resolver = gcnew XmlUrlResolver;
   resolver->Credentials = System::Net::CredentialCache::DefaultCredentials;
   reader->XmlResolver = resolver;
   
   // Display each of the element nodes.
   while ( reader->Read() )
   {
      switch ( reader->NodeType )
      {
         case XmlNodeType::Element:
            Console::Write( "< {0}>", reader->Name );
            break;

         case XmlNodeType::Text:
            Console::Write( reader->Value );
            break;

         case XmlNodeType::DocumentType:
            Console::Write( "<!DOCTYPE {0} [ {1}]", reader->Name,
 reader->Value );
            break;

         case XmlNodeType::EntityReference:
            Console::Write( reader->Name );
            break;

         case XmlNodeType::EndElement:
            Console::Write( "</ {0}>", reader->Name );
            break;
      }
   }

   
   // Close the reader.
   reader->Close();
}

この例では、次のデータ ファイルを入力として使用しています。

book5.xml

<!DOCTYPE book SYSTEM 'http://myServer/DTDs/books.dtd'>
<book ISBN = '1-861001-57-5'>
  <title>Pride And
 Prejudice</title>
  <price>19.95</price>
  <misc>&h;</misc>
</book>

books.dtd

<!ELEMENT book (title,price,misc)>
 
<!ATTLIST book 
   genre CDATA "novel"
   ISBN CDATA #REQUIRED>
<!ELEMENT title (#PCDATA)>
<!ELEMENT price (#PCDATA)>
<!ELEMENT misc (#PCDATA)>
<!ENTITY h "hardcover">
<!ENTITY p "paperback">

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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、1.1、1.0

参照

関連項目
XmlValidatingReader クラス
XmlValidatingReader メンバ
System.Xml 名前空間
XmlUrlResolver.Credentials プロパティ
CredentialCache
NetworkCredential
XmlSecureResolver クラス
その他の技術情報
XmlReader による XML の読み取り