SectionInformation Classe

Definição

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacote:

System.Configuration.ConfigurationManager v8.0.0

Origem:

SectionInformation.cs

Contém metadados sobre uma seção individual dentro da hierarquia de configuração. Essa classe não pode ser herdada.

public ref class SectionInformation sealed

public sealed class SectionInformation

type SectionInformation = class

Public NotInheritable Class SectionInformation

Herança

Object

SectionInformation

Exemplos

O exemplo a seguir mostra como obter os SectionInformation metadados associados a um ConfigurationSection objeto .

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

O exemplo a seguir é um trecho do arquivo de configuração usado pelo exemplo anterior.

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

Comentários

O SectionInformation objeto contém os metadados sobre uma seção individual dentro da hierarquia de configuração. Esse objeto pode ser usado para validar e alterar as propriedades de uma seção individual.

Propriedades

AllowDefinition	Obtém ou define um valor que indica o local na hierarquia do arquivo de configuração em que a seção de configuração associada pode ser definida.
AllowExeDefinition	Obtém ou define um valor que indica o local na hierarquia do arquivo de configuração em que a seção de configuração associada pode ser declarada.
AllowLocation	Obtém ou define um valor que indica se a seção de configuração permite usar o atributo location.
AllowOverride	Obtém ou define um valor que indica se a seção de configuração associada pode ser substituída por arquivos de configuração de nível inferior.
ConfigSource	Obtém ou define o nome do arquivo de inclusão no qual a seção de configuração associado é definida, se existir tal arquivo.
ForceSave	Obtém ou define um valor que indica se a seção de configuração associada será salva mesmo se ela não tiver sido modificada.
InheritInChildApplications	Obtém ou define um valor que indica se as configurações especificadas na seção de configuração associada são herdadas por aplicativos que residem em um subdiretório do aplicativo relevante.
IsDeclarationRequired	Obtém um valor que indica se a seção de configuração deve ser declarada no arquivo de configuração.
IsDeclared	Obtém um valor que indica se a seção de configuração associada está declarada no arquivo de configuração.
IsLocked	Obtém um valor que indica se a seção de configuração associada está bloqueada.
IsProtected	Obtém um valor que indica se a seção de configuração associada está protegida.
Name	Obtém o nome da seção de configuração associada.
OverrideMode	Obtém ou define o valor de enumeração OverrideMode que especifica se a seção de configuração associada pode ser substituída por arquivos de configuração filho.
OverrideModeDefault	Obtém ou define um valor que especifica o comportamento de substituição padrão de uma seção de configuração por arquivos de configuração filho.
OverrideModeEffective	Obtém o comportamento de substituição de uma seção de configuração que, por sua vez, depende se os arquivos de configuração filho podem bloquear a seção de configuração.
ProtectionProvider	Obtém o provedor de configuração protegido para a seção de configuração associada.
RequirePermission	Obtém um valor que indica se a seção de configuração associada requer permissões de acesso.
RestartOnExternalChanges	Obtém ou define um valor que especifica se uma alteração em um arquivo de inclusão de configuração externa exige uma reinicialização do aplicativo.
SectionName	Obtém o nome da seção de configuração associada.
Type	Obtém ou define o nome de classe da seção.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
ForceDeclaration()	Força a seção de configuração associada a aparecer no arquivo de configuração.
ForceDeclaration(Boolean)	Força a seção de configuração associada a ser exibida no arquivo de configuração ou remove uma seção existente do arquivo de configuração.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetParentSection()	Obtém a seção de configuração que contém a seção de configuração associada a este objeto.
GetRawXml()	Retorna um objeto de nó XML que representa o objeto da seção de configuração associada.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ProtectSection(String)	Marca uma seção de configuração para proteção.
RevertToParent()	Faz a seção de configuração associada herdar todos os seus valores da seção pai.
SetRawXml(String)	Define o objeto como uma representação XML da seção de configuração associada dentro do arquivo de configuração.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
UnprotectSection()	Remove a criptografia de configuração protegida da seção de configuração associada.

Confira também

• ConfigurationSection