SectionInformation.RequirePermission Propriedade

Definição

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Origem:

SectionInformation.cs

Obtém um valor que indica se a seção de configuração associada requer permissões de acesso.

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

Valor da propriedade

Boolean

true se o requirePermission atributo estiver definido como true; caso contrário, false. O padrão é true.

Exceções

ConfigurationErrorsException

O valor selecionado entra em conflito com um valor que já está definido.

Exemplos

O exemplo a appSettings seguir mostra dois níveis de confiança possíveis para um aplicativo Web quando a RequirePermission propriedade da seção é 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>

O exemplo a seguir mostra o código executado sem erros quando o nível de confiança é definido como completo. Caso contrário, o código resultará em um erro.

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

Comentários

Quando RequirePermission definido como true, os GetSection métodos são restritos pela configuração de nível de confiança do aplicativo. Isso significa que os métodos ou propriedades que permitem o acesso aos manipuladores de seção de configuração são restritos pelo nível de confiança definido para o aplicativo Web.

Observação

Como a confiança alta e total são os únicos níveis que permitem o acesso a arquivos fora do domínio do aplicativo atual, um aplicativo pode usar manipuladores de seção de configuração apenas nesses níveis de confiança.

Quando RequirePermission definido como false, o acesso aos dados de configuração não é restrito pelas configurações de nível de confiança do aplicativo.

Observação

As permissões de ACL do arquivo apropriado (Lista de Controle de Acesso) ainda são necessárias, independentemente da RequirePermission configuração. As permissões de ACL determinam quem pode acessar o arquivo de configuração.