SectionInformation クラス

定義

構成階層内の個々のセクションのメタデータが含まれています。Contains metadata about an individual section within the configuration hierarchy. このクラスは継承できません。This class cannot be inherited.

public ref class SectionInformation sealed
public sealed class SectionInformation
type SectionInformation = class
Public NotInheritable Class SectionInformation
継承
SectionInformation

次の例は、 SectionInformation ConfigurationSectionオブジェクトに関連付けられているメタデータを取得する方法を示しています。The following example shows how to get the SectionInformation metadata that is associated with a ConfigurationSection object.

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;

}
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
 

次の例は、前の例で使用した構成ファイルの抜粋です。The following example is an excerpt of the configuration file that is used by the previous example.

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

注釈

オブジェクトSectionInformationには、構成階層内の個々のセクションに関するメタデータが含まれています。The SectionInformation object contains the metadata about an individual section within the configuration hierarchy. このオブジェクトは、個々のセクションのプロパティを検証および変更するために使用できます。This object can be used in order to validate and change the properties of an individual section.

プロパティ

AllowDefinition

構成ファイル階層内の、関連付けられている構成セクションを定義できる位置を示す値を取得または設定します。Gets or sets a value that indicates where in the configuration file hierarchy the associated configuration section can be defined.

AllowExeDefinition

構成ファイル階層内の、関連付けられている構成セクションを宣言できる位置を示す値を取得または設定します。Gets or sets a value that indicates where in the configuration file hierarchy the associated configuration section can be declared.

AllowLocation

構成セクションで location 属性を使用できるかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the configuration section allows the location attribute.

AllowOverride

関連付けられている構成セクションを下位レベルの構成ファイルでオーバーライドできるかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the associated configuration section can be overridden by lower-level configuration files.

ConfigSource

関連付けられている構成セクションが定義されたインクルード ファイルが存在する場合は、その名前を取得または設定します。Gets or sets the name of the include file in which the associated configuration section is defined, if such a file exists.

ConfigurationBuilder

この構成セクションの ConfigurationBuilder オブジェクトを取得します。Gets the ConfigurationBuilder object for this configuration section.

ForceSave

関連付けられている構成セクションが変更されていない場合も保存されるかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the associated configuration section will be saved even if it has not been modified.

InheritInChildApplications

関連する構成セクションで指定されている設定を、関連アプリケーションのサブディレクトリにあるアプリケーションが継承するかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the settings that are specified in the associated configuration section are inherited by applications that reside in a subdirectory of the relevant application.

IsDeclarationRequired

構成セクションが構成ファイルで定義される必要があるかどうかを示す値を取得します。Gets a value that indicates whether the configuration section must be declared in the configuration file.

IsDeclared

関連付けられている構成セクションが構成ファイルで定義されているかどうかを示す値を取得します。Gets a value that indicates whether the associated configuration section is declared in the configuration file.

IsLocked

関連付けられている構成セクションがロックされているかどうかを示す値を取得します。Gets a value that indicates whether the associated configuration section is locked.

IsProtected

関連付けられている構成セクションが保護されているかどうかを示す値を取得します。Gets a value that indicates whether the associated configuration section is protected.

Name

関連付けられている構成セクションの名前を取得します。Gets the name of the associated configuration section.

OverrideMode

関連付けられている構成セクションを子構成ファイルでオーバーライドできるかどうかを示す OverrideMode 列挙値を取得または設定します。Gets or sets the OverrideMode enumeration value that specifies whether the associated configuration section can be overridden by child configuration files.

OverrideModeDefault

子構成ファイルによる構成セクションの既定のオーバーライド動作を示す値を取得または設定します。Gets or sets a value that specifies the default override behavior of a configuration section by child configuration files.

OverrideModeEffective

構成セクションを子構成ファイルでロックできるかどうかということに基づく、その構成セクションのオーバーライド動作を取得します。Gets the override behavior of a configuration section that is in turn based on whether child configuration files can lock the configuration section.

ProtectionProvider

関連付けられている構成セクションの保護された構成プロバイダーを取得します。Gets the protected configuration provider for the associated configuration section.

RequirePermission

関連付けられている構成セクションがアクセス許可を必要とするかどうかを示す値を取得します。Gets a value that indicates whether the associated configuration section requires access permissions.

RestartOnExternalChanges

外部構成インクルード ファイルが変更されたときにアプリケーションの再起動が必要かどうかを示す値を取得または設定します。Gets or sets a value that specifies whether a change in an external configuration include file requires an application restart.

SectionName

関連付けられている構成セクションの名前を取得します。Gets the name of the associated configuration section.

Type

セクションのクラス名を取得または設定します。Gets or sets the section class name.

メソッド

Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(継承元 Object)
ForceDeclaration()

関連付けられている構成セクションを強制的に構成ファイルに表示します。Forces the associated configuration section to appear in the configuration file.

ForceDeclaration(Boolean)

関連付けられている構成セクションを強制的に構成ファイルに表示したり、既存のセクションを構成ファイルから削除したりします。Forces the associated configuration section to appear in the configuration file, or removes an existing section from the configuration file.

GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)
GetParentSection()

このオブジェクトに関連付けられている構成セクションが含まれている構成セクションを取得します。Gets the configuration section that contains the configuration section associated with this object.

GetRawXml()

関連付けられている構成セクション オブジェクトを表す XML ノード オブジェクトを返します。Returns an XML node object that represents the associated configuration-section object.

GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
ProtectSection(String)

保護の構成セクションをマークします。Marks a configuration section for protection.

RevertToParent()

関連付けられている構成セクションのすべての値がその親セクションから継承されます。Causes the associated configuration section to inherit all its values from the parent section.

SetRawXml(String)

オブジェクトを、構成ファイル内の関連付けられている構成セクションの XML 表現に設定します。Sets the object to an XML representation of the associated configuration section within the configuration file.

ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(継承元 Object)
UnprotectSection()

関連付けられている構成セクションの保護された構成の暗号化を解除します。Removes the protected configuration encryption from the associated configuration section.

適用対象

こちらもご覧ください