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

不具 ApplicationName ASP.NET 裝載使用權限的呼叫端嘗試設定 High 屬性。

ProviderException

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

範例

下列程式代碼範例顯示 profile ASP.NET 應用程式 Web.config 檔案區段中的 元素 system.web 。 它會指定應用程式的 實體， 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屬性可以透過程式設計方式設定，也可以使用 屬性，在 Web 應用程式的applicationName組態檔中以宣告方式設定屬性。

如果未為 applicationName Web 應用程式的組態檔中的 屬性指定值，則 ApplicationVirtualPath 值會用於 ASP.NET 應用程式。 對於 non-ASP.NET 應用程式，預設值是 ModuleName 不含擴展名的值。

警告

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

另請參閱

• ASP.NET 設定檔屬性概觀