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 |
Возвращает или задает значение, указывающее, допускает ли раздел конфигурации атрибут |
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() |
Удаляет шифрование защищенной конфигурации из связанного раздела конфигурации. |