XmlTextReader.XmlResolver プロパティ

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

XmlTextReader.XmlResolver プロパティ

DTD 参照を解決するために使用する XmlResolver を設定します。

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

Visual Basic (宣言)

Public WriteOnly Property
 XmlResolver As XmlResolver

Visual Basic (使用法)

Dim instance As XmlTextReader
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 Version 1.1 では、XmlResolver を指定するには呼び出し元が完全に信頼されている必要があります。

解説

メモ
Microsoft .NET Framework version 2.0 リリースでは、System.Xml.XmlReader.Create メソッドを使用して XmlReader インスタンスを作成することをお勧めします。これにより、このリリースで導入された新機能を十分に活用できます。詳細については、「XML リーダーの作成」を参照してください。

リーダーは、XmlResolver を使用して、リーダーに読み込まれるファイルの位置を解決し、DTD 参照も解決します。たとえば、XML に <!DOCTYPE book SYSTEM book.dtd> という DOCTYPE 宣言が含まれていた場合、リーダーはこの外部ファイルを解決し、DTD が整形式であるようにします。リーダーは、検証のために DTD を使用しません。

このプロパティはいつでも変更でき、次の読み取り操作時に有効となります。このプロパティを null 参照 (Visual Basic では Nothing) に設定すると、リーダーが検出した外部 DTD 参照はどれも解決されません。

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

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

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

使用例

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

Visual Basic

Imports System
Imports System.IO
Imports System.Xml
Imports System.Net

public class Sample 

  public shared sub Main()
 

    ' Create the reader.
    Dim reader as XmlTextReader = new
 XmlTextReader("http://myServer/data/books.xml")
   
    ' Supply the credentials necessary to access the Web server.
    Dim resolver as XmlUrlResolver = new
 XmlUrlResolver()
    resolver.Credentials = CredentialCache.DefaultCredentials
    reader.XmlResolver = resolver

    ' Parse the file.
    while (reader.Read()) 
       ' Do any additional processing here.
    end while           
  
    ' Close the reader.
    reader.Close()     
  
  end sub
end class

C#

using System;
using System.IO;
using System.Xml;
using System.Net;

public class Sample {

  public static void Main()
 {

    // Create the reader.
    XmlTextReader reader = new XmlTextReader("http://myServer/data/books.xml");
   
    // Supply the credentials necessary to access the Web server.
    XmlUrlResolver resolver = new XmlUrlResolver();
    resolver.Credentials = CredentialCache.DefaultCredentials;
    reader.XmlResolver = resolver;

    // Parse the file.
    while (reader.Read()) {
       // Do any additional processing here.
    }           
  
    // Close the reader.
    reader.Close();     
  
  }
} 

C++

#using <System.dll>
#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
using namespace System::Net;
int main()
{
   
   // Create the reader.
   XmlTextReader^ reader = gcnew XmlTextReader( "http://myServer/data/books.xml"
 );
   
   // Supply the credentials necessary to access the Web server.
   XmlUrlResolver^ resolver = gcnew XmlUrlResolver;
   resolver->Credentials = CredentialCache::DefaultCredentials;
   reader->XmlResolver = resolver;
   
   // Parse the file.
   while ( reader->Read() )
   {
      
      // Do any additional processing here.
   }

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

プラットフォーム

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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

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