Udostępnij za pośrednictwem

SqlMembershipProvider.ApplicationName Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.Security
Zestaw:
System.Web.dll

Pobiera lub ustawia nazwę aplikacji do przechowywania i pobierania informacji o członkostwie.

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

Wartość właściwości

String

Nazwa aplikacji do przechowywania i pobierania informacji o członkostwie. Wartość domyślna ApplicationPath to wartość właściwości bieżącego Requestelementu .

Wyjątki

ArgumentException

Podjęto próbę ApplicationName ustawienia właściwości na pusty ciąg lub null.

ProviderException

Podjęto próbę ustawienia ApplicationName właściwości na ciąg dłuższy niż 256 znaków.

Przykłady

Poniższy przykład kodu przedstawia element członkostwa w system.web sekcji pliku Web.config dla aplikacji ASP.NET. Określa wystąpienie aplikacji SqlMembershipProvider i ustawia wartość 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>

Uwagi

Element ApplicationName jest używany przez grupowanie informacji o użytkowniku SqlMembershipProvider . Kwalifikując informacje o użytkowniku z nazwą aplikacji, można przechowywać informacje dla wielu aplikacji w jednej bazie danych bez wystąpienia konfliktów między zduplikowanymi nazwami użytkowników. Ponadto wiele aplikacji ASP.NET może używać tej samej bazy danych użytkowników, określając tę samą wartość we ApplicationName właściwości. Właściwość ApplicationName można ustawić programowo lub można ją deklaratywnie ustawić w pliku konfiguracji aplikacji internetowej za pomocą atrybutu applicationName .

Jeśli wartość nie zostanie określona dla atrybutu applicationName w pliku konfiguracji aplikacji internetowej, ApplicationPath zostanie użyta wartość właściwości dla pierwszego żądania złożonego do aplikacji.

Przestroga

Ponieważ pojedyncze domyślne wystąpienie dostawcy członkostwa jest używane dla wszystkich żądań obsługiwanych przez HttpApplication obiekt, można mieć wiele żądań wykonywanych jednocześnie i próbować ustawić ApplicationName wartość właściwości. Właściwość ApplicationName nie jest bezpieczna wątkiem dla wielu zapisów, a zmiana ApplicationName wartości właściwości może spowodować nieoczekiwane zachowanie wielu użytkowników aplikacji. Zalecamy unikanie pisania kodu, aby umożliwić użytkownikom ustawianie ApplicationName właściwości, chyba że musisz. Przykładem aplikacji, w której może być wymagane ustawienie ApplicationName właściwości, jest aplikacja administracyjna, która zarządza danymi członkostwa dla wielu aplikacji. Taka aplikacja powinna być aplikacją pojedynczego użytkownika, a nie aplikacją internetową.

Dotyczy

Zobacz też