WebProxy.UseDefaultCredentials Propriété

Définition

Espace de noms:

System.Net

Assembly:

System.Net.WebProxy.dll

Source:

WebProxy.cs

Obtient ou définit une valeur Boolean qui contrôle si les DefaultCredentials sont envoyés avec les demandes.

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 essayé de définir cette propriété alors que la propriété Credentials contient des informations d’identification autres que celles 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 définissez généralement 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	Effet
DefaultCredentials	true	Aucun effet.
DefaultCredentials	false	Credentials a la valeur null.
null	true	Credentials a la valeur DefaultCredentials.
Toute valeur autre que DefaultCredentials ou null	true ou false	Le paramètre UseDefaultCredentials lève une exception.

Si UseDefaultCredentials est false, vous pouvez remplacer la propriété par Credentials n’importe quelles informations d’identification. Si UseDefaultCredentials est true, la modification de la Credentials propriété de DefaultCredentials (la valeur définie lorsque la UseDefaultCredentials propriété a la truevaleur ) lève une exception.