ProfileManager.ApplicationName 屬性

定義

命名空間:

System.Web.Profile

組件:

System.Web.dll

取得或設定應用程式的名稱，以儲存及擷取設定檔資訊。

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

屬性值

String

要儲存及擷取設定檔資訊的應用程式名稱。

範例

下列組態檔摘錄顯示 ASP.NET 應用程式 Web.config 檔案之 system.web 區段中的配置檔專案。 它會將應用程式的預設設定檔提供者設定為 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屬性可以透過程式設計方式設定，也可以使用 屬性，以宣告方式在 Web 應用程式的applicationName組態檔中設定。

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

屬性 ApplicationName 會 SettingsProvider.ApplicationName 公開預設配置檔提供者的 屬性。 預設設定檔提供者是使用defaultProvider設定檔組態項目的 屬性來指定。 如果使用者配置檔包含由預設提供者以外的配置檔提供者所管理的屬性，則可能會使用不同的應用程式名稱進行設定。 若要存取預設提供者以外的配置檔提供者的應用程式名稱，請使用 Providers 屬性取得配置檔提供者的參考，並直接存取 ApplicationName 提供者的屬性。

警告

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

另請參閱

• ASP.NET 設定檔屬性概觀