Share via

SqlRoleProvider.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.

Исключения

HttpException

Была предпринята попытка установить свойство ApplicationName вызывающим объектом, который не имеет разрешения High среды ASP.NET.

ProviderException

Была предпринята попытка задать свойству ApplicationName значение строки, длина которой более 256 символов.

Примеры

В следующем примере показан roleManager элемент в system.web разделе файла Web.config для приложения ASP.NET. Он задает экземпляр приложения SqlRoleProvider и задает ApplicationName для свойства значение MyApplication.

<roleManager defaultProvider="SqlProvider"
  enabled="true"
  cacheRolesInCookie="true"
  cookieName=".ASPROLES"
  cookieTimeout="30"
  cookiePath="/"
  cookieRequireSSL="false"
  cookieSlidingExpiration="true"
  cookieProtection="All" >
  <providers>
    <add
      name="SqlProvider"
      type="System.Web.Security.SqlRoleProvider"
      connectionStringName="SqlServices"
      applicationName="MyApplication" />
  </providers>
</roleManager>

Комментарии

Используется ApplicationName для SqlRoleProvider связывания пользователей и ролей с разными приложениями. Это позволяет нескольким приложениям использовать одну базу данных для хранения сведений о пользователях и роях без конфликтов между повторяющимися именами пользователей или именами ролей. Несколько ASP.NET приложений могут использовать одну базу данных, указав одно и то же значение в свойстве ApplicationName . Свойство ApplicationName можно задать программным способом или декларативно задать в файле конфигурации для веб-приложения с помощью атрибута applicationName .

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

Внимание!

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

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

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