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 jsou použity 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

Nastavte tuto vlastnost na hodnotu true , pokud mají být požadavky provedené tímto WebProxy objektem (pokud jsou požadovány serverem) ověřeny pomocí přihlašovacích údajů aktuálně přihlášeného uživatele. U klientských aplikací jde ve většině scénářů o požadované chování. U aplikací střední vrstvy, jako jsou aplikace ASP.NET, byste místo této vlastnosti obvykle nastavili Credentials vlastnost na přihlašovací údaje klienta, jehož jménem je žádost podána.

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, při změně Credentials vlastnosti z DefaultCredentials (hodnoty, která je nastavená při UseDefaultCredentials nastavení vlastnosti na ) dojde k truevýjimce.