Configuration.GetSection(String) Configuration.GetSection(String) Configuration.GetSection(String) Configuration.GetSection(String) Method

定義

指定した ConfigurationSection オブジェクトを返します。Returns the specified ConfigurationSection object.

public:
 System::Configuration::ConfigurationSection ^ GetSection(System::String ^ path);
public System.Configuration.ConfigurationSection GetSection (string path);
member this.GetSection : string -> System.Configuration.ConfigurationSection
Public Function GetSection (path As String) As ConfigurationSection

パラメーター

sectionName
String String String String

返されるセクションへのパス。The path to the section to be returned.

戻り値

指定した ConfigurationSection オブジェクト。または、要求したセクションが存在しない場合は nullThe specified ConfigurationSection object, or null if the requested section does not exist.

次の例は、メソッドを使用GetSectionしてカスタムセクションにアクセスする方法を示しています。The following example shows how to use the GetSection method to access a custom section. CustomSectionセクションの情報を格納するクラスを定義する完全なコード例についてはConfiguration 、「クラスの概要」を参照してください。For the complete example code that defines a class that stores information for the CustomSection section, see the Configuration class overview.

// Show how to use the GetSection(string) method.
static void GetCustomSection()
{
    try
    {

        CustomSection customSection;

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

        customSection =
            config.GetSection("CustomSection") as CustomSection;

        Console.WriteLine("Section name: {0}", customSection.Name);
        Console.WriteLine("Url: {0}", customSection.Url);
        Console.WriteLine("Port: {0}", customSection.Port);

    }
    catch (ConfigurationErrorsException err)
    {
        Console.WriteLine("Using GetSection(string): {0}", err.ToString());
    }

}
' Show how to use the GetSection(string) method.
Public Shared Sub GetCustomSection()
    Try

        Dim customSection As CustomSection

        ' Get the current configuration file.
        Dim config As System.Configuration.Configuration = TryCast(ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None), Configuration)

        customSection = TryCast(config.GetSection("CustomSection"), CustomSection)

        Console.WriteLine("Section name: {0}", customSection.Name)
        Console.WriteLine("Url: {0}", customSection.Url)
        Console.WriteLine("Port: {0}", customSection.Port)

    Catch err As ConfigurationErrorsException
        Console.WriteLine("Using GetSection(string): {0}", err.ToString())
    End Try

End Sub

注釈

構成設定は、便宜上、類似した設定をグループ化するセクション内に含まれています。Configuration settings are contained within sections that group similar settings together for convenience. メソッドGetSectionは、名前を指定して構成セクションを取得します。The GetSection method retrieves a configuration section by its name.

適用対象