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 true fest, wenn anforderungen, die von diesem WebProxy Objekt vorgenommen werden, wenn sie vom Server angefordert werden, mit den Anmeldeinformationen des aktuell angemeldeten Benutzers authentifiziert werden sollen. Bei Clientanwendungen ist dies in den meisten Szenarien das gewünschte Verhalten. 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 Namen die Anforderung erfolgt.

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.

falseWenn UseDefaultCredentials ist, können Sie die Credentials -Eigenschaft in beliebige Anmeldeinformationen ändern. Wenn UseDefaultCredentials auf festgelegt 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.