SqlPersonalizationProvider.ApplicationName Właściwość

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls.WebParts

Zestaw:

System.Web.dll

Pobiera lub ustawia nazwę aplikacji do przechowywania i pobierania informacji o personalizacji.

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 personalizacji. Wartość domyślna ApplicationVirtualPath to wartość właściwości dla bieżącego Requestelementu .

Wyjątki

ProviderException

Właściwość została ustawiona na ciąg o długości większej niż 256 znaków.

Uwagi

Właściwość ApplicationName jest używana przez klasę do grupowania informacji o użytkowniku SqlPersonalizationProvider . Kwalifikując informacje o użytkowniku o nazwie 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żytkownika, określając tę samą wartość we ApplicationName właściwości . Właściwość ApplicationName można ustawić programowo lub można ją ustawić deklaratywnie w pliku konfiguracji aplikacji internetowej przy użyciu atrybutu applicationName<providers> w sekcji .

Jeśli wartość nie zostanie określona dla atrybutu applicationName w pliku konfiguracji aplikacji sieci Web, ApplicationVirtualPath zostanie użyta wartość właściwości dla pierwszego żądania skierowanego do aplikacji.

Ostrzeżenie

Ponieważ pojedyncze domyślne wystąpienie dostawcy personalizacji 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ątkowo dla wielu zapisów, a zmiana ApplicationName wartości właściwości może spowodować nieoczekiwane zachowanie wielu użytkowników aplikacji. Zaleca się unikanie kodu, aby umożliwić użytkownikom ustawienie ApplicationName właściwości, chyba że jest to wymagane. Przykładem aplikacji, w której może być wymagane ustawienie ApplicationName właściwości, jest aplikacja administracyjna, która zarządza danymi personalizacji dla wielu aplikacji. Taka aplikacja powinna być aplikacją pojedynczego użytkownika, a nie aplikacją internetową.