WebClient.UseDefaultCredentials Właściwość

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebClient.dll

Źródło:

WebClient.cs

Pobiera lub ustawia wartość, która określa Boolean , czy DefaultCredentials są wysyłane z żądaniami.

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

Wartość właściwości

Boolean

true jeśli są używane poświadczenia domyślne; w przeciwnym razie false. Wartość domyślna to false.

Przykłady

Poniższy przykład kodu pokazuje ustawienie tej właściwości.

// 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

Uwagi

Ustaw tę właściwość na true wartość, gdy żądania wysyłane przez ten WebClient obiekt powinny być uwierzytelniane przy użyciu domyślnych poświadczeń aktualnie zalogowanego użytkownika. W przypadku aplikacji klienckich jest to pożądane zachowanie w większości scenariuszy. W przypadku aplikacji warstwy środkowej, takich jak aplikacje ASP.NET, zamiast używać tej właściwości, zazwyczaj należy ustawić Credentials właściwość na poświadczenia klienta w jego imieniu.