SectionInformation.RequirePermission Właściwość

Definicja

Przestrzeń nazw:

System.Configuration

Zestaw:

System.Configuration.ConfigurationManager.dll

Pakiet:

System.Configuration.ConfigurationManager v8.0.0

Źródło:

SectionInformation.cs

Pobiera wartość wskazującą, czy skojarzona sekcja konfiguracji wymaga uprawnień dostępu.

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

Wartość właściwości

Boolean

truerequirePermission jeśli atrybut jest ustawiony na true; w przeciwnym razie , false. Wartość domyślna to true.

Wyjątki

ConfigurationErrorsException

Wybrana wartość powoduje konflikt z już zdefiniowaną wartością.

Przykłady

W poniższym przykładzie przedstawiono dwa możliwe poziomy zaufania dla aplikacji internetowej, gdy RequirePermission właściwość appSettings sekcji to 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>

W poniższym przykładzie pokazano kod, który jest uruchamiany bez błędów, gdy poziom zaufania jest ustawiony na pełny. W przeciwnym razie kod powoduje błąd.

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

Uwagi

Gdy RequirePermission jest ustawiona wartość true, GetSection metody są ograniczone przez ustawienie poziomu zaufania aplikacji. Oznacza to, że metody lub właściwości zezwalające na dostęp do procedur obsługi sekcji konfiguracji są ograniczone przez poziom zaufania ustawiony dla aplikacji sieci Web.

Uwaga

Ponieważ wysokie i pełne zaufanie to jedyne poziomy zezwalające na dostęp do plików spoza bieżącej domeny aplikacji, aplikacja może używać procedur obsługi sekcji konfiguracji tylko na tych poziomach zaufania.

Gdy RequirePermission jest ustawiona wartość false, dostęp do danych konfiguracji nie jest ograniczony przez ustawienia poziomu zaufania aplikacji.

Uwaga

Odpowiednie uprawnienia listy ACL plików (Access Control List) są nadal wymagane niezależnie od RequirePermission ustawienia. Uprawnienia listy ACL określają, kto może uzyskać dostęp do pliku konfiguracji.