Sdílet prostřednictvím

SqlMembershipProvider.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 členství pro.

public:
 virtual property System::String ^ ApplicationName { System::String ^ get(); void set(System::String ^ value); };
public override string ApplicationName { get; set; }
member this.ApplicationName : string with get, set
Public Overrides Property ApplicationName As String

Hodnota vlastnosti

String

Název aplikace pro ukládání a načítání informací o členství. Výchozí hodnota je ApplicationPath hodnota vlastnosti pro aktuální Request.

Výjimky

ArgumentException

Došlo k pokusu ApplicationName o nastavení vlastnosti na prázdný řetězec nebo null.

ProviderException

Došlo k pokusu ApplicationName o nastavení vlastnosti na řetězec, který je delší než 256 znaků.

Příklady

Následující příklad kódu ukazuje prvek členství v system.web části souboru Web.config pro ASP.NET aplikace. Určuje instanci aplikace SqlMembershipProvider a nastaví ApplicationName na MyApplication.

<membership defaultProvider="SqlProvider" userIsOnlineTimeWindow="20">
  <providers>
    <add name="SqlProvider"
      type="System.Web.Security.SqlMembershipProvider"
      connectionStringName="SqlServices"
      enablePasswordRetrieval="true"
      enablePasswordReset="false"
      requiresQuestionAndAnswer="true"
      passwordFormat="Encrypted"
      applicationName="MyApplication" />
  </providers>
</membership>

Poznámky

SqlMembershipProvider Slouží ApplicationName k seskupení informací o uživateli. Opravňující informace o uživatelích s názvem aplikace můžete ukládat informace pro více aplikací v jedné databázi, aniž by došlo ke konfliktům mezi duplicitními uživatelskými jmény. Kromě toho může více ASP.NET aplikací používat stejnou uživatelskou databázi zadáním stejné hodnoty ve ApplicationName vlastnosti. ApplicationName Vlastnost lze nastavit programově nebo ji lze nastavit deklarativní v konfiguračním souboru webové aplikace s atributemapplicationName.

Pokud pro atribut v konfiguračním souboru webové aplikace není zadána applicationName hodnota, ApplicationPath použije se hodnota vlastnosti prvního požadavku provedeného v aplikaci.

Upozornění

Vzhledem k tomu, že se pro všechny požadavky obsluhované objektem HttpApplication používá jedna výchozí instance zprostředkovatele členství, můžete mít spuštěných více požadavků současně a pokoušet se nastavit ApplicationName hodnotu vlastnosti. Vlastnost ApplicationName není bezpečná pro více zápisů z více vláken a změna ApplicationName hodnoty vlastnosti může vést k neočekávanému chování více uživatelů aplikace. Doporučujeme, abyste se vyhnuli psaní kódu, abyste uživatelům umožnili nastavit ApplicationName vlastnost, pokud to není nutné. Příkladem aplikace, ve které může být požadováno nastavení ApplicationName vlastnosti, je aplikace pro správu, která spravuje data členství pro více aplikací. Taková aplikace by měla být jednouživatelovou aplikací, nikoli webovou aplikací.

Platí pro

Viz také