SectionInformation.RequirePermission Propriété

Définition

Espace de noms:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paquet:

System.Configuration.ConfigurationManager v8.0.0

Source:

SectionInformation.cs

Obtient une valeur qui indique si la section de configuration associée requiert des autorisations d'accès.

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

Valeur de propriété

Boolean

true si l'attribut requirePermission a la valeur true ; sinon, false. La valeur par défaut est true.

Exceptions

ConfigurationErrorsException

La valeur sélectionnée est en conflit avec une valeur déjà définie.

Exemples

L’exemple suivant montre deux niveaux de confiance possibles pour une application web lorsque la RequirePermission propriété de la appSettings section est 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>

L’exemple suivant montre du code qui s’exécute sans erreurs lorsque le niveau de confiance est défini sur full. Sinon, le code génère une erreur.

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

Remarques

Lorsque RequirePermission a la truevaleur , les GetSection méthodes sont limitées par le paramètre de niveau de confiance de l’application. Cela signifie que les méthodes ou propriétés qui autorisent l’accès aux gestionnaires de section de configuration sont limitées par le niveau de confiance défini pour l’application web.

Notes

Étant donné que la confiance élevée et la confiance totale sont les seuls niveaux qui autorisent l’accès aux fichiers en dehors du domaine d’application actuel, une application peut utiliser des gestionnaires de section de configuration uniquement à ces niveaux de confiance.

Lorsque RequirePermission a la falsevaleur , l’accès aux données de configuration n’est pas limité par les paramètres de niveau de confiance de l’application.

Notes

Les autorisations de liste de contrôle d’accès de fichier (Access Control List) appropriées sont toujours requises, quel que soit le RequirePermission paramètre. Les autorisations ACL déterminent qui peut accéder au fichier de configuration.