SectionInformation.RequirePermission Egenskap

Definition

Hämtar ett värde som anger om det associerade konfigurationsavsnittet kräver åtkomstbehörigheter.

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

Egenskapsvärde

true requirePermission om attributet är inställt på true; annars . false Standardvärdet är true.

Undantag

Det valda värdet står i konflikt med ett värde som redan har definierats.

Exempel

I följande exempel visas två möjliga förtroendenivåer för ett webbprogram när RequirePermission egenskapen för appSettings avsnittet är 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>

I följande exempel visas kod som körs utan fel när förtroendenivån är inställd på full. Annars resulterar koden i ett fel.

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

Kommentarer

När RequirePermission är inställt på trueGetSection begränsas metoderna av programmets inställning för förtroendenivå. Det innebär att metoder eller egenskaper som tillåter åtkomst till konfigurationsavsnittshanterare begränsas av den förtroendenivå som angetts för webbprogrammet.

Note

Eftersom högt och fullständigt förtroende är de enda nivåer som tillåter åtkomst till filer utanför den aktuella programdomänen kan ett program endast använda konfigurationsavsnittshanterare på dessa förtroendenivåer.

När RequirePermission är inställt på falsebegränsas inte åtkomsten till konfigurationsdata av programmets inställningar för förtroendenivå.

Note

Lämpliga ACL-behörigheter (Access Control List) krävs fortfarande, oavsett inställningen RequirePermission. ACL-behörigheter avgör vem som kan komma åt konfigurationsfilen.

Gäller för