SectionInformation.RequirePermission Propriedade

Definição

Recebe um valor que indica se a secçã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 de Propriedade

true se o requirePermission atributo for definido como true; caso contrário, false. A predefinição é true.

Exceções

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

Exemplos

O exemplo seguinte mostra dois possíveis níveis de confiança para uma aplicação Web quando a RequirePermission propriedade da appSettings secçã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 seguinte mostra código que corre sem erros quando o nível de confiança está definido para cheio. Caso contrário, o código resulta num 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

Observações

Quando RequirePermission está definido para true, os GetSection métodos são restringidos pela definição de nível de confiança da aplicação. Isto significa que os métodos ou propriedades que permitem o acesso a manipuladores de secções de configuração são restringidos pelo nível de confiança definido para a aplicação Web.

Note

Como a confiança elevada e total são os únicos níveis que permitem o acesso a ficheiros fora do domínio da aplicação atual, uma aplicação só pode usar manipuladores de secção de configuração nesses níveis de confiança.

Quando RequirePermission está definido para false, o acesso aos dados de configuração não é restringido pelas definições de nível de confiança da aplicação.

Note

As permissões ACL (Controlo de Acesso List) apropriadas do ficheiro continuam a ser necessárias, independentemente da definição RequirePermission. As permissões ACL determinam quem pode aceder ao ficheiro de configuração.

Aplica-se a