Classe ConfigurationSectionWithCollection
Funge da classe di base per le classi di sezione di configurazione che contengono raccolte.
Sintassi
class ConfigurationSectionWithCollection : ConfigurationSection
Metodi
Nella tabella seguente sono elencati i metodi esposti dalla ConfigurationSectionWithCollection classe .
| Nome | Descrizione |
|---|---|
| Aggiungere | Aggiunge un elemento a una raccolta in una sezione di configurazione. |
| Cancella | Cancella tutti gli elementi da una raccolta in una sezione di configurazione. |
| Recupero | Recupera il membro specificato di una raccolta da una sezione di configurazione. |
| GetAllowDefinition | Ereditato da ConfigurationSection. |
| GetAllowLocation | Ereditato da ConfigurationSection. |
| Rimuovi | Rimuove l'elemento specificato da una raccolta in una sezione di configurazione. |
| RevertToParent | Ereditato da ConfigurationSection. |
| SetAllowDefinition | Ereditato da ConfigurationSection. |
| SetAllowLocation | Ereditato da ConfigurationSection. |
Proprietà
Nella tabella seguente sono elencate le proprietà esposte dalla ConfigurationSectionWithCollection classe .
| Nome | Descrizione |
|---|---|
Location |
Ereditato da ConfigurationSection.) Proprietà chiave. |
Path |
Ereditato da ConfigurationSection.) Proprietà chiave. |
SectionInformation |
Ereditato da ConfigurationSection. |
Sottoclassi
Nella tabella seguente sono elencate le sottoclassi esposte dalla ConfigurationSectionWithCollection classe .
| Nome | Descrizione |
|---|---|
| ApplicationDependenciesSection | Espone le informazioni sulle dipendenze dell'applicazione. |
| Appsettingssection | Contiene impostazioni dell'applicazione personalizzate, ad esempio percorsi file, URL del servizio Web XML o informazioni archiviate nel file .ini per un'applicazione. |
| AuthenticationModulesSection | Specifica i moduli di autenticazione che eseguono il processo di autenticazione con un server. |
| Authenticationsection | Configura l'autenticazione ASP.NET. |
| AuthorizationSection | Configura l'autorizzazione per l'accesso agli URL. |
| Memorizzazione nella cacheSection | Configura l'output e la memorizzazione nella cache del kernel. |
| ClientTargetSection | Specifica una raccolta di mapping tra alias e agenti utente. |
| CompilazioneSection | Configura le impostazioni di compilazione per le applicazioni ASP.NET. |
| ConfigProtectedDataSection | Contiene informazioni sul provider di configurazione protette. |
| ConnectionManagementSection | Contiene una raccolta che specifica il numero massimo di connessioni agli host di rete specificati per le API di System.Net. |
| Connectionstringssection | Specifica una raccolta di stringhe di connessione del database per le applicazioni ASP.NET. |
| Customerrorssection | Configura ASP.NET messaggi di errore personalizzati. |
| DefaultDocumentSection | Specifica i nomi dei file di pagina Web da servire ai client per impostazione predefinita. |
| DefaultProxySection | Configura le impostazioni predefinite del server proxy Web. |
| DeviceFiltersSection | Rappresenta una raccolta di filtri del dispositivo che determinano i tipi di dispositivi mobili o le funzionalità del browser per dispositivi mobili. |
| FastCgiSection | Contiene le impostazioni di configurazione per le applicazioni FastCGI. |
| GlobalModulesSection | Espone le impostazioni di configurazione per i moduli globali IIS. |
| GestoriSection | Archivia i gestori per un URL. |
| HealthMonitoringSection | Configura un'applicazione per il monitoraggio dell'integrità. |
| HttpCompressionSection | Configura la compressione HTTP. |
| HttpErrorsSection | Configura la gestione degli errori HTTP per un server Web. |
| HttpHandlersSection | Configura le impostazioni per i gestori di ASP.NET. |
| HttpModulesSection | Contiene moduli ASP.NET. |
| HttpProtocolSection | Rappresenta una sezione di configurazione del protocollo HTTP. |
| HttpRedirectSection | Configura il reindirizzamento HTTP. |
| HttpTracingSection | Rappresenta una sezione di configurazione della traccia HTTP. |
| IisClientCertificateMappingAuthenticationSection | Configura il mapping per i certificati client IIS. |
| IPSecuritySection | Configura l'accesso al contenuto del server Web in base alle informazioni correlate all'indirizzo IP. |
| IsapiCgiRestrictionSection | Configura restrizioni ISAPI e Common Gateway Interface (CGI) per un server Web in esecuzione in modalità ISAPI. |
| IsapiFiltersSection | Configura i filtri ISAPI in un server Web. |
| ListenerAdaptersSection | Espone una raccolta di adattatori listener. |
| MembershipSection | Convalida le credenziali degli utenti e gestisce le impostazioni utente. |
| MobileControlsSection | Espone le informazioni di configurazione per i controlli mobili, i relativi adattatori e i filtri dei dispositivi. |
| ModulesSection | Rappresenta la sezione modules in un file di configurazione. |
| Outputcachesettingssection | Specifica le impostazioni del profilo della cache di output che possono essere applicate alle pagine di un'applicazione ASP.NET. |
| Pagessection | Rappresenta la <pages> sezione di un file di Web.config. |
| ProtocolsSection | Contiene un elenco di protocolli di trasmissione che ASP.NET possono usare per decrittografare i dati inviati da un browser client nella richiesta HTTP. |
| RequestFilteringSection | Configura l'analisi delle richieste URL in ingresso. |
| Rolemanagersection | Definisce le impostazioni di configurazione utilizzate per supportare l'infrastruttura di gestione dei ruoli delle applicazioni Web. |
| SchemaImporterExtensionsSection | Contiene una raccolta di estensioni che eseguono il mapping di tipi XML Schema (XSD) a tipi .NET Framework. |
| SecurityPolicySection | Definisce una raccolta di mapping tra i file dei criteri di sicurezza e i relativi nomi a livello di attendibilità. |
| Sessionstatesection | Configura lo stato sessione per un'applicazione Web. |
| SiteMapSection | Definisce le impostazioni di configurazione per la navigazione nel sito. |
| SqlCacheDependencySection | Rappresenta un oggetto System.Web.Caching.SqlCacheDependency |
| StaticContentSection | Espone le impostazioni di configurazione per il contenuto statico in un sito Web. |
| SystemCodeDomSection | Specifica una raccolta di compilatori che forniscono il supporto code document object model (CodeDOM). |
| SystemDataSection | Specifica un elenco di provider di dati installati ADO.NET. |
| SystemDiagnosticsSection | Configura la diagnostica e la traccia di sistema. |
| TraceFailedRequestsSection | Rappresenta una sezione di configurazione della traccia delle richieste non riuscite. |
| TraceProviderDefinitionsSection | Rappresenta la sezione di configurazione che definisce i provider di traccia. |
| UrlMappingsSection | Rappresenta una <urlMappings> sezione che contiene coppie di mapping URL in ingresso/in uscita. |
| WebRequestModulesSection | Contiene una raccolta di moduli di richiesta Web registrati. |
| WebServicesSection | Controlla il comportamento dei servizi Web XML e dei relativi client. |
| WindowsAuthenticationSection | Configura la autenticazione di Windows integrata. |
Commenti
Se si modifica una proprietà chiave che si trova in un insieme, l'ordine posizionale (e l'indice) della proprietà nella raccolta può cambiare. La proprietà chiave modificata verrà aggiunta all'inizio o alla fine della raccolta a seconda del valore dell'attributo mergeAppend .
Nota
L'attributo mergeAppend si trova nel file di schema appropriato nella sezione che corrisponde alla proprietà della classe . Se l'attributo mergeAppend è false, i nuovi elementi vengono aggiunti all'inizio della raccolta; se l'attributo mergeAppend è true, i nuovi elementi vengono aggiunti alla fine della raccolta.
È necessario prestare attenzione a come accedere a una proprietà chiave in una raccolta dopo la modifica del valore della proprietà chiave. Ad esempio, se si modifica il valore di una proprietà chiave il cui indice è 4, il nuovo indice per la proprietà chiave sarà 0 se l'attributo mergeAppend è false.
Nota
Quando si creano schemi personalizzati e file di configurazione personalizzati, è necessario tenere presente questo comportamento. Non è consigliabile modificare gli mergeAppend attributi nei file di schema forniti con IIS 7. Non è possibile modificare l'attributo mergeAppend utilizzando il provider WMI per IIS 7.
L'attributo mergeAppend influisce sulle proprietà della classe seguenti ConfigurationSectionWithCollection fornite con IIS 7. Nella tabella sono elencate queste proprietà e i relativi file di schema corrispondenti. In tutti questi casi, i file di schema forniti con IIS 7 specificano false per l'attributo mergeAppend .
| Classe | Proprietà | File di schema |
|---|---|---|
| AuthorizationSection | Authorization |
ASPNET_Schema.xml |
| CachingSection | Profiles.Profiles |
IIS_Schema.xml |
| DefaultDocumentSection | Files.Files |
IIS_Schema.xml |
| GestoriSezione | Handlers |
IIS_Schema.xml |
| HttpHandlersSection | HttpHandlers |
ASPNET_Schema.xml |
Gerarchia di ereditarietà
ConfigurationSectionWithCollection
Requisiti
| Tipo | Descrizione |
|---|---|
| Client | - IIS 7.0 in Windows Vista - IIS 7.5 in Windows 7 - IIS 8.0 in Windows 8 - IIS 10.0 in Windows 10 |
| Server | - IIS 7.0 in Windows Server 2008 - IIS 7.5 in Windows Server 2008 R2 - IIS 8.0 in Windows Server 2012 - IIS 8.5 in Windows Server 2012 R2 - IIS 10.0 in Windows Server 2016 |
| Prodotto | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
| File MOF | Webadministration.mof |
Vedere anche
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