SectionInformation.RequirePermission Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setPublic Property RequirePermission As BooleanEigenschaftswert
true, wenn das requirePermission-Attribut auf true festgelegt ist, andernfalls false. Der Standardwert ist true.
Ausnahmen
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.
