SectionInformation.RequirePermission Свойство

Определение

Пространство имен:

System.Configuration

Сборка:

System.Configuration.ConfigurationManager.dll

Пакет:

System.Configuration.ConfigurationManager v8.0.0

Исходный код:

SectionInformation.cs

Возвращает значение, указывающее, требует ли связанный раздел конфигурации прав доступа.

public:
 property bool RequirePermission { bool get(); void set(bool value); };

public bool RequirePermission { get; set; }

member this.RequirePermission : bool with get, set

Public Property RequirePermission As Boolean

Значение свойства

Boolean

Значение true, если атрибут requirePermission имеет значение true; в противном случае — значение false. Значение по умолчанию — true.

Исключения

ConfigurationErrorsException

Выбранное значение противоречит значению, которое уже было определено.

Примеры

В следующем примере показаны два возможных уровня доверия для веб-приложения, RequirePermission если свойство appSettings раздела имеет значение true.

<system.web>
   // With the following trust value
   // the code below works.
  <trust level="Full" />
</system.web>

<system.web>
  // With the following trust value
  // the code below does not work.
  <trust level="Medium" />
</system.web>

В следующем примере показан код, который выполняется без ошибок, когда для уровня доверия задано значение "Полный". В противном случае код приведет к ошибке.

AppSettingsSection apSection =
  ConfigurationManager.GetSection("appSettings") as AppSettingsSection;

NameValueCollection apSectionCollection =
  ConfigurationManager.AppSettings;

Dim apSection As AppSettingsSection = _
  TryCast(ConfigurationManager.GetSection("appSettings"),
    AppSettingsSection)

  Dim apSectionCollection As NameValueCollection = _
    ConfigurationManager.AppSettings

Комментарии

Если RequirePermission задано значение true, GetSection методы ограничиваются параметром уровня доверия приложения. Это означает, что методы или свойства, разрешающие доступ к обработчикам разделов конфигурации, ограничены уровнем доверия, установленным для веб-приложения.

Примечание

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

Если RequirePermission задано значение false, доступ к данным конфигурации не ограничивается параметрами уровня доверия приложения.

Примечание

Соответствующие разрешения ACL файла (контроль доступа List) по-прежнему RequirePermission требуются независимо от параметра. Разрешения ACL определяют, кто может получить доступ к файлу конфигурации.