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 символов.

Примеры

В следующем примере кода показан элемент членства в system.web разделе файла Web.config для приложения ASP.NET. Он задает экземпляр приложения 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 можно задать программным способом или декларативно в файле конфигурации веб-приложения с атрибутом applicationName .

Если значение атрибута applicationName не указано в файле конфигурации веб-приложения, используется ApplicationPath значение свойства для первого запроса, выполненного к приложению.

Внимание!

Так как для всех запросов, обслуживаемых HttpApplication объектом, используется один экземпляр поставщика членства по умолчанию, можно одновременно выполнять несколько запросов и пытаться задать ApplicationName значение свойства. Свойство ApplicationName не является потокобезопасным для нескольких операций записи, и изменение ApplicationName значения свойства может привести к непредвиденному поведению для нескольких пользователей приложения. Рекомендуется избегать написания кода, чтобы разрешить пользователям задавать ApplicationName свойство, если это не требуется. Примером приложения, в котором может потребоваться задание ApplicationName свойства, является административное приложение, которое управляет данными членства для нескольких приложений. Такое приложение должно быть однопользовательским, а не веб-приложением.

Применяется к

См. также раздел