SectionInformation.RequirePermission Eigenschaft

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Quelle:

SectionInformation.cs

Ruft einen Wert ab, der angibt, ob für den zugeordneten Konfigurationsabschnitt Zugriffsberechtigungen erforderlich sind.

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

Eigenschaftswert

Boolean

true, wenn das requirePermission-Attribut auf true festgelegt ist, andernfalls false. Der Standardwert ist true.

Ausnahmen

ConfigurationErrorsException

Der ausgewählte Wert steht in Konflikt mit einem bereits definierten Wert.

Beispiele

Das folgende Beispiel zeigt zwei mögliche Vertrauensebenen für eine Webanwendung, wenn die RequirePermission -Eigenschaft des appSettings Abschnitts lautet 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>

Das folgende Beispiel zeigt Code, der ohne Fehler ausgeführt wird, wenn die Vertrauensebene auf full festgelegt ist. Andernfalls führt der Code zu einem Fehler.

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

Hinweise

Wenn RequirePermission auf truefestgelegt ist, werden die GetSection Methoden durch die Einstellung der Vertrauensstufe der Anwendung eingeschränkt. Dies bedeutet, dass Methoden oder Eigenschaften, die den Zugriff auf Konfigurationsabschnittshandler zulassen, durch die für die Webanwendung festgelegte Vertrauensebene eingeschränkt werden.

Hinweis

Da hohe und volle Vertrauenswürdigkeiten die einzigen Ebenen sind, die den Zugriff auf Dateien außerhalb der aktuellen Anwendungsdomäne ermöglichen, kann eine Anwendung Konfigurationsabschnittshandler nur auf diesen Vertrauensebenen verwenden.

Wenn RequirePermission auf falsefestgelegt ist, wird der Zugriff auf die Konfigurationsdaten nicht durch die Einstellungen der Vertrauensstellung der Anwendung eingeschränkt.

Hinweis

Die entsprechenden Datei-ACL-Berechtigungen (Access Control List) sind unabhängig von der RequirePermission Einstellung weiterhin erforderlich. ACL-Berechtigungen bestimmen, wer auf die Konfigurationsdatei zugreifen kann.