SqlMembershipProvider.ApplicationName Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.Security
Assembly:
System.Web.dll

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

String

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

ArgumentException

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

ProviderException

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

Beispiele

Das folgende Codebeispiel zeigt das Membership-Element im system.web Abschnitt der Web.config-Datei für eine ASP.NET-Anwendung. Es gibt die Instanz der SqlMembershipProvider Anwendung 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

Wird ApplicationName von verwendet, SqlMembershipProvider um Benutzerinformationen zu gruppieren. Indem 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 applicationName Konfigurationsdatei für die Webanwendung kein Wert angegeben ist, wird der ApplicationPath Eigenschaftswert für die erste Anforderung verwendet, die an die Anwendung gestellt wurde.

Achtung

Da eine einzelne Standardmitgliedschaftsanbieterinstanz für alle Anforderungen verwendet wird, die von einem HttpApplication Objekt verarbeitet 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 erforderlich sein kann, 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