SqlMembershipProvider.ApplicationName 屬性

定義

命名空間:

System.Web.Security

組件:

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

要存放及擷取成員資格資訊的應用程式名稱。 預設為目前 ApplicationPath 的 Request 屬性值。

例外狀況

ArgumentException

嘗試將 ApplicationName 屬性設為空字串或 null。

ProviderException

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

範例

下列程式代碼範例顯示 ASP.NET 應用程式 Web.config 檔案區段中 的成員資格 專案 system.web 。 它會指定應用程式的實體， SqlMembershipProvider 並將 設定 ApplicationName 為 MyApplication。

<membership defaultProvider="SqlProvider" userIsOnlineTimeWindow="20">  
  <providers>  
    <add name="SqlProvider"  
      type="System.Web.Security.SqlMembershipProvider"  
      connectionStringName="SqlServices"  
      enablePasswordRetrieval="true"  
      enablePasswordReset="false"  
      requiresQuestionAndAnswer="true"  
      passwordFormat="Encrypted"  
      applicationName="MyApplication" />  
  </providers>  
</membership>  

備註

ApplicationName由 SqlMembershipProvider 用來將使用者資訊分組。 藉由使用應用程式名稱來限定使用者資訊，您可以將多個應用程式的資訊儲存在單一資料庫中，而不會在重複的使用者名稱之間發生衝突。 此外，多個 ASP.NET 應用程式可以在屬性中 ApplicationName 指定相同的值，以使用相同的用戶資料庫。 ApplicationName屬性可以透過程式設計方式設定，也可以以宣告方式在 Web 應用程式的applicationName組態檔中使用 屬性進行設定。

如果未為 applicationName Web 應用程式組態檔中的 屬性指定值，則會 ApplicationPath 使用對應用程式提出的第一個要求屬性值。

警告

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

另請參閱

• ASP.NET 成員資格簡介