SectionInformation Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Содержит метаданные отдельного раздела в иерархии конфигурации. Этот класс не наследуется.
public ref class SectionInformation sealedpublic sealed class SectionInformationtype SectionInformation = classPublic 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() |
Удаляет шифрование защищенной конфигурации из связанного раздела конфигурации. |
