SqlPersonalizationProvider.ApplicationName 屬性

定義

命名空間:

System.Web.UI.WebControls.WebParts

組件:

System.Web.dll

取得或設定應用程式的名稱，以儲存和擷取個人化資訊。

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

屬性值

String

要儲存和擷取個人化資訊的應用程式的名稱。 預設為目前 ApplicationVirtualPath 的 Request 屬性值。

例外狀況

ProviderException

已將屬性設為長度大於 256 個字元的字串。

備註

類別 ApplicationName 會使用 SqlPersonalizationProvider 屬性來群組使用者資訊。 藉由使用應用程式名稱來限定使用者資訊，您可以將多個應用程式的資訊儲存在單一資料庫中，而不會在重複的使用者名稱之間發生衝突。 此外，多個 ASP.NET 應用程式可以在 屬性中 ApplicationName 指定相同的值，以使用相同的使用者資料庫。 ApplicationName屬性可以透過程式設計方式設定，也可以使用 區段中的 屬性，以宣告方式在 Web 應用程式的 applicationName 組態檔中 <providers> 設定。

如果未為 applicationName Web 應用程式組態檔中的 屬性指定值，則會 ApplicationVirtualPath 使用對應用程式提出的第一個要求屬性值。

警告

因為單一預設個人化提供者實例會用於物件提供 HttpApplication 的所有要求，所以您可以同時執行多個要求，並嘗試設定 ApplicationName 屬性值。 屬性 ApplicationName 對於多個寫入而言不是安全線程，而且變更 ApplicationName 屬性值可能會導致應用程式多個使用者發生非預期的行為。 建議您避免程式碼允許使用者設定 屬性， ApplicationName 除非必要。 可能需要設定 ApplicationName 屬性的應用程式範例是管理多個應用程式的個人化資料的系統管理應用程式。 這類應用程式應該是單一使用者應用程式，而不是 Web 應用程式。