WebClient.UseDefaultCredentials Propiedad

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.WebClient.dll

Source:

WebClient.cs

Obtiene o establece un valor Boolean que controla si se envían DefaultCredentials con las 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

Es true si se utilizan las credenciales predeterminadas; en caso contrario, es 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

Establezca esta propiedad true en cuando las solicitudes realizadas por este WebClient objeto deben autenticarse, si el servidor lo solicita, 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 Credentials propiedad en las credenciales del cliente en cuyo nombre se realiza la solicitud.