XmlUrlResolver.Credentials プロパティ

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

XmlUrlResolver.Credentials プロパティ

Web 要求を認証するために使用する資格情報を設定します。

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

Visual Basic (宣言)

Public Overrides WriteOnly
 Property Credentials As ICredentials

Visual Basic (使用法)

Dim instance As XmlUrlResolver
Dim value As ICredentials

instance.Credentials = value

C#

public override ICredentials Credentials { set;
 }

C++

public:
virtual property ICredentials^ Credentials {
    void set (ICredentials^ value) override;
}

J#

/** @property */
public void set_Credentials (ICredentials value)

JScript

public override function set
 Credentials (value : ICredentials)

プロパティ値
ICredentials オブジェクト。このプロパティが設定されていない場合、既定値は null 参照 (Visual Basic では Nothing) です。つまり、XmlUrlResolver はユーザーの資格情報を持ちません。

解説

仮想ディレクトリが認証を要求しない場合は、このプロパティを設定する必要はありません。それ以外の場合は、ユーザーの資格情報を提供する必要があります。

別の資格情報を異なる URI に関連付け、資格情報キャッシュに追加できます。その後、この資格情報を使用して、XML の元のソースに関係なく、異なる URI の認証を確認できます。

Credentials プロパティを資格情報キャッシュに設定する方法を次の C# コードに示します。

NetworkCredential myCred = new NetworkCredential(UserName,SecurelyStoredPassword,Domain);
 
CredentialCache myCache = new CredentialCache(); 
myCache.Add(new Uri("http://www.contoso.com/"), "Basic", myCred); 
myCache.Add(new Uri("http://app.contoso.com/"), "Basic", myCred);
XmlUrlResolver resolver = new XmlUrlResolver();
resolver.Credentials = myCache;

使用例

資格情報を使用して XmlUrlResolver オブジェクトを作成する例を次に示します。XmlReader は、XmlUrlResolver オブジェクトの資格情報を使用してネットワーク リソースにアクセスします。

Visual Basic

' Create a resolver and specify the necessary credentials.
Dim resolver As New XmlUrlResolver()
Dim myCred As System.Net.NetworkCredential
myCred = New System.Net.NetworkCredential(UserName, SecurelyStoredPassword,
 Domain)
resolver.Credentials = myCred
    

C#

// Create a resolver and specify the necessary credentials.
XmlUrlResolver resolver = new XmlUrlResolver();
System.Net.NetworkCredential myCred;
myCred  = new System.Net.NetworkCredential(UserName,SecurelyStoredPassword,Domain);
  
resolver.Credentials = myCred;

プラットフォーム

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

参照

関連項目
XmlUrlResolver クラス
XmlUrlResolver メンバ
System.Xml 名前空間
CredentialCache
NetworkCredential