WebClient.UseDefaultCredentials Propriété

Définition

Espace de noms:

System.Net

Assembly:

System.Net.WebClient.dll

Source:

WebClient.cs

Obtient ou définit une valeur Boolean qui contrôle si les DefaultCredentials sont envoyées avec des requêtes.

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

Valeur de propriété

Boolean

true si les informations d’identification par défaut sont utilisées ; sinon, false. La valeur par défaut est false.

Exemples

L’exemple de code suivant illustre la définition de cette propriété.

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

Remarques

Prudence

WebRequest, HttpWebRequest, ServicePointet WebClient sont obsolètes et vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.

Définissez cette propriété sur true lorsque les demandes effectuées par cet objet WebClient doivent, si demandées par le serveur, être authentifiées à l’aide des informations d’identification par défaut de l’utilisateur actuellement connecté. Pour les applications clientes, il s’agit du comportement souhaité dans la plupart des scénarios. Pour les applications de niveau intermédiaire, telles que les applications ASP.NET, au lieu d’utiliser cette propriété, vous devez généralement définir la propriété Credentials sur les informations d’identification du client au nom duquel la demande est effectuée.