Поделиться через


SectionInformation Класс

Определение

Содержит метаданные об отдельном разделе в пределах иерархии конфигурации. Этот класс не наследуется.

public ref class SectionInformation sealed
public sealed class SectionInformation
type SectionInformation = class
Public NotInheritable Class SectionInformation
Наследование
SectionInformation

Примеры

В следующем примере показано, как получить метаданные SectionInformation , связанные с ConfigurationSection объектом .

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

Следующий пример представляет собой фрагмент файла конфигурации, который используется в предыдущем примере.

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

Свойства

AllowDefinition

Возвращает или задает значение, указывающее, где в иерархии файла конфигурации можно определить связанный раздел конфигурации.

AllowExeDefinition

Возвращает или задает значение, указывающее, где в иерархии файла конфигурации можно объявить связанный раздел конфигурации.

AllowLocation

Возвращает или задает значение, указывающее, допускает ли раздел конфигурации атрибут location.

AllowOverride

Возвращает или задает значение, указывающее, может ли связанный раздел конфигурации быть переопределен файлами конфигурации более низкого уровня.

ConfigSource

Возвращает или задает имя включаемого файла, в котором определен связанный раздел конфигурации, если такой файл существует.

ConfigurationBuilder

Получает объект ConfigurationBuilder для этого раздела конфигурации.

ForceSave

Возвращает или задает значение, указывающее, будет ли сохраняться связанный раздел конфигурации, даже если он не был изменен.

InheritInChildApplications

Возвращает или задает значение, указывающее, наследуют ли приложения, находящиеся в подкаталоге соответствующего приложения, параметры, установленные в связанном разделе конфигурации.

IsDeclarationRequired

Возвращает значение, указывающее, должен ли раздел конфигурации быть объявлен в файле конфигурации.

IsDeclared

Возвращает значение, указывающее, объявлен ли раздел конфигурации в файле конфигурации.

IsLocked

Возвращает значение, указывающее, заблокирован ли связанный раздел конфигурации.

IsProtected

Возвращает значение, указывающее, защищен ли связанный раздел конфигурации.

Name

Возвращает имя связанного раздела конфигурации.

OverrideMode

Возвращает или задает значение перечисления OverrideMode, указывающее, может ли связанный раздел конфигурации быть переопределен дочерними файлами конфигурации.

OverrideModeDefault

Возвращает или задает значение, указывающее поведение по умолчанию переопределения раздела конфигурации дочерними файлами конфигурации.

OverrideModeEffective

Возвращает поведение переопределения раздела конфигурации, которое зависит от того, могут ли дочерние файлы конфигурации блокировать раздел конфигурации.

ProtectionProvider

Возвращает поставщик защищенной конфигурации для связанного раздела конфигурации.

RequirePermission

Возвращает значение, указывающее, требует ли связанный раздел конфигурации прав доступа.

RestartOnExternalChanges

Возвращает или задает значение, указывающее, требует ли изменение во внешнем включаемом файле конфигурации перезапуска приложения.

SectionName

Возвращает имя связанного раздела конфигурации.

Type

Возвращает или задает имя класса раздела.

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
ForceDeclaration()

Принудительно записывает связанный раздел конфигурации в файле конфигурации.

ForceDeclaration(Boolean)

Принудительно записывает связанный раздел конфигурации в файле конфигурации или удаляет существующий раздел из файла конфигурации.

GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetParentSection()

Возвращает раздел конфигурации, содержащий раздел конфигурации, связанный с данным объектом.

GetRawXml()

Возвращает объект узла XML, который представляет связанный объект раздела конфигурации.

GetType()

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

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
ProtectSection(String)

Отмечает раздел конфигурации для защиты.

RevertToParent()

Заставляет связанный раздел конфигурации наследовать все значения из родительского раздела.

SetRawXml(String)

Присваивает объекту XML-представление связанного раздела конфигурации в пределах файла конфигурации.

ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)
UnprotectSection()

Удаляет шифрование защищенной конфигурации из связанного раздела конфигурации.

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

См. также раздел