WebProxy.UseDefaultCredentials プロパティ

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

WebProxy.UseDefaultCredentials プロパティ

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

DefaultCredentials が要求と共に送信されるかどうかを制御する Boolean 値を取得または設定します。

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

Visual Basic (宣言)

Public Property UseDefaultCredentials As
 Boolean

Visual Basic (使用法)

Dim instance As WebProxy
Dim value As Boolean

value = instance.UseDefaultCredentials

instance.UseDefaultCredentials = value

C#

public bool UseDefaultCredentials { get;
 set; }

C++

public:
property bool UseDefaultCredentials {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_UseDefaultCredentials ()

/** @property */
public void set_UseDefaultCredentials (boolean
 value)

JScript

public function get UseDefaultCredentials
 () : boolean

public function set UseDefaultCredentials
 (value : boolean)

プロパティ値
既定の資格情報を使用する場合は true。それ以外の場合は false。既定値は false です。

例外

例外の種類	条件
InvalidOperationException	Credentials プロパティに既定の資格情報以外の資格情報が格納されている場合に、このプロパティを設定しようとしました。詳細については、「解説」を参照してください。

解説

この WebProxy オブジェクトによって行われた要求を、現在ログオンしているユーザーの資格情報を使用して認証する必要がある場合 (サーバーによって要求されている場合) は、このプロパティを true に設定します。クライアント アプリケーションでは、ほとんどの場合、これが目的にかなった動作になります。ASP.NET などの中間層のアプリケーションの場合は、通常、このプロパティを使用せずに、Credentials プロパティを、要求を代理実行する対象のクライアントの資格情報に設定します。

Credentials プロパティの値に基づく、UseDefaultCredentials 値の設定による影響を次の表に示します。

Credentials 値	UseDefaultCredentials 値	影響
DefaultCredentials	true	影響なし。
DefaultCredentials	false	Credentials が null 参照 (Visual Basic では Nothing) に設定されています。
null 参照 (Visual Basic では Nothing)	true	Credentials が DefaultCredentials に設定されています。
DefaultCredentials 以外の値または null 参照 (Visual Basic では Nothing)。	true または false	UseDefaultCredentials を設定すると例外がスローされます。

UseDefaultCredentials が false の場合は、Credentials プロパティを任意の資格情報に変更できます。UseDefaultCredentials が true の場合は、Credentials プロパティを DefaultCredentials (UseDefaultCredentials プロパティが true に設定されている場合に設定される値) 以外に変更すると、例外がスローされます。

プラットフォーム

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

参照

関連項目
WebProxy クラス
WebProxy メンバ
System.Net 名前空間