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隨附的設定檔提供者會針對 ASP.NET 應用程式使用 ApplicationVirtualPath 屬性值。 對於 non-ASP.NET 應用程式，預設值是 ModuleName 屬性值，不含副檔名。

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

警告

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

另請參閱

• ASP.NET 配置檔案屬性概觀