Export (0) Print
Expand All

SectionInformation.RequirePermission Property

Gets a value that indicates whether the associated configuration section requires access permissions.

Namespace:  System.Configuration
Assembly:  System.Configuration (in System.Configuration.dll)

public bool RequirePermission { get; set; }

Property Value

Type: System.Boolean
true if the requirePermission attribute is set to true; otherwise, false. The default is true.

ExceptionCondition
ConfigurationErrorsException

The selected value conflicts with a value that is already defined.

When RequirePermission is set to true, the GetSection methods are restricted by the trust level setting of the application. This means that methods or properties that allow access to configuration section handlers are restricted by the trust level set for the Web application.

NoteNote:

Because high and full trust are the only levels that allow access to files outside the current application domain, an application can use configuration section handlers only at these trust levels.

When RequirePermission is set to false, the access to the configuration data is not restricted by the application's trust level settings.

NoteNote:

The appropriate file ACL (Access Control List) permissions are still required, regardless of the RequirePermission setting. ACL permissions determine who can access the configuration file.

The following example shows two possible trust levels for a Web application when the RequirePermission property of the appSettings section is 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>

When the trust level is set to full, the following lines of code shown next work. Otherwise, they fail.

WebConfigurationManager.GetSection("appSettings");
WebConfigurationManager.AppSettings;

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0

Community Additions

ADD
Show:
© 2014 Microsoft