SqlMembershipProvider.ApplicationName Eigenschaft

Definition

Ruft den Namen der Anwendung ab, für die Mitgliedschaftsinformationen gespeichert und abgerufen werden sollen, oder legt diesen fest.

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

Eigenschaftswert

Der Name der Anwendung, für die Mitgliedschaftsinformationen gespeichert und abgerufen werden sollen. Der ApplicationPath-Eigenschaftswert ist der Standardwert für die aktuelle Request.

Ausnahmen

Es wurde versucht, die ApplicationName-Eigenschaft auf eine leere Zeichenfolge oder null festzulegen.

Es wurde versucht, die ApplicationName-Eigenschaft auf eine Zeichenfolge festzulegen, die länger als 256 Zeichen ist.

Beispiele

Das folgende Codebeispiel zeigt das Mitgliedschaftselement im system.web Abschnitt der Web.config-Datei für eine ASP.NET-Anwendung. Es gibt die Instanz der Anwendung SqlMembershipProvider an und legt den ApplicationName auf fest 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>  

Hinweise

Der ApplicationName wird vom zum Gruppieren von SqlMembershipProvider Benutzerinformationen verwendet. Wenn Sie Benutzerinformationen mit einem Anwendungsnamen qualifizieren, können Sie Informationen für mehrere Anwendungen in einer einzelnen Datenbank speichern, ohne dass Konflikte zwischen doppelten Benutzernamen auftreten. Außerdem können mehrere ASP.NET Anwendungen dieselbe Benutzerdatenbank verwenden, indem sie denselben Wert in der ApplicationName -Eigenschaft angeben. Die ApplicationName Eigenschaft kann programmgesteuert oder deklarativ in der Konfigurationsdatei für die Webanwendung mit dem applicationName -Attribut festgelegt werden.

Wenn für das Attribut in der Konfigurationsdatei für die applicationName Webanwendung kein Wert angegeben wird, wird der ApplicationPath Eigenschaftswert für die erste Anforderung an die Anwendung verwendet.

Achtung

Da eine einzelne Standardmitgliedschaftsanbieterinstanz für alle Anforderungen verwendet wird, die von einem HttpApplication Objekt bereitgestellt werden, können mehrere Anforderungen gleichzeitig ausgeführt werden und versuchen, den ApplicationName Eigenschaftswert festzulegen. Die ApplicationName Eigenschaft ist für mehrere Schreibvorgänge nicht threadsicher, und das Ändern des ApplicationName Eigenschaftswerts kann zu unerwartetem Verhalten für mehrere Benutzer einer Anwendung führen. Es wird empfohlen, das Schreiben von Code zu vermeiden, damit Benutzer die ApplicationName Eigenschaft festlegen können, sofern dies nicht erforderlich ist. Ein Beispiel für eine Anwendung, bei der das Festlegen der ApplicationName Eigenschaft möglicherweise erforderlich ist, ist eine administrative Anwendung, die Mitgliedschaftsdaten für mehrere Anwendungen verwaltet. Eine solche Anwendung sollte eine Einzelbenutzeranwendung und keine Webanwendung sein.

Gilt für:

Weitere Informationen