ConfigurationSectionGroup クラス

定義

public ref class ConfigurationSectionGroup

public class ConfigurationSectionGroup

type ConfigurationSectionGroup = class

Public Class ConfigurationSectionGroup

継承

Object

ConfigurationSectionGroup

派生

System.Configuration.ApplicationSettingsGroup

System.Configuration.UserSettingsGroup

System.Data.Services.Configuration.DataServicesSectionGroup

System.Net.Configuration.MailSettingsSectionGroup

System.Net.Configuration.NetSectionGroup

その他…

例

次の例は、 クラスを使用して構成設定を ConfigurationSectionGroup 取得する方法を示しています。 この例は、構成設定を読み取り、各構成セクション グループとそのセクションに関する情報をコンソールに書き込むコンソール アプリケーションです。

メソッドはMain、構成設定を オブジェクトに読み込みConfiguration、 オブジェクトからコレクションをSectionGroupsConfiguration取得してから、 メソッドをShowSectionGroupCollectionInfo呼び出してセクション プロパティの値を表示します。

メソッドは ShowSectionGroupCollectionInfo セクション グループを反復処理し、それぞれに対して メソッドを ShowSectionGroupInfo 呼び出します。

メソッドには ShowSectionGroupInfo 、セクション グループの名前、いくつかのプロパティ値、およびセクションに含まれるセクションの名前が表示されます。 セクション グループにセクション グループが含まれている場合、このメソッドは再帰的に を呼び出 ShowSectionGroupCollectionInfo して、それらのセクション グループを表示します。

フィールドは indentLevel 、論理的なグループ化を示すために表示される行の左側にスペースを追加するために使用されます。 すべての行は、行の折り返しを避けるために 79 文字のテキストに制限されているため、論理グループを区別するのが難しくなります。

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

注釈

構成ファイル (Web.config ファイルなど) の設定は、セクションごとに整理されます。 一部のセクションは関連しているため、多くの場合、セクション グループにグループ化すると便利です。 クラスは ConfigurationSectionGroup 、セクションを構成ファイルの sectionGroup 要素で configSections 定義するときにグループ化するために使用される XML 要素を表します。 セクション グループは入れ子にすることができます (セクション グループには、他のセクション グループとセクションを含めることができます)。 次の例は、 configSections 3 つの入れ子になったセクション グループを定義する要素を示しています。

<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>

構成システムは、構成ファイルからオブジェクトに設定を読み込 ConfigurationSectionGroup みます。 プロパティと SectionGroups プロパティをSections使用すると、オブジェクトに含まれるセクションとセクション グループにConfigurationSectionGroupアクセスできます。

構成ファイルから情報にアクセスする方法の詳細については、 クラスを ConfigurationManager 参照してください。

コンストラクター

プロパティ

メソッド

適用対象

こちらもご覧ください

• ConfigurationSectionGroup
• ConfigurationSectionCollection
• ConfigurationSection