ProfileManager.ApplicationName 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定應用程式名稱,以儲存及檢索個人資料。
public:
static property System::String ^ ApplicationName { System::String ^ get(); void set(System::String ^ value); };
public static string ApplicationName { get; set; }
static member ApplicationName : string with get, set
Public Shared Property ApplicationName As String
屬性值
用於儲存及檢索個人資料的應用程式名稱。
範例
以下設定檔摘錄展示了 Web.config 檔案中 system.web 部分的設定檔元素,適用於一個 ASP.NET 應用程式。 它會將應用程式的預設設定檔提供者設為實 SqlProfileProvider 例,並將 設定 ApplicationName 為 MyApplication。
<profile enabled="true" defaultProvider="SqlProvider">
<providers>
<add name="SqlProvider"
type="System.Web.Profile.SqlProfileProvider"
connectionStringName="SqlServices"
applicationName="MyApplication" />
</providers>
</profile>
備註
他們 ProfileManager 利用該 ApplicationName 特性將個人資料資訊與不同的應用程式關聯起來。 這使得多個應用程式能使用同一個資料庫來儲存使用者資訊,而不會發生重複使用者間的衝突。 多個 ASP.NET 應用程式可以透過屬性中指定相同的值 ApplicationName 來使用同一個使用者資料庫。 此 ApplicationName 屬性可透過程式設定,或在網頁應用程式 applicationName 的設定檔中透過屬性宣告式設定。
若網頁應用程式的設定檔中未指定 applicationName 屬性值,則 .NET Framework 內建的設定檔提供者會將該屬性值用於 ApplicationVirtualPath ASP.NET 應用程式。 對於 non-ASP.NET 應用程式,預設值為 ModuleName 屬性值,不含副檔名。
該 ApplicationName 屬性會 SettingsProvider.ApplicationName 揭露預設設定提供者的屬性。 預設的設定檔提供者是透過defaultProvider設定檔設定元素的屬性來指定。 如果使用者設定檔包含由非預設提供者管理的設定檔提供者所管理的屬性,則可能會設定為不同的應用程式名稱。 若要存取除預設提供者外的設定檔提供者的應用程式名稱,請使用該 Providers 設定檔提供者的屬性取得參考,並直接存取 ApplicationName 該提供者的屬性。
謹慎
由於一個預設的設定提供者實例會用於一個物件所服務 HttpApplication 的所有請求,因此你可以同時執行多個請求並嘗試設定 ApplicationName 屬性值。 該 ApplicationName 屬性對多次寫入不安全,且更改 ApplicationName 屬性值可能導致多個應用程式使用者出現意外行為。 建議除非你必須,否則避免撰寫允許使用者設定屬性 ApplicationName 的程式碼。 一個可能需要設定屬性 ApplicationName 的應用程式範例是管理多個應用程式的設定檔資料的管理應用程式。 此類應用程式應為單一使用者應用程式,而非網頁應用程式。