SqlPersonalizationProvider.ApplicationName Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Ruft den Namen der Anwendung ab, für die Personalisierungsinformationen 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 Personalisierungsinformationen gespeichert und abgerufen werden sollen. Der ApplicationVirtualPath-Eigenschaftswert ist der Standardwert für die aktuelle Request.

Ausnahmen

ProviderException

Für die Eigenschaft wurde eine Zeichenfolge festgelegt, deren Länge 256 Zeichen überschreitet.

Hinweise

Die ApplicationName -Eigenschaft wird von der SqlPersonalizationProvider -Klasse verwendet, 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 mithilfe des applicationName -Attributs <providers> im Abschnitt festgelegt werden.

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

Achtung

Da eine einzelne Standardinstanz des Personalisierungsanbieters 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, 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 Personalisierungsdaten für mehrere Anwendungen verwaltet. Eine solche Anwendung sollte eine Einzelbenutzeranwendung und keine Webanwendung sein.