SectionInformation.RequirePermission Proprietà

Definizione

Spazio dei nomi:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacchetto:

System.Configuration.ConfigurationManager v8.0.0

Source:

SectionInformation.cs

Ottiene un valore che indica se per la sezione di configurazione associata sono necessarie autorizzazioni di accesso.

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

Valore della proprietà

Boolean

true se l'attributo requirePermission è impostato su true; in caso contrario, false. Il valore predefinito è true.

Eccezioni

ConfigurationErrorsException

Il valore selezionato è in conflitto con un valore già definito.

Esempio

L'esempio seguente mostra due possibili livelli di attendibilità per un'applicazione Web quando la RequirePermission proprietà della appSettings sezione è 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>

Nell'esempio seguente viene illustrato il codice che viene eseguito senza errori quando il livello di attendibilità è impostato su completo. In caso contrario, il codice genera un errore.

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

Commenti

Quando RequirePermission è impostato su true, i GetSection metodi sono limitati dall'impostazione del livello di attendibilità dell'applicazione. Ciò significa che i metodi o le proprietà che consentono l'accesso ai gestori di sezioni di configurazione sono limitati dal livello di attendibilità impostato per l'applicazione Web.

Nota

Poiché l'attendibilità elevata e completa sono gli unici livelli che consentono l'accesso ai file all'esterno del dominio applicazione corrente, un'applicazione può usare i gestori della sezione di configurazione solo a questi livelli di attendibilità.

Quando RequirePermission è impostato su false, l'accesso ai dati di configurazione non è limitato dalle impostazioni del livello di attendibilità dell'applicazione.

Nota

Le autorizzazioni ACL di file appropriate (Controllo di accesso Elenco) sono ancora necessarie, indipendentemente dall'impostazioneRequirePermission. Le autorizzazioni ACL determinano chi può accedere al file di configurazione.