WebProxy.UseDefaultCredentials Propriété

  • Référence

Définition

Espace de noms:
System.Net
Assembly:
System.Net.WebProxy.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Source:
WebProxy.cs
Source:
WebProxy.cs
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.

S’applique à