WebProxy.UseDefaultCredentials Eigenschaft

Definition

Namespace:

System.Net

Assemblys:

netstandard.dll, System.Net.WebProxy.dll

Quelle:

WebProxy.cs

Dient zum Abrufen oder Festlegen eines Boolean Werts, der steuert, ob die DefaultCredentials Mit Anforderungen gesendet werden.

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

Eigenschaftswert

Boolean

truewenn die Standardanmeldeinformationen verwendet werden; andernfalls . false Der Standardwert ist false.

Ausnahmen

InvalidOperationException

Sie haben versucht, diese Eigenschaft festzulegen, wenn die Credentials Eigenschaft andere Anmeldeinformationen als die Standardanmeldeinformationen enthält.

Hinweise

Legen Sie diese Eigenschaft fest, true wenn Anforderungen dieses WebProxy Objekts, falls vom Server angefordert, mithilfe der Anmeldeinformationen des aktuell angemeldeten Benutzers authentifiziert werden sollen. Bei Clientanwendungen ist dies das gewünschte Verhalten in den meisten Szenarien. Bei Anwendungen der mittleren Ebene, z. B. ASP.NET Anwendungen, statt diese Eigenschaft zu verwenden, würden Sie die Credentials Eigenschaft in der Regel auf die Anmeldeinformationen des Clients festlegen, in dessen Auftrag die Anforderung erfolgt.

Die folgende Tabelle zeigt die Auswirkung des Festlegens des UseDefaultCredentials Werts basierend auf dem Wert der Credentials Eigenschaft.

Credentials-Wert	UseDefaultCredentials-Wert	Auswirkung
DefaultCredentials	true	Keine Auswirkung.
DefaultCredentials	false	Credentials ist auf null festgelegt.
null	true	Credentials ist auf DefaultCredentials festgelegt.
Beliebige andere Werte als DefaultCredentials oder null	true oder false	Die Einstellung UseDefaultCredentials löst eine Ausnahme aus.

Wenn UseDefaultCredentials dies der Fall ist false, können Sie die Credentials Eigenschaft in beliebige Anmeldeinformationen ändern. Wenn UseDefaultCredentials die trueCredentials Eigenschaft DefaultCredentials geändert wird (der Wert, der festgelegt wird, wenn die UseDefaultCredentials Eigenschaft auf " festgelegt trueist) wird eine Ausnahme ausgelöst.