WebProxy.UseDefaultCredentials Propriété

Définition

Espace de noms:

System.Net

Assemblys:

netstandard.dll, System.Net.WebProxy.dll

Source:

WebProxy.cs

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

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.

Exceptions

InvalidOperationException

Vous avez tenté de définir cette propriété lorsque la Credentials propriété contient des informations d’identification autres que les informations d’identification par défaut.

Remarques

Définissez cette propriété true sur quand les demandes effectuées par cet WebProxy objet doivent, si elles sont demandées par le serveur, être authentifiées à l’aide des informations d’identification 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 Credentials propriété sur les informations d’identification du client au nom duquel la demande est effectuée.

Le tableau suivant montre l’effet de la définition de la UseDefaultCredentials valeur, en fonction de la valeur de la Credentials propriété.

valeur Credentials	valeur UseDefaultCredentials	Résultat
DefaultCredentials	true	Aucun effet.
DefaultCredentials	false	Credentials est défini sur null.
null	true	Credentials est défini sur DefaultCredentials.
Toute valeur autre que DefaultCredentials ou null	true ou false	Le paramètre UseDefaultCredentials lève une exception.

Si UseDefaultCredentials c’est falsele cas, vous pouvez modifier la Credentials propriété en informations d’identification. Si UseDefaultCredentials c’est truele cas, la modification de la Credentials propriété ( DefaultCredentials la valeur définie lorsque la UseDefaultCredentials propriété est définie truesur ) lève une exception.