SectionInformation.RequirePermission Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.