Clase ConfigurationSectionWithCollection
Actúa como clase base para las clases de sección de configuración que contienen colecciones.
Sintaxis
class ConfigurationSectionWithCollection : ConfigurationSection
Métodos
La siguiente tabla muestra los métodos expuestos por la clase ConfigurationSectionWithCollection.
| Nombre | Descripción |
|---|---|
| Add (Agregar) | Agrega un elemento a una colección en una sección de configuración. |
| Borrar | Borra todos los elementos de una colección en una sección de configuración. |
| Get | Recupera el miembro especificado de una colección de una sección de configuración. |
| GetAllowDefinition | (Se hereda de ConfigurationSection). |
| GetAllowLocation | (Se hereda de ConfigurationSection). |
| Remove | Recupera el elemento especificado de una colección de una sección de configuración. |
| RevertToParent | (Se hereda de ConfigurationSection). |
| SetAllowDefinition | (Se hereda de ConfigurationSection). |
| SetAllowLocation | (Se hereda de ConfigurationSection). |
Propiedades
La siguiente tabla muestra las propiedades expuestas por la clase ConfigurationSectionWithCollection.
| Nombre | Descripción |
|---|---|
Location |
(Se hereda de ConfigurationSection). Una propiedad clave. |
Path |
(Se hereda de ConfigurationSection). Una propiedad clave. |
SectionInformation |
(Se hereda de ConfigurationSection). |
Subclases
La siguiente tabla muestra las propiedades expuestas por la clase ConfigurationSectionWithCollection.
| Nombre | Descripción |
|---|---|
| ApplicationDependenciesSection | Expone la información de dependencia de la aplicación. |
| AppSettingsSection | Contiene valores de configuración de aplicación personalizados, como rutas de acceso de archivo, direcciones URL del servicio Web XML o información que esté guardada en el archivo .ini para una aplicación. |
| AuthenticationModulesSection | Especifica los módulos de autenticación que llevan a cabo el proceso de autenticación con un servidor. |
| AuthenticationSection | Configura la autenticación de ASP.NET. |
| AuthorizationSection | Configura la autorización para el acceso a las direcciones URL. |
| CachingSection | Configura la salida y el almacenamiento en caché del kernel. |
| ClientTargetSection | Especifica una colección de asignaciones entre alias y agentes de usuario. |
| CompilationSection | Configura las opciones de compilación para las aplicaciones de ASP.NET. |
| ConfigProtectedDataSection | Contiene información del proveedor de configuración protegida. |
| ConnectionManagementSection | Contiene una colección que especifica el número máximo de conexiones a los hosts de red especificados para System.Net API. |
| ConnectionStringsSection | Especifica una colección de cadena de conexión de base de datos para aplicaciones de ASP.NET. |
| CustomErrorsSection | Configura mensajes de error personalizados de ASP.NET. |
| DefaultDocumentSection | Especifica los nombres de archivo de página web que se van a servir a los clientes de forma predeterminada. |
| DefaultProxySection | Configura los valores predeterminados del servidor proxy web. |
| DeviceFiltersSection | Representa una colección de filtros de dispositivo que determinan los tipos de dispositivos móviles o las funcionalidades del explorador móvil. |
| FastCgiSection | Contiene opciones de configuración para aplicaciones FastCGI. |
| GlobalModulesSection | Expone las opciones de configuración de los módulos globales de IIS. |
| HandlersSection | Almacena los controladores de una dirección URL. |
| HealthMonitoringSection | Configura una aplicación para el seguimiento de estado. |
| HttpCompressionSection | Configura la compresión HTTP. |
| HttpErrorsSection | Configura el control de errores HTTP para un servidor web. |
| HttpHandlersSection | Conjunto de configuración para controladores de ASP.NET. |
| HttpModulesSection | Contiene módulos ASP.NET. |
| HttpProtocolSection | Representa una sección de configuración del protocolo HTTP. |
| HttpRedirectSection | Configura la redirección HTTP. |
| HttpTracingSection | Representa una sección de configuración del seguimiento HTTP. |
| IisClientCertificateMappingAuthenticationSection | Configura la asignación para los certificados de cliente de IIS. |
| IPSecuritySection | Configura el acceso al contenido del servidor web en función de la información relacionada con la dirección IP. |
| IsapiCgiRestrictionSection | Configura restricciones de ISAPI y Common Gateway Interface (CGI) para un servidor web que se ejecuta en modo ISAPI. |
| IsapiFiltersSection | Configura los filtros ISAPI en un servidor web. |
| ListenerAdaptersSection | Expone una colección de adaptadores de agente de escucha. |
| MembershipSection | Valida las credenciales de usuario y administra la configuración de usuario. |
| MobileControlsSection | Expone información de configuración para los controles móviles, sus adaptadores y filtros de dispositivo. |
| ModulesSection | Representa la sección módulos de un archivo de configuración. |
| OutputCacheSettingsSection | Especifica la configuración del perfil de caché de salida que se puede aplicar a las páginas de una aplicación de ASP.NET. |
| PagesSection | Representa la sección <pages> del archivo Web.config. |
| ProtocolsSection | Contiene una lista de protocolos de transmisión que ASP.NET pueden usar para descifrar los datos enviados desde un explorador cliente en la solicitud HTTP. |
| RequestFilteringSection | Configura el examen de las solicitudes de dirección URL entrantes. |
| RoleManagerSection | Define las opciones de configuración que se usan para admitir la infraestructura de administración de roles de las aplicaciones web. |
| SchemaImporterExtensionsSection | Contiene una colección de extensiones que asignan tipos de esquema XML (XSD) a tipos de .NET Framework. |
| SecurityPolicySection | Define una colección de asignaciones entre los archivos de directiva de seguridad y sus nombres de nivel de confianza. |
| SessionStateSection | Configura el estado de sesión de una aplicación web. |
| SiteMapSection | Define los valores de configuración para la navegación del sitio. |
| SqlCacheDependencySection | Representa un System.Web.Caching.SqlCacheDependency |
| StaticContentSection | Expone el conjunto de configuración para el contenido estático en un sitio web. |
| SystemCodeDomSection | Especifica una colección de compiladores que proporcionan compatibilidad con el Code Document Object Model (CodeDOM). |
| SystemDataSection | Especifica una lista de proveedores de datos ADO.NET instalados. |
| SystemDiagnosticsSection | Configura el diagnóstico y el seguimiento del sistema. |
| TraceFailedRequestsSection | Representa una sección de configuración de seguimiento de solicitudes con error. |
| TraceProviderDefinitionsSection | Representa la sección de configuración que define los proveedores de seguimiento. |
| UrlMappingsSection | Representa una sección de <urlMappings> que contiene pares de asignaciones de direcciones URL entrantes y salientes. |
| WebRequestModulesSection | Contiene una colección de módulos de solicitud web registrados. |
| WebServicesSection | Controla el comportamiento de los servicios web XML y sus clientes. |
| WindowsAuthenticationSection | Configura la autenticación integrada de Windows. |
Comentarios
Si cambia una propiedad de clave que se encuentra en una colección, el orden posicional (e índice) de la propiedad de la colección puede cambiar. La propiedad de clave modificada se agregará al principio o al final de la colección en función del valor del atributo mergeAppend.
Nota:
El atributo mergeAppend se encuentra en el archivo de esquema adecuado de la sección que corresponde a la propiedad de clase. Si el atributo mergeAppend es false, se agregan nuevos elementos al principio de la colección; si el atributo mergeAppend es true, se agregan nuevos elementos al final de la colección.
Debe tener cuidado de cómo accede a una propiedad de clave en una colección después de que el valor de la propiedad de clave haya cambiado. Por ejemplo, si cambia el valor de una propiedad de clave cuyo índice es 4, el nuevo índice de la propiedad de clave será 0 si el atributo mergeAppend es false.
Nota:
Debe tener en cuenta este comportamiento al crear cualquier esquema personalizado y archivos de configuración personalizados. No debe modificar los atributos mergeAppend de los archivos de esquema que se incluyen con IIS 7. No se puede modificar el atributo mergeAppend mediante el proveedor WMI para IIS 7.
El atributo mergeAppend afecta a las siguientes propiedades de clase ConfigurationSectionWithCollection que se incluyen con IIS 7. En la tabla se enumeran estas propiedades y sus archivos de esquema correspondientes. En todos estos casos, los archivos de esquema que se incluyen con IIS 7 especifican false para el atributo mergeAppend.
| Clase | Propiedad | Archivo de esquema |
|---|---|---|
| AuthorizationSection | Authorization |
ASPNET_Schema.xml |
| CachingSection | Profiles.Profiles |
IIS_Schema.xml |
| DefaultDocumentSection | Files.Files |
IIS_Schema.xml |
| HandlersSection | Handlers |
IIS_Schema.xml |
| HttpHandlersSection | HttpHandlers |
ASPNET_Schema.xml |
Jerarquía de herencia
ConfigurationSectionWithCollection
Requisitos
| Tipo | Descripción |
|---|---|
| Remoto | - IIS 7.0 en Windows Vista - IIS 7.5 en Windows 7 - IIS 8.0 en Windows 8 - IIS 10.0 en Windows 10 |
| Server | - IIS 7.0 en Windows Server 2008 - IIS 7.5 en Windows Server 2008 R2 - IIS 8.0 en Windows Server 2012 - IIS 8.5 en Windows Server 2012 R2 - IIS 10.0 en Windows Server 2016 |
| Producto | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
| archivo MOF | WebAdministration.mof |
Consulte también
Clase AuthorizationRule
Clase AuthorizationSection
Clase CachingProfileElement
Clase CachingProfileSettings
Clase CachingSection
Clase ConfigurationSection
Clase DefaultDocumentSection
Clase FileSettings
Clase HandlerAction
Clase HandlersSection
Clase HttpHandlerAction
Clase HttpHandlersSection
Clase StringElement