SectionInformation.RequirePermission 屬性

定義

命名空間:

System.Configuration

組件:

System.Configuration.ConfigurationManager.dll

套件:

System.Configuration.ConfigurationManager v8.0.0

來源:

SectionInformation.cs

取得值，指出關聯的組態區段是否需要存取權限。

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

屬性值

Boolean

如果 true 屬性設定為 requirePermission，則為 true，否則為 false。 預設為 true。

例外狀況

ConfigurationErrorsException

選取的值與已定義的值發生衝突。

範例

下列範例顯示當 區段的 appSettings 屬性為 true時RequirePermission，Web 應用程式的兩個可能信任層級。

<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>

下列範例顯示當信任層級設定為 full 時，執行時不會發生錯誤的程式代碼。 否則，程式代碼會產生錯誤。

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

備註

當 設定為 true時RequirePermission，GetSection方法會受限於應用程式的信任層級設定。 這表示允許存取組態區段處理程式的方法或屬性會受限於 Web 應用程式所設定的信任層級。

注意

由於高信任和完全信任是唯一允許存取目前應用程式域外部檔案的層級，因此應用程式只能在這些信任層級使用組態區段處理程式。

當 設定為 false時RequirePermission，對組態數據的存取不會受到應用程式的信任層級設定所限制。

注意

不論設定為何RequirePermission，仍然需要適當的檔案 ACL (存取控制 List) 許可權。 ACL 許可權可決定誰可以存取組態檔。