WebProxy.UseDefaultCredentials Vlastnost

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.WebProxy.dll

Zdroj:

WebProxy.cs

Získá nebo nastaví Boolean hodnotu, která určuje, zda DefaultCredentials jsou odesílány s požadavky.

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

Hodnota vlastnosti

Boolean

truepokud se použijí výchozí přihlašovací údaje; v opačném případě . false Výchozí hodnota je false.

Výjimky

InvalidOperationException

Pokusili jste se nastavit tuto vlastnost, pokud Credentials vlastnost obsahuje jiné přihlašovací údaje než výchozí přihlašovací údaje.

Poznámky

Tuto vlastnost nastavte na hodnotu true , kdy se požadavky provedené tímto WebProxy objektem mají v případě požadavku serveru ověřit pomocí přihlašovacích údajů aktuálně přihlášeného uživatele. U klientských aplikací se jedná o požadované chování ve většině scénářů. U aplikací střední vrstvy, jako jsou aplikace ASP.NET, byste místo použití této vlastnosti obvykle nastavili Credentials vlastnost na přihlašovací údaje klienta, jehož jménem se žádost provádí.

Následující tabulka ukazuje efekt nastavení UseDefaultCredentials hodnoty na základě hodnoty Credentials vlastnosti.

Credentials Hodnotu	UseDefaultCredentials Hodnotu	Účinek
DefaultCredentials	true	Žádný vliv
DefaultCredentials	false	Credentials je nastavená na nullhodnotu .
null	true	Credentials je nastavená na DefaultCredentialshodnotu .
Jakákoli jiná hodnota než DefaultCredentials nebo null	true nebo false	Nastavení UseDefaultCredentials vyvolá výjimku.

Pokud UseDefaultCredentials je false, můžete vlastnost změnit Credentials na libovolné přihlašovací údaje. Pokud UseDefaultCredentials je true, změna Credentials vlastnosti z DefaultCredentials (hodnota, která je nastavena, když UseDefaultCredentials je vlastnost nastavena na true) vyvolá výjimku.