SectionInformation.RequirePermission Propriedade

Definição

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacote:

System.Configuration.ConfigurationManager v8.0.0

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 for definido como true; caso contrário, false. O padrão é true.

Exceções

ConfigurationErrorsException

Os conflitos de valor selecionados 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 que é 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 truecomo , 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 falsecomo , 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 apropriadas de ACL de arquivo (lista 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.