WebClient.UseDefaultCredentials Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um valor Boolean que controla se os DefaultCredentials são enviados com solicitações.
public:
property bool UseDefaultCredentials { bool get(); void set(bool value); };public bool UseDefaultCredentials { get; set; }member this.UseDefaultCredentials : bool with get, setPublic Property UseDefaultCredentials As BooleanValor da propriedade
true se as credenciais padrão forem usadas; caso contrário, false. O valor padrão é false.
Exemplos
O exemplo de código a seguir demonstra como definir essa propriedade.
// 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
Comentários
Cuidado
WebRequest, HttpWebRequest, ServicePointe WebClient estão obsoletos e você não deve usá-los para um novo desenvolvimento. Em vez disso, use HttpClient.
Defina essa propriedade para true quando as solicitações feitas por esse objeto WebClient devem, se solicitadas pelo servidor, serem autenticadas usando as credenciais padrão do usuário conectado no momento. Para aplicativos cliente, esse é o comportamento desejado na maioria dos cenários. Para aplicativos de camada intermediária, como aplicativos ASP.NET, em vez de usar essa propriedade, você normalmente definiria a propriedade Credentials para as credenciais do cliente em cujo nome a solicitação é feita.
