SectionInformation

.NET Framework クラス ライブラリ リファレンス

SectionInformation クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

構成内の個々のセクションのメタ情報が含まれています。このクラスは継承できません。

名前空間: System.Configuration
アセンブリ: System.Configuration (system.configuration.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 SectionInformation

Visual Basic (使用法)

Dim instance As SectionInformation

C#

public sealed class SectionInformation

C++

public ref class SectionInformation sealed

J#

public final class SectionInformation

JScript

public final class SectionInformation

解説

SectionInformation オブジェクトには、構成内の個々のセクションのメタ情報が含まれています。このオブジェクトは、個々のセクションのプロパティの検証や変更を行う場合に使用できます。

使用例

ConfigurationSection オブジェクトに関連付けられている SectionInformation を取得する方法のコード例を次に示します。

Visual Basic

Public Shared Function GetSectionInformation()
 _
As SectionInformation

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

    ' Get the section.
    Dim section As UrlsSection = _
    CType(config.GetSection("MyUrls"), UrlsSection)

    Dim sInfo As SectionInformation = _
    section.SectionInformation

    Return sInfo

End Function 'GetSectionInformation
 

C#

static public SectionInformation 
    GetSectionInformation()
{

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

    // Get the section.
    UrlsSection section =
        (UrlsSection)config.GetSection("MyUrls");

    
    SectionInformation sInfo = 
        section.SectionInformation;

    return sInfo;

}

前述のコード例で使用されている構成の抜粋を次に示します。

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <configSections>
    <section name="MyUrls" type="Samples.AspNet.UrlsSection,
      ConfigurationElement, Version=1.0.0.0, Culture=neutral,
      PublicKeyToken=null" allowDefinition="Everywhere"
      allowExeDefinition="MachineToApplication"
      restartOnExternalChanges="true" />
  </configSections>
  <MyUrls name="MyFavorites">
    <simple name="Contoso" url="http://www.contoso.com" port="8080" />
    <urls>
      <clear />
       <add name="Microsoft" url="http://www.microsoft.com" port="0" />
    </urls>
  </MyUrls>
</configuration>

継承階層

System.Object
  System.Configuration.SectionInformation

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SectionInformation メンバ
System.Configuration 名前空間
ConfigurationSection クラス

SectionInformation プロパティ

パブリック プロパティ

	名前	説明
	AllowDefinition	構成ファイル階層内の、関連付けられている構成セクションを定義できる位置を示す値を取得または設定します。
	AllowExeDefinition	構成ファイル階層内の、関連付けられている構成セクションを宣言できる位置を示す値を取得または設定します。
	AllowLocation	構成セクションで location 属性を使用できるかどうかを示す値を取得または設定します。
	AllowOverride	関連付けられている構成セクションを下位レベルの構成ファイルでオーバーライドできるかどうかを示す値を取得または設定します。
	ConfigSource	関連付けられている構成セクションが定義されたインクルード ファイルが存在する場合は、その名前を取得または設定します。
	ForceSave	関連付けられている構成セクションが変更されていない場合も保存されるかどうかを示す値を取得または設定します。
	InheritInChildApplications	関連付けられている構成セクション内で指定されている設定が、その関連付けられている構成セクションが適用されるアプリケーションのサブディレクトリ内に存在するアプリケーションに継承されるかどうかを示す値を取得または設定します。
	IsDeclarationRequired	関連付けられている構成セクションが構成ファイルで定義される必要があるかどうかを示す値を取得します。
	IsDeclared	関連付けられている構成セクションが構成ファイルで定義されているかどうかを示す値を取得します。
	IsLocked	関連付けられている構成セクションがロックされているかどうかを示す値を取得します。
	IsProtected	関連付けられている構成セクションが保護されているかどうかを示す値を取得します。
	Name	関連付けられている構成セクションの名前を取得します。
	ProtectionProvider	関連付けられている構成セクションの保護された構成プロバイダを取得します。
	RequirePermission	関連付けられている構成セクションがアクセス許可を必要とするかどうかを示す値を取得します。
	RestartOnExternalChanges	外部構成インクルード ファイルが変更されたときにアプリケーションの再起動が必要かどうかを示す値を取得または設定します。
	SectionName	関連付けられている構成セクションの名前を取得します。
	Type	セクションのクラス名を取得または設定します。

参照

関連項目

SectionInformation クラス
System.Configuration 名前空間
ConfigurationSection クラス

SectionInformation メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	ForceDeclaration	オーバーロードされます。 関連付けられている構成セクションを強制的に構成ファイルに表示します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetParentSection	このオブジェクトに関連付けられている構成セクションが含まれている構成セクションを取得します。
	GetRawXml	関連付けられている構成セクション オブジェクトを表す XML ノード オブジェクトを返します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ProtectSection	構成セクションを保護対象としてマークします。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	RevertToParent	関連付けられている構成セクションのすべての値がその親セクションから継承されます。
	SetRawXml	オブジェクトを、構成ファイル内の関連付けられている構成セクションの XML 表現に設定します。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)
	UnprotectSection	関連付けられている構成セクションの保護された構成の暗号化を解除します。

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

SectionInformation クラス
System.Configuration 名前空間
ConfigurationSection クラス

SectionInformation メンバ

構成内の個々のセクションのメタ情報が含まれています。このクラスは継承できません。

SectionInformation データ型で公開されるメンバを以下の表に示します。

パブリック プロパティ

	名前	説明
	AllowDefinition	構成ファイル階層内の、関連付けられている構成セクションを定義できる位置を示す値を取得または設定します。
	AllowExeDefinition	構成ファイル階層内の、関連付けられている構成セクションを宣言できる位置を示す値を取得または設定します。
	AllowLocation	構成セクションで location 属性を使用できるかどうかを示す値を取得または設定します。
	AllowOverride	関連付けられている構成セクションを下位レベルの構成ファイルでオーバーライドできるかどうかを示す値を取得または設定します。
	ConfigSource	関連付けられている構成セクションが定義されたインクルード ファイルが存在する場合は、その名前を取得または設定します。
	ForceSave	関連付けられている構成セクションが変更されていない場合も保存されるかどうかを示す値を取得または設定します。
	InheritInChildApplications	関連付けられている構成セクション内で指定されている設定が、その関連付けられている構成セクションが適用されるアプリケーションのサブディレクトリ内に存在するアプリケーションに継承されるかどうかを示す値を取得または設定します。
	IsDeclarationRequired	関連付けられている構成セクションが構成ファイルで定義される必要があるかどうかを示す値を取得します。
	IsDeclared	関連付けられている構成セクションが構成ファイルで定義されているかどうかを示す値を取得します。
	IsLocked	関連付けられている構成セクションがロックされているかどうかを示す値を取得します。
	IsProtected	関連付けられている構成セクションが保護されているかどうかを示す値を取得します。
	Name	関連付けられている構成セクションの名前を取得します。
	ProtectionProvider	関連付けられている構成セクションの保護された構成プロバイダを取得します。
	RequirePermission	関連付けられている構成セクションがアクセス許可を必要とするかどうかを示す値を取得します。
	RestartOnExternalChanges	外部構成インクルード ファイルが変更されたときにアプリケーションの再起動が必要かどうかを示す値を取得または設定します。
	SectionName	関連付けられている構成セクションの名前を取得します。
	Type	セクションのクラス名を取得または設定します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	ForceDeclaration	オーバーロードされます。 関連付けられている構成セクションを強制的に構成ファイルに表示します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetParentSection	このオブジェクトに関連付けられている構成セクションが含まれている構成セクションを取得します。
	GetRawXml	関連付けられている構成セクション オブジェクトを表す XML ノード オブジェクトを返します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ProtectSection	構成セクションを保護対象としてマークします。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	RevertToParent	関連付けられている構成セクションのすべての値がその親セクションから継承されます。
	SetRawXml	オブジェクトを、構成ファイル内の関連付けられている構成セクションの XML 表現に設定します。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)
	UnprotectSection	関連付けられている構成セクションの保護された構成の暗号化を解除します。

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

SectionInformation クラス
System.Configuration 名前空間
ConfigurationSection クラス