WebProxy.UseDefaultCredentials Eigenschaft

Definition

Namespace:

System.Net

Assembly:

System.Net.WebProxy.dll

Quelle:

WebProxy.cs

Ruft einen Boolean-Wert ab, der steuert, ob mit den Anforderungen DefaultCredentials gesendet werden, oder legt diesen fest.

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

true, wenn die Standardanmeldeinformationen verwendet werden, andernfalls false. Der Standardwert ist false.

Ausnahmen

InvalidOperationException

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

Hinweise

Legen Sie diese Eigenschaft auf fest true , wenn Anforderungen, die von diesem WebProxy Objekt gestellt werden, bei Bedarf vom Server mithilfe der Anmeldeinformationen des aktuell angemeldeten Benutzers authentifiziert werden sollen. Für Clientanwendungen ist dies das gewünschte Verhalten in den meisten Szenarien. Bei Anwendungen der mittleren Ebene, z. B. ASP.NET Anwendungen, legen Sie die Eigenschaft anstelle dieser Eigenschaft in der Credentials Regel auf die Anmeldeinformationen des Clients fest, in dessen Auftrag die Anforderung gestellt wird.

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

Wert vom Typ Credentials	Wert vom Typ UseDefaultCredentials	Auswirkung
DefaultCredentials	true	Keine Auswirkung.
DefaultCredentials	false	Für Credentials ist null festgelegt.
null	true	Für Credentials ist DefaultCredentials festgelegt.
Alle anderen 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 ist true, löst das Ändern der Credentials Eigenschaft von DefaultCredentials (der Wert, der festgelegt wird, wenn die UseDefaultCredentials Eigenschaft auf truefestgelegt wird) eine Ausnahme aus.