WebClient.UseDefaultCredentials プロパティ

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

WebClient.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 WebClient
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 です。

解説

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

使用例

このプロパティを設定するコード例を次に示します。

Visual Basic

'  Sample call: UploadFileInBackground3("http:' www.contoso.com/fileUpload.aspx",
 "data.txt")
Public Shared Sub UploadFileInBackground3(ByVal
 address As String, ByVal
 fileName As String)

    Dim client As WebClient = New
 WebClient()
                Dim uri as Uri =  New
 Uri(address)
    client.UseDefaultCredentials = True
    AddHandler client.UploadFileCompleted, AddressOf
 UploadFileCallback2
    client.UploadFileAsync(uri, fileName)
    Console.WriteLine("File upload started.")
End Sub

C#

// Sample call: UploadFileInBackground3("http://www.contoso.com/fileUpload.aspx",
 "data.txt")
public static void UploadFileInBackground3
 (string address, string fileName)
{
    WebClient client = new WebClient ();

    Uri uri = new Uri(address);

    client.UseDefaultCredentials = true;
    client.UploadFileCompleted += new UploadFileCompletedEventHandler
 (UploadFileCallback2);
    client.UploadFileAsync (uri, fileName);
    Console.WriteLine ("File upload started.");
}

プラットフォーム

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

参照

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