SectionInformation.RequirePermission Propiedad

Definición

Espacio de nombres:

System.Configuration

Ensamblado:

System.Configuration.ConfigurationManager.dll

Paquete:

System.Configuration.ConfigurationManager v8.0.0

Source:

SectionInformation.cs

Obtiene un valor que indica si la sección de configuración asociada necesita permisos de acceso.

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

Valor de propiedad

Boolean

Es true si el atributo requirePermission se establece en true; de lo contrario, es false. De manera predeterminada, es true.

Excepciones

ConfigurationErrorsException

El valor seleccionado está en conflicto con un valor ya definido.

Ejemplos

En el ejemplo siguiente se muestran dos niveles de confianza posibles para una aplicación web cuando la RequirePermission propiedad de la appSettings sección es 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>

En el ejemplo siguiente se muestra el código que se ejecuta sin errores cuando el nivel de confianza está establecido en completo. De lo contrario, el código produce un error.

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

Comentarios

Cuando RequirePermission se establece trueen , los GetSection métodos están restringidos por la configuración de nivel de confianza de la aplicación. Esto significa que los métodos o propiedades que permiten el acceso a los controladores de sección de configuración están restringidos por el nivel de confianza establecido para la aplicación web.

Nota

Dado que la confianza alta y plena son los únicos niveles que permiten el acceso a archivos fuera del dominio de aplicación actual, una aplicación solo puede usar controladores de sección de configuración en estos niveles de confianza.

Cuando RequirePermission se establece falseen , el acceso a los datos de configuración no está restringido por la configuración del nivel de confianza de la aplicación.

Nota

Los permisos de ACL de archivo (Access Control Lista) adecuados siguen siendo necesarios, independientemente de la RequirePermission configuración. Los permisos de ACL determinan quién puede acceder al archivo de configuración.