Roles.ApplicationName Vlastnost

Definice

Obor názvů:

System.Web.Security

Sestavení:

System.Web.dll

Získá nebo nastaví název aplikace pro ukládání a načítání informací o rolích.

public:
 static property System::String ^ ApplicationName { System::String ^ get(); void set(System::String ^ value); };

public static string ApplicationName { get; set; }

member this.ApplicationName : string with get, set

Public Shared Property ApplicationName As String

Hodnota vlastnosti

String

Název aplikace pro ukládání a načítání informací o rolích.

Příklady

Následující příklad ukazuje prvek roleManager v system.web části souboru Web.config pro ASP.NET aplikaci. Určuje, že aplikace používá SqlRoleProvider instanci a nastaví applicationName atribut na MyApplication.

<roleManager defaultProvider="SqlProvider"
  enabled="true"
  cacheRolesInCookie="true"
  cookieName=".ASPROLES"
  cookieTimeout="30"
  cookiePath="/"
  cookieRequireSSL="false"
  cookieSlidingExpiration="true"
  cookieProtection="All" >
  <providers>
    <add
      name="SqlProvider"
      type="System.Web.Security.SqlRoleProvider"
      connectionStringName="SqlServices"
      applicationName="MyApplication" />
  </providers>
</roleManager>

Poznámky

Vlastnost ApplicationName používá Roles třída k přidružení uživatelů a rolí k různým aplikacím. To umožňuje více aplikacím používat stejný zdroj dat k ukládání informací o uživatelích a rolích, aniž by došlo ke konfliktům mezi duplicitními uživatelskými jmény nebo duplicitními názvy rolí. Více ASP.NET aplikací může použít stejný zdroj dat zadáním stejné hodnoty ve ApplicationName vlastnosti. Vlastnost můžete nastavit ApplicationName programově nebo ji můžete deklarativním způsobem nastavit v konfiguračním souboru webové aplikace pomocí atributu applicationName .

Pokud vaše webová aplikace používá SqlRoleProvider třídu a hodnota není určena pro applicationName atribut v konfiguračním souboru, HttpRequest.ApplicationPath použije se hodnota vlastnosti aktuální HttpContext.Request vlastnosti.

Upozornění

Vzhledem k tomu, že pro všechny požadavky obsluhované objektem HttpApplication se používá jedna výchozí instance zprostředkovatele role, můžete mít více žádostí, které se souběžně spouští a pokoušíte se nastavit ApplicationName hodnotu vlastnosti. Vlastnost ApplicationName není bezpečná pro více zápisů a změna ApplicationName hodnoty vlastnosti může vést k neočekávanému chování více uživatelů aplikace. Pokud to není nutné, měli byste se vyhnout psaní kódu, abyste uživatelům umožnili nastavit ApplicationName vlastnost. Příkladem aplikace, kde nastavení ApplicationName vlastnosti může být vyžadováno, je aplikace pro správu, která spravuje data rolí pro více aplikací. Taková aplikace by měla být aplikace s jedním uživatelem, nikoli webová aplikace.

Viz také

• Principy správy rolí ASP.NET