Classe ConfigurationSectionWithCollection
Serve como classe base para classes de seção de configuração que contêm coleções.
Sintaxe
class ConfigurationSectionWithCollection : ConfigurationSection
Métodos
A tabela a seguir lista os métodos expostos pela classe ConfigurationSectionWithCollection.
| Nome | Descrição |
|---|---|
| Add | Adiciona um elemento a uma coleção em uma seção de configuração. |
| Limpar | Limpa todos os elementos de uma coleção em uma seção de configuração. |
| Get | Recupera o membro especificado de uma coleção de uma seção de configuração. |
| GetAllowDefinition | (Herdado de ConfigurationSection.) |
| GetAllowLocation | (Herdado de ConfigurationSection.) |
| Remover | Remove o elemento especificado de uma coleção em uma seção de configuração. |
| RevertToParent | (Herdado de ConfigurationSection.) |
| SetAllowDefinition | (Herdado de ConfigurationSection.) |
| SetAllowLocation | (Herdado de ConfigurationSection.) |
Propriedades
A tabela a seguir lista as propriedades expostas pela classe ConfigurationSectionWithCollection.
| Nome | Descrição |
|---|---|
Location |
(Herdado de ConfigurationSection.) Uma propriedade chave. |
Path |
(Herdado de ConfigurationSection.) Uma propriedade chave. |
SectionInformation |
(Herdado de ConfigurationSection.) |
Subclasses
A tabela a seguir lista as subclasses expostas pela classe ConfigurationSectionWithCollection.
| Nome | Descrição |
|---|---|
| ApplicationDependenciesSection | Expõe informações de dependência do aplicativo. |
| AppSettingsSection | Contém configurações personalizadas do aplicativo, como caminhos de arquivo, URLs de serviços Web XML ou informações armazenadas no arquivo .ini de um aplicativo. |
| AuthenticationModulesSection | Especifica os módulos de autenticação que conduzem o processo de autenticação com um servidor. |
| AuthenticationSection | Configura a autenticação ASP.NET. |
| AuthorizationSection | Configura autorização para acesso a URLs. |
| CachingSection | Configura o cache de saída e do kernel. |
| ClientTargetSection | Especifica uma coleção de mapeamentos entre aliases e agentes de usuário. |
| CompilationSection | Define configurações de compilação para aplicativos ASP.NET. |
| ConfigProtectedDataSection | Contém informações protegidas do provedor de configuração. |
| ConnectionManagementSection | Contém uma coleção que especifica o número máximo de conexões com hosts de rede especificados para APIs System.Net. |
| ConnectionStringsSection | Especifica uma coleção de cadeias de conexões de banco de dados para aplicativos ASP.NET. |
| CustomErrorsSection | Configura mensagens de erro personalizadas do ASP.NET. |
| DefaultDocumentSection | Especifica os nomes de arquivos de páginas da Web para servir aos clientes por padrão. |
| DefaultProxySection | Configura padrões do servidor proxy da Web. |
| DeviceFiltersSection | Representa uma coleção de filtros de dispositivos que determinam os tipos de dispositivos móveis ou os recursos do navegador móvel. |
| FastCgiSection | Contém definições de configuração para aplicativos FastCGI. |
| GlobalModulesSection | Expõe definições de configuração para módulos globais do IIS. |
| HandlersSection | Armazena os manipuladores de uma URL. |
| HealthMonitoringSection | Configura um aplicativo para monitoramento de funcionamento. |
| HttpCompressionSection | Configura a compactação HTTP. |
| HttpErrorsSection | Configura o tratamento de erros HTTP para um servidor Web. |
| HttpHandlersSection | Define configurações para manipuladores ASP.NET. |
| HttpModulesSection | Contém módulos ASP.NET. |
| HttpProtocolSection | Representa uma seção de configuração do protocolo HTTP. |
| HttpRedirectSection | Configura o redirecionamento HTTP. |
| HttpTracingSection | Representa uma seção de configuração de rastreamento HTTP. |
| IisClientCertificateMappingAuthenticationSection | Configura o mapeamento para certificados de cliente IIS. |
| IPSecuritySection | Configura o acesso ao conteúdo do servidor Web com base nas informações relacionadas ao endereço IP. |
| IsapiCgiRestrictionSection | Configura restrições ISAPI e Common Gateway Interface (CGI) para um servidor Web executado no modo ISAPI. |
| IsapiFiltersSection | Configura os filtros ISAPI em um servidor Web. |
| ListenerAdaptersSection | Expõe uma coleção de adaptadores de ouvinte. |
| MembershipSection | Valida credenciais do usuário e gerencia configurações do usuário. |
| MobileControlsSection | Expõe informações de configuração para controles móveis, seus adaptadores e filtros de dispositivos. |
| ModulesSection | Representa a seção de módulos em um arquivo de configuração. |
| OutputCacheSettingsSection | Especifica as configurações do perfil de cache de saída que podem ser aplicadas às páginas em um aplicativo ASP.NET. |
| PagesSection | Representa a seção <pages> de um arquivo Web.config. |
| ProtocolsSection | Contém uma lista de protocolos de transmissão que o ASP.NET pode usar para descriptografar dados enviados de um navegador cliente na solicitação HTTP. |
| RequestFilteringSection | Configura a verificação de solicitações de URL recebidas. |
| RoleManagerSection | Define as definições de configuração usadas para dar suporte à infraestrutura de gerenciamento de função de aplicativos Web. |
| SchemaImporterExtensionsSection | Contém uma coleção de extensões que mapeiam tipos de esquema XML (XSD) para tipos do .NET Framework. |
| SecurityPolicySection | Define uma coleção de mapeamentos entre arquivos de política de segurança e seus nomes de nível de confiança. |
| SessionStateSection | Configura o estado de sessão para um aplicativo Web. |
| SiteMapSection | Define configurações para navegação no site. |
| SqlCacheDependencySection | Representa um System.Web.Caching.SqlCacheDependency |
| StaticContentSection | Expõe definições de configuração para conteúdo estático em um site. |
| SystemCodeDomSection | Especifica uma coleção de compiladores que fornecem suporte ao Code Document Object Model (CodeDOM). |
| SystemDataSection | Especifica uma lista de provedores de dados ADO.NET instalados. |
| SystemDiagnosticsSection | Configura diagnósticos e rastreamento do sistema. |
| TraceFailedRequestsSection | Representa uma seção de configuração de rastreamento de solicitação com falha. |
| TraceProviderDefinitionsSection | Representa a seção de configuração que define provedores de rastreamento. |
| UrlMappingsSection | Representa uma seção <urlMappings> que contém pares de mapeamentos de URL de entrada/saída. |
| WebRequestModulesSection | Contém uma coleção de módulos de solicitação da Web registrados. |
| WebServicesSection | Controla o comportamento dos serviços Web XML e de seus clientes. |
| WindowsAuthenticationSection | Configura a autenticação do Windows integrada. |
Comentários
Se você alterar uma propriedade chave que esteja em uma coleção, a ordem posicional (e o índice) da propriedade na coleção poderá mudar. A propriedade chave alterada será adicionada ao início ou ao final da coleção dependendo do valor do atributo mergeAppend.
Observação
O atributo mergeAppend está no arquivo de esquema apropriado na seção que corresponde à propriedade da classe. Se o atributo mergeAppend for false, novos itens serão adicionados ao início da coleção; se o atributo mergeAppend for true, novos itens serão adicionados ao final da coleção.
Você deve ter cuidado ao acessar uma propriedade-chave em uma coleção depois que o valor da propriedade-chave for alterado. Por exemplo, se você alterar o valor de uma propriedade chave cujo índice é 4, o novo índice da propriedade chave será 0 se o atributo mergeAppend for false.
Observação
Você deve estar ciente desse comportamento ao criar qualquer esquema customizado e arquivos de configuração customizados. Você não deve modificar os atributos mergeAppend nos arquivos de esquema fornecidos com o IIS 7. Você não pode modificar o atributo mergeAppend usando o provedor WMI para IIS 7.
O atributo mergeAppend afeta as seguintes propriedades de classe ConfigurationSectionWithCollection fornecidas com o IIS 7. A tabela lista essas propriedades e seus arquivos de esquema correspondentes. Em todos esses casos, os arquivos de esquema fornecidos com o IIS 7 especificam false para o atributo mergeAppend.
| Classe | Propriedade | Arquivo 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 |
Hierarquia de herança
ConfigurationSectionWithCollection
Requisitos
| Tipo | Descrição |
|---|---|
| Cliente | - IIS 7.0 no Windows Vista - IIS 7.5 no Windows 7 - IIS 8.0 no Windows 8 - IIS 10.0 no Windows 10 |
| Servidor | - IIS 7.0 no Windows Server 2008 - IIS 7.5 no Windows Server 2008 R2 - IIS 8.0 no Windows Server 2012 - IIS 8.5 no Windows Server 2012 R2 - IIS 10.0 no Windows Server 2016 |
| Product | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
| Arquivo MOF | Webadministration.mof |
Confira também
Classe AuthorizationRule
Classe AuthorizationSection
Classe CachingProfileElement
Classe CachingProfileSettings
Classe CachingSection
Classe ConfigurationSection
Classe DefaultDocumentSection
Classe FileSettings
Classe HandlerAction
Classe HandlersSection
Classe HttpHandlerAction
Classe HttpHandlersSection
Classe StringElement