ConfigurationSectionWithCollection-Klasse
Dient als Basisklasse für ConfigurationSection-Klassen, die Auflistungen enthalten.
Syntax
class ConfigurationSectionWithCollection : ConfigurationSection
Methoden
In der folgenden Tabelle werden die Methoden aufgelistet, die von der ConfigurationSectionWithCollection-Klasse verfügbar gemacht werden.
| Name | Beschreibung |
|---|---|
| Add (Hinzufügen) | Fügt einer Auflistung in einem Konfigurationsabschnitt ein Element hinzu. |
| Clear | Löscht alle Elemente aus einer Auflistung in einem Konfigurationsabschnitt. |
| Get | Ruft den angegebenen Member einer Auflistung aus einem Konfigurationsabschnitt ab. |
| GetAllowDefinition | (Geerbt von ConfigurationSection.) |
| GetAllowLocation | (Geerbt von ConfigurationSection.) |
| Remove | Entfernt das angegebene Element aus einer Auflistung in einem Konfigurationsabschnitt. |
| RevertToParent | (Geerbt von ConfigurationSection.) |
| SetAllowDefinition | (Geerbt von ConfigurationSection.) |
| SetAllowLocation | (Geerbt von ConfigurationSection.) |
Eigenschaften
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die von der ConfigurationSectionWithCollection-Klasse verfügbar gemacht werden.
| Name | Beschreibung |
|---|---|
Location |
(Geerbt von ConfigurationSection.) Eine Schlüsseleigenschaft. |
Path |
(Geerbt von ConfigurationSection.) Eine Schlüsseleigenschaft. |
SectionInformation |
(Geerbt von ConfigurationSection.) |
Unterklassen
In der folgenden Tabelle sind die Unterklassen aufgeführt, die von der ConfigurationSectionWithCollection-Klasse verfügbar gemacht werden.
| Name | Beschreibung |
|---|---|
| ApplicationDependenciesSection | Macht Informationen zu Anwendungsabhängigkeiten verfügbar. |
| AppSettingsSection | Enthält benutzerdefinierte Anwendungseinstellungen, z. B. Dateipfade, XML-Webdienst-URLs oder Informationen, die in der INI-Datei für eine Anwendung gespeichert sind. |
| AuthenticationModulesSection | Gibt die Authentifizierungsmodule an, die den Authentifizierungsprozess bei einem Server durchführen. |
| AuthenticationSection | Konfiguriert die ASP.NET-Authentifizierung. |
| AuthorizationSection | Konfiguriert die Autorisierung für den Zugriff auf URLs. |
| CachingSection | Konfiguriert die Ausgabe- und Kernelzwischenspeicherung. |
| ClientTargetSection | Gibt eine Auflistung von Zuordnungen zwischen Aliasen und Benutzer-Agents an. |
| CompilationSection | Konfiguriert Kompilierungseinstellungen für ASP.NET-Anwendungen. |
| ConfigProtectedDataSection | Enthält Informationen zum Anbieter einer geschützten Konfiguration. |
| ConnectionManagementSection | Enthält eine Auflistung, die die maximale Anzahl von Verbindungen mit angegebenen Netzwerkhosts für System.Net-APIs angibt. |
| ConnectionStringsSection | Gibt eine Auflistung von Datenbankverbindungszeichenfolgen für ASP.NET-Anwendungen an. |
| CustomErrorsSection | Konfiguriert benutzerdefinierte ASP.NET-Fehlermeldungen. |
| DefaultDocumentSection | Gibt die Dateinamen der Webseiten an, die standardmäßig für Clients bereitgestellt werden sollen. |
| DefaultProxySection | Konfiguriert die Standardwerte des Webproxyservers. |
| DeviceFiltersSection | Stellt eine Auflistung von Gerätefiltern dar, die mobile Gerätetypen oder Funktionen mobiler Browser bestimmen. |
| FastCgiSection | Enthält Konfigurationseinstellungen für FastCGI-Anwendungen. |
| GlobalModulesSection | Macht Konfigurationseinstellungen für globale IIS-Module verfügbar. |
| HandlersSection | Speichert die Handler für eine URL. |
| HealthMonitoringSection | Konfiguriert eine Anwendung für die Integritätsüberwachung. |
| HttpCompressionSection | Konfiguriert die HTTP-Komprimierung. |
| HttpErrorsSection | Konfiguriert die HTTP-Fehlerbehandlung für einen Webserver. |
| HttpHandlersSection | Konfiguriert Einstellungen für ASP.NET-Handler. |
| HttpModulesSection | Enthält ASP.NET-Module. |
| HttpProtocolSection | Stellt einen Konfigurationsabschnitt für das HTTP-Protokoll dar. |
| HttpRedirectSection | Konfiguriert die HTTP-Umleitung. |
| HttpTracingSection | Stellt einen Konfigurationsabschnitt für die HTTP-Ablaufverfolgung dar. |
| IisClientCertificateMappingAuthenticationSection | Konfiguriert die Zuordnung für IIS-Clientzertifikate. |
| IPSecuritySection | Konfiguriert den Zugriff auf Webserverinhalte basierend auf IP-Adressinformationen. |
| IsapiCgiRestrictionSection | Konfiguriert ISAPI- und CGI-Einschränkungen (Common Gateway Interface, gemeinsame Gatewayschnittstelle) für einen Webserver, der im ISAPI-Modus ausgeführt wird. |
| IsapiFiltersSection | Konfiguriert die ISAPI-Filter auf einem Webserver. |
| ListenerAdaptersSection | Macht eine Auflistung von Listeneradaptern verfügbar. |
| MembershipSection | Überprüft die Benutzeranmeldeinformationen und verwaltet Benutzereinstellungen. |
| MobileControlsSection | Macht Konfigurationsinformationen für mobile Steuerelemente, deren Adapter und Gerätefilter verfügbar. |
| ModulesSection | Stellt den Abschnitt „modules“ einer Konfigurationsdatei dar. |
| OutputCacheSettingsSection | Gibt die Einstellungen für das Ausgabecacheprofil an, die auf Seiten in einer ASP.NET-Anwendung angewandt werden können. |
| PagesSection | Stellt den Abschnitt <pages> einer Web.config-Datei dar. |
| ProtocolsSection | Enthält eine Liste der Übertragungsprotokolle, die ASP.NET zum Entschlüsseln von Daten verwenden kann, die von Clientbrowsern in HTTP-Anforderungen gesendet werden. |
| RequestFilteringSection | Konfiguriert die Überprüfung eingehender URL-Anforderungen. |
| RoleManagerSection | Definiert Konfigurationseinstellungen, die zur Unterstützung der Rollenverwaltungsinfrastruktur von Webanwendungen verwendet werden. |
| SchemaImporterExtensionsSection | Enthält eine Auflistung von Erweiterungen, die XSD-Typen (XML-Schema) .NET Framework-Typen zuordnen. |
| SecurityPolicySection | Definiert eine Auflistung von Zuordnungen zwischen Sicherheitsrichtliniendateien und deren Namen auf Vertrauensebene. |
| SessionStateSection | Konfiguriert den Sitzungszustand für eine Webanwendung. |
| SiteMapSection | Definiert Konfigurationseinstellungen für die Sitenavigation. |
| SqlCacheDependencySection | Stellt eine System.Web.Caching.SqlCacheDependency dar. |
| StaticContentSection | Macht Konfigurationseinstellungen für statische Inhalte auf einer Website verfügbar. |
| SystemCodeDomSection | Gibt eine Auflistung von Compilern an, die Unterstützung für CodeDOM (Code Document Object Model) bieten. |
| SystemDataSection | Gibt eine Liste der installierten ADO.NET-Datenanbieter an. |
| SystemDiagnosticsSection | Konfiguriert die Systemdiagnose und -ablaufverfolgung. |
| TraceFailedRequestsSection | Stellt einen Konfigurationsabschnitt für die Ablaufverfolgung fehlerhafter Anforderungen dar. |
| TraceProviderDefinitionsSection | Stellt den Konfigurationsabschnitt dar, in dem Ablaufverfolgungsanbieter definiert werden. |
| UrlMappingsSection | Stellt einen Abschnitt <urlMappings> dar, der Paare von ein- und ausgehenden URL-Zuordnungen enthält. |
| WebRequestModulesSection | Enthält eine Auflistung der registrierten Webanforderungsmodule. |
| WebServicesSection | Steuert das Verhalten von XML-Webdiensten und deren Clients. |
| WindowsAuthenticationSection | Konfiguriert die integrierte Windows-Authentifizierung. |
Hinweise
Wenn Sie eine Schlüsseleigenschaft ändern, die sich in einer Auflistung befindet, kann sich die Position (und der Index) der Eigenschaft in der Auflistung ändern. Die geänderte Schlüsseleigenschaft wird je nach Wert des mergeAppend-Attributs am Anfang oder Ende der Auflistung hinzugefügt.
Hinweis
Das mergeAppend-Attribut befindet sich in der entsprechenden Schemadatei im Abschnitt, der der Klasseneigenschaft entspricht. Wenn das mergeAppend-Attribut den Wert false hat, werden neue Elemente am Anfang der Auflistung hinzugefügt. Wenn das mergeAppend-Attribut den Wert true aufweist, werden neue Elemente am Ende der Auflistung hinzugefügt.
Passen Sie auf, wie Sie auf eine Schlüsseleigenschaft in einer Auflistung zugreifen, nachdem der Wert der Schlüsseleigenschaft geändert wurde. Wenn Sie beispielsweise den Wert einer Schlüsseleigenschaft ändern, deren Index 4 ist, lautet der neue Index für die Schlüsseleigenschaft 0, wenn das mergeAppend-Attribut auf false festgelegt wurde.
Hinweis
Sie sollten dieses Verhalten beachten, wenn Sie benutzerdefinierte Schema- und Konfigurationsdateien erstellen. Sie sollten nicht die mergeAppend-Attribute in den Schemadateien ändern, die mit IIS 7 ausgeliefert wurden. Sie können das mergeAppend-Attribut nicht mithilfe des WMI-Anbieters für IIS 7 ändern.
Das mergeAppend-Attribut wirkt sich auf die folgenden ConfigurationSectionWithCollection-Klasseneigenschaften aus, die mit IIS 7 ausgeliefert werden. In der Tabelle sind diese Eigenschaften und die zugehörigen Schemadateien aufgeführt. In all diesen Fällen geben die Schemadateien, die mit IIS 7 ausgeliefert werden, für das mergeAppend-Attribut den Wert false an.
| Klasse | Eigenschaft | Schemadatei |
|---|---|---|
| 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 |
Vererbungshierarchie
ConfigurationSectionWithCollection
Anforderungen
| type | Beschreibung |
|---|---|
| Client | - IIS 7.0 unter Windows Vista - IIS 7.5 unter Windows 7 - IIS 8.0 unter Windows 8 - IIS 10.0 unter Windows 10 |
| Server | - IIS 7.0 unter Windows Server 2008 - IIS 7.5 unter Windows Server 2008 R2 - IIS 8.0 unter Windows Server 2012 - IIS 8.5 unter Windows Server 2012 R2 - IIS 10.0 unter Windows Server 2016 |
| Produkt | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
| MOF-Datei | Webadministration.mof |
Weitere Informationen
AuthorizationRule-Klasse
AuthorizationSection-Klasse
CachingProfileElement-Klasse
CachingProfileSettings-Klasse
CachingSection-Klasse
ConfigurationSection-Klasse
DefaultDocumentSection-Klasse
FileSettings-Klasse
HandlerAction-Klasse
HandlersSection-Klasse
HttpHandlerAction-Klasse
HttpHandlersSection-Klasse
StringElement-Klasse