ConfigurationSectionGroup Klasse

Definition

public ref class ConfigurationSectionGroup

public class ConfigurationSectionGroup

type ConfigurationSectionGroup = class

Public Class ConfigurationSectionGroup

Vererbung

Object

ConfigurationSectionGroup

Abgeleitet

System.Configuration.ApplicationSettingsGroup

System.Configuration.UserSettingsGroup

System.Data.Services.Configuration.DataServicesSectionGroup

System.Net.Configuration.MailSettingsSectionGroup

System.Net.Configuration.NetSectionGroup

Mehr …

Beispiele

Das folgende Beispiel zeigt, wie Die -Klasse zum Abrufen von ConfigurationSectionGroup Konfigurationseinstellungen verwendet wird. Das Beispiel ist eine Konsolenanwendung, die Konfigurationseinstellungen liest und Informationen zu jeder Konfigurationsabschnittsgruppe und den darin betreffenden Abschnitten in die Konsole schreibt.

Die Main -Methode lädt die Konfigurationseinstellungen in ein Configuration -Objekt, ruft die SectionGroups Auflistung aus dem Configuration -Objekt ab und ruft dann die ShowSectionGroupCollectionInfo -Methode auf, um die Abschnittseigenschaftswerte anzuzeigen.

Die ShowSectionGroupCollectionInfo -Methode durchläuft die Abschnittsgruppen und ruft die ShowSectionGroupInfo -Methode für jede auf.

Die ShowSectionGroupInfo -Methode zeigt den Namen der Abschnittsgruppe, einige Eigenschaftswerte und die Namen der darin enthaltenen Abschnitte an. Wenn die Abschnittsgruppe Abschnittsgruppen enthält, ruft ShowSectionGroupCollectionInfo diese Methode rekursiv auf, um diese Abschnittsgruppen anzuzeigen.

Das indentLevel Feld wird verwendet, um auf der linken Seite der angezeigten Zeilen Leerzeichen hinzuzufügen, um logische Gruppierungen anzuzeigen. Alle Zeilen sind auf 79 Zeichen beschränkt, um Zeilenumbrüche zu vermeiden, was die Unterscheidung der logischen Gruppierungen erschweren würde.

using System;
using System.Collections;
using System.Configuration;

namespace Samples.AspNet
{
    class UsingConfigurationSectionGroup
    {
        static int indentLevel = 0;

        static void Main(string[] args)
        {

            // Get the application configuration file.
            System.Configuration.Configuration config =
                ConfigurationManager.OpenExeConfiguration(
                ConfigurationUserLevel.None);

            // Get the collection of the section groups.
            ConfigurationSectionGroupCollection sectionGroups =
                config.SectionGroups;

            // Display the section groups.
            ShowSectionGroupCollectionInfo(sectionGroups);
        }

        static void ShowSectionGroupCollectionInfo(
            ConfigurationSectionGroupCollection sectionGroups)
        {
            foreach (ConfigurationSectionGroup sectionGroup in sectionGroups)
            {
                ShowSectionGroupInfo(sectionGroup);
            }
        }

        static void ShowSectionGroupInfo(
            ConfigurationSectionGroup sectionGroup)
        {
            // Get the section group name.
            indent("Section Group Name: " + sectionGroup.Name);

            // Get the fully qualified group name.
            indent("Section Group Name: " + sectionGroup.SectionGroupName);

            indentLevel++;

            indent("Type: " + sectionGroup.Type);
            indent("Is Group Required?: " + 
                sectionGroup.IsDeclarationRequired);
            indent("Is Group Declared?: " + sectionGroup.IsDeclared);
            indent("Contained Sections:");

            indentLevel++;
            foreach (ConfigurationSection section 
                in sectionGroup.Sections)
            {
                indent("Section Name:" + section.SectionInformation.Name);
            }
            indentLevel--;

            // Display contained section groups if there are any.
            if (sectionGroup.SectionGroups.Count > 0)
            {
                indent("Contained Section Groups:");

                indentLevel++;
                ConfigurationSectionGroupCollection sectionGroups =
                    sectionGroup.SectionGroups;
                ShowSectionGroupCollectionInfo(sectionGroups);
            }

            Console.WriteLine("");
            indentLevel--;
        }

        static void indent(string text)
        {
            for (int i = 0; i < indentLevel; i++)
            {
                Console.Write("  ");
            }
            Console.WriteLine(text.Substring(0, Math.Min(79 - indentLevel * 2, text.Length)));
        }
    }
}

Imports System.Collections
Imports System.Configuration

Class UsingConfigurationSectionGroup
   Private Shared indentLevel As Integer = 0
    
    Public Shared Sub Main(ByVal args() As String)

        ' Get the application configuration file.
        Dim config As System.Configuration.Configuration = _
            ConfigurationManager.OpenExeConfiguration( _
            ConfigurationUserLevel.None)

        ' Get the collection of the section groups.
        Dim sectionGroups As ConfigurationSectionGroupCollection = _
            config.SectionGroups

        ' Display the section groups.
        ShowSectionGroupCollectionInfo(sectionGroups)
    End Sub

    Shared Sub ShowSectionGroupCollectionInfo( _
        ByVal sectionGroups _
        As ConfigurationSectionGroupCollection)

        Dim group As ConfigurationSectionGroup
        For Each group In sectionGroups
            ShowSectionGroupInfo(group)
        Next group
    End Sub

    Shared Sub ShowSectionGroupInfo( _
    ByVal sectionGroup As ConfigurationSectionGroup)
        ' Get the section group name.
        indent("Section Group Name: " + sectionGroup.Name)

        ' Get the fully qualified section group name.
        indent("Section Group Name: " + sectionGroup.SectionGroupName)

        indentLevel += 1

        indent("Type: " + sectionGroup.Type)
        indent("Is Group Required?: " + _
           sectionGroup.IsDeclarationRequired.ToString())
        indent("Is Group Declared?: " + _
            sectionGroup.IsDeclared.ToString())
        indent("Contained Sections:")

        indentLevel += 1
        Dim section As ConfigurationSection
        For Each section In sectionGroup.Sections
            indent("Section Name:" + section.SectionInformation.Name)
        Next section
        indentLevel -= 1

        If (sectionGroup.SectionGroups.Count > 0) Then
            indent("Contained Section Groups:")

            indentLevel += 1
            Dim sectionGroups As ConfigurationSectionGroupCollection = _
                sectionGroup.SectionGroups
            ShowSectionGroupCollectionInfo(sectionGroups)
            indentLevel -= 1
        End If

        indent("")
        indentLevel -= 1

    End Sub
    Shared Sub indent(ByVal text As String)
        Dim i As Integer
        For i = 0 To indentLevel - 1
            Console.Write("  ")
        Next i
        Console.WriteLine(Left(text, 79 - indentLevel * 2))
    End Sub

End Class

Hinweise

Einstellungen in Konfigurationsdateien (z. B. die Web.config-Datei) sind in Abschnitte unterteilt. Da einige Abschnitte miteinander verknüpft sind, ist es häufig praktisch, sie in einer Abschnittsgruppe zu gruppieren. Die ConfigurationSectionGroup -Klasse stellt das sectionGroup XML-Element dar, das zum Gruppieren von Abschnitten verwendet wird, wenn sie im configSections Element einer Konfigurationsdatei definiert sind. Abschnittsgruppen können geschachtelt werden (eine Abschnittsgruppe kann andere Abschnittsgruppen sowie Abschnitte enthalten). Das folgende Beispiel zeigt ein configSections Element, das drei geschachtelte Abschnittsgruppen definiert:

<configSections>
  <sectionGroup name="system.web.extensions"...>
    <sectionGroup name="scripting" ...>
      <section name="scriptResourceHandler".../>
      <sectionGroup name="webServices"...>
        <section name="jsonSerialization" .../>
        <section name="profileService" ... />        <section name="authenticationService" .../>
        <section name="roleService" .../>
      </sectionGroup>
    </sectionGroup>
  </sectionGroup>
</configSections>

Das Konfigurationssystem lädt Einstellungen aus Konfigurationsdateien in ConfigurationSectionGroup Objekte. Sie können die Sections Eigenschaften und SectionGroups verwenden, um auf die Abschnitte und Abschnittsgruppen zuzugreifen, die in einem ConfigurationSectionGroup -Objekt enthalten sind.

Weitere Informationen zum Zugreifen auf Informationen aus Konfigurationsdateien finden Sie in der ConfigurationManager -Klasse.

Konstruktoren

Eigenschaften

Methoden

Gilt für:

Weitere Informationen

• ConfigurationSectionGroup
• ConfigurationSectionCollection
• ConfigurationSection