SqlPersonalizationProvider.ApplicationName 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定應用程式的名稱,以儲存和擷取個人化資訊。
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
屬性值
要儲存和擷取個人化資訊的應用程式的名稱。 預設為目前 ApplicationVirtualPath 的 Request 屬性值。
例外狀況
已將屬性設為長度大於 256 個字元的字串。
備註
類別 ApplicationName 會使用 SqlPersonalizationProvider 屬性來群組使用者資訊。 藉由使用應用程式名稱來限定使用者資訊,您可以將多個應用程式的資訊儲存在單一資料庫中,而不會在重複的使用者名稱之間發生衝突。 此外,多個 ASP.NET 應用程式可以在 屬性中 ApplicationName 指定相同的值,以使用相同的使用者資料庫。
ApplicationName屬性可以透過程式設計方式設定,也可以使用 區段中的 屬性,以宣告方式在 Web 應用程式的 applicationName
組態檔中 <providers>
設定。
如果未為 applicationName
Web 應用程式組態檔中的 屬性指定值,則會 ApplicationVirtualPath 使用對應用程式提出的第一個要求屬性值。
警告
因為單一預設個人化提供者實例會用於物件提供 HttpApplication 的所有要求,所以您可以同時執行多個要求,並嘗試設定 ApplicationName 屬性值。 屬性 ApplicationName 對於多個寫入而言不是安全線程,而且變更 ApplicationName 屬性值可能會導致應用程式多個使用者發生非預期的行為。 建議您避免程式碼允許使用者設定 屬性, ApplicationName 除非必要。 可能需要設定 ApplicationName 屬性的應用程式範例是管理多個應用程式的個人化資料的系統管理應用程式。 這類應用程式應該是單一使用者應用程式,而不是 Web 應用程式。