SqlProfileProvider.ApplicationName 屬性

定義

命名空間:

System.Web.Profile

組件:

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 。

例外狀況

HttpException

有一位沒有High主機授權的來電者嘗試設定該 ApplicationName ASP.NET。

ProviderException

嘗試將屬性設定 ApplicationName 為超過 256 字元的字串。

範例

以下程式碼範例顯示 ASP.NET 應用程式 Web.config system.web 檔案區段中的元素profile。 它指定應用程式的實例， SqlProfileProvider 並將屬性值設 ApplicationName 為 MyApplication。

<profile defaultProvider="SqlProvider">
  <providers>
    <add name="SqlProvider"
      type="System.Web.Profile.SqlProfileProvider"
      connectionStringName="SqlServices"
      applicationName="MyApplication" />
   </providers>
</profile>

備註

ApplicationName該屬性被用SqlProfileProvider來將個人資料資訊與不同的應用程式關聯起來。 這使得多個應用程式能使用同一個資料庫來儲存使用者資訊，而不會發生重複使用者間的衝突。 多個 ASP.NET 應用程式可以透過屬性中指定相同的值 ApplicationName 來使用同一個使用者資料庫。 此 ApplicationName 屬性可透過程式設定，或在網頁應用程式的設定檔中使用 applicationName 屬性以宣告式設定。

如果在網頁應用程式的設定檔中未指定 applicationName 該屬性的值，則 ApplicationVirtualPath 該值將用於 ASP.NET 應用程式。 對於 non-ASP.NET 應用程式，預設值為不含副檔名的 ModuleName 值。

謹慎

由於一個預設的設定提供者實例會用於一個物件所服務 HttpApplication 的所有請求，因此你可以同時執行多個請求並嘗試設定 ApplicationName 屬性值。 該 ApplicationName 屬性對多次寫入不安全，且更改 ApplicationName 屬性值可能導致多個應用程式使用者出現意外行為。 建議除非必要，否則避免撰寫允許使用者設定 ApplicationName 屬性的程式碼。 一個可能需要設定屬性 ApplicationName 的應用程式範例是管理多個應用程式的設定檔資料的管理應用程式。 此類應用程式應為單一使用者應用程式，而非網頁應用程式。

另請參閱

• ASP.NET 物業概覽