SectionInformation SectionInformation SectionInformation SectionInformation Class

Определение

Содержит метаданные об отдельном разделе в пределах иерархии конфигурации.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
Наследование
SectionInformationSectionInformationSectionInformationSectionInformation

Примеры

В следующем примере показано, как получить 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 AllowDefinition AllowDefinition AllowDefinition

Возвращает или задает значение, указывающее, где в иерархии файла конфигурации можно определить связанный раздел конфигурации.Gets or sets a value that indicates where in the configuration file hierarchy the associated configuration section can be defined.

AllowExeDefinition AllowExeDefinition AllowExeDefinition AllowExeDefinition

Возвращает или задает значение, указывающее, где в иерархии файла конфигурации можно объявить связанный раздел конфигурации.Gets or sets a value that indicates where in the configuration file hierarchy the associated configuration section can be declared.

AllowLocation AllowLocation AllowLocation AllowLocation

Возвращает или задает значение, указывающее, допускает ли раздел конфигурации атрибут location.Gets or sets a value that indicates whether the configuration section allows the location attribute.

AllowOverride AllowOverride AllowOverride AllowOverride

Возвращает или задает значение, указывающее, может ли связанный раздел конфигурации быть переопределен файлами конфигурации более низкого уровня.Gets or sets a value that indicates whether the associated configuration section can be overridden by lower-level configuration files.

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

Получает объект ConfigurationBuilder для этого раздела конфигурации.Gets the ConfigurationBuilder object for this configuration section.

ForceSave ForceSave ForceSave ForceSave

Возвращает или задает значение, указывающее, будет ли сохраняться связанный раздел конфигурации, даже если он не был изменен.Gets or sets a value that indicates whether the associated configuration section will be saved even if it has not been modified.

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

Возвращает значение, указывающее, должен ли раздел конфигурации быть объявлен в файле конфигурации.Gets a value that indicates whether the configuration section must be declared in the configuration file.

IsDeclared IsDeclared IsDeclared IsDeclared

Возвращает значение, указывающее, объявлен ли раздел конфигурации в файле конфигурации.Gets a value that indicates whether the associated configuration section is declared in the configuration file.

IsLocked IsLocked IsLocked IsLocked

Возвращает значение, указывающее, заблокирован ли связанный раздел конфигурации.Gets a value that indicates whether the associated configuration section is locked.

IsProtected IsProtected IsProtected IsProtected

Возвращает значение, указывающее, защищен ли связанный раздел конфигурации.Gets a value that indicates whether the associated configuration section is protected.

Name Name Name Name

Возвращает имя связанного раздела конфигурации.Gets the name of the associated configuration section.

OverrideMode OverrideMode OverrideMode OverrideMode

Возвращает или задает значение перечисления OverrideMode, указывающее, может ли связанный раздел конфигурации быть переопределен дочерними файлами конфигурации.Gets or sets the OverrideMode enumeration value that specifies whether the associated configuration section can be overridden by child configuration files.

OverrideModeDefault OverrideModeDefault OverrideModeDefault OverrideModeDefault

Возвращает или задает значение, указывающее поведение по умолчанию переопределения раздела конфигурации дочерними файлами конфигурации.Gets or sets a value that specifies the default override behavior of a configuration section by child configuration files.

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

Возвращает поставщик защищенной конфигурации для связанного раздела конфигурации.Gets the protected configuration provider for the associated configuration section.

RequirePermission RequirePermission RequirePermission RequirePermission

Возвращает значение, указывающее, требует ли связанный раздел конфигурации прав доступа.Gets a value that indicates whether the associated configuration section requires access permissions.

RestartOnExternalChanges RestartOnExternalChanges RestartOnExternalChanges RestartOnExternalChanges

Возвращает или задает значение, указывающее, требует ли изменение во внешнем включаемом файле конфигурации перезапуска приложения.Gets or sets a value that specifies whether a change in an external configuration include file requires an application restart.

SectionName SectionName SectionName SectionName

Возвращает имя связанного раздела конфигурации.Gets the name of the associated configuration section.

Type Type Type Type

Возвращает или задает имя класса раздела.Gets or sets the section class name.

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
ForceDeclaration() ForceDeclaration() ForceDeclaration() ForceDeclaration()

Принудительно записывает связанный раздел конфигурации в файле конфигурации.Forces the associated configuration section to appear in the configuration file.

ForceDeclaration(Boolean) ForceDeclaration(Boolean) ForceDeclaration(Boolean) ForceDeclaration(Boolean)

Принудительно записывает связанный раздел конфигурации в файле конфигурации или удаляет существующий раздел из файла конфигурации.Forces the associated configuration section to appear in the configuration file, or removes an existing section from the configuration file.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetParentSection() GetParentSection() GetParentSection() GetParentSection()

Возвращает раздел конфигурации, содержащий раздел конфигурации, связанный с данным объектом.Gets the configuration section that contains the configuration section associated with this object.

GetRawXml() GetRawXml() GetRawXml() GetRawXml()

Возвращает объект узла XML, который представляет связанный объект раздела конфигурации.Returns an XML node object that represents the associated configuration-section object.

GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ProtectSection(String) ProtectSection(String) ProtectSection(String) ProtectSection(String)

Отмечает раздел конфигурации для защиты.Marks a configuration section for protection.

RevertToParent() RevertToParent() RevertToParent() RevertToParent()

Заставляет связанный раздел конфигурации наследовать все значения из родительского раздела.Causes the associated configuration section to inherit all its values from the parent section.

SetRawXml(String) SetRawXml(String) SetRawXml(String) SetRawXml(String)

Присваивает объекту XML-представление связанного раздела конфигурации в пределах файла конфигурации.Sets the object to an XML representation of the associated configuration section within the configuration file.

ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)
UnprotectSection() UnprotectSection() UnprotectSection() UnprotectSection()

Снимает шифрование защищенной конфигурации со связанного раздела конфигурации.Removes the protected configuration encryption from the associated configuration section.

Применяется к

Дополнительно