WebClient.UseDefaultCredentials Propiedad

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.WebClient.dll

Source:

WebClient.cs

Obtiene o establece un valor de Boolean que controla si el DefaultCredentials se envían con solicitudes.

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

Valor de propiedad

Boolean

true si se usan las credenciales predeterminadas; de lo contrario, false. El valor predeterminado es false.

Ejemplos

En el ejemplo de código siguiente se muestra cómo establecer esta propiedad.

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

Comentarios

Cautela

WebRequest, HttpWebRequest, ServicePointy WebClient están obsoletos y no debe usarlos para el nuevo desarrollo. Use HttpClient en su lugar.

Establezca esta propiedad en true cuando se deben autenticar las solicitudes realizadas por este objeto WebClient, si lo solicita el servidor, mediante las credenciales predeterminadas del usuario que ha iniciado sesión actualmente. En el caso de las aplicaciones cliente, este es el comportamiento deseado en la mayoría de los escenarios. En el caso de las aplicaciones de nivel intermedio, como ASP.NET aplicaciones, en lugar de usar esta propiedad, normalmente establecería la propiedad Credentials en las credenciales del cliente en cuyo nombre se realiza la solicitud.