WebClient.UseDefaultCredentials プロパティ

定義

名前空間:

System.Net

アセンブリ:

System.Net.WebClient.dll

ソース:

WebClient.cs

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

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

public bool UseDefaultCredentials { get; set; }

member this.UseDefaultCredentials : bool with get, set

Public Property UseDefaultCredentials As Boolean

プロパティ値

Boolean

既定の資格情報が使用される場合は true します。それ以外の場合は false。 既定値は falseです。

例

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

// Sample call: UploadFileInBackground3("http://www.contoso.com/fileUpload.aspx", "data.txt")
void UploadFileInBackground3( String^ address, String^ fileName )
{

   WebClient^ client = gcnew WebClient;
   Uri ^uri = gcnew Uri(address);

   client->UseDefaultCredentials = true;

   client->UploadFileCompleted += gcnew UploadFileCompletedEventHandler( UploadFileCallback2 );
   client->UploadFileAsync( uri, fileName );
   Console::WriteLine( "File upload started." );
}

// 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.");
}

'  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

注釈

注意

WebRequest、HttpWebRequest、ServicePoint、WebClient は廃止されており、新しい開発には使用しないでください。 代わりに HttpClient を使用してください。

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