SectionInformation Classe

  • Referência

Definição

Namespace:
System.Configuration
Assembly:
System.Configuration.ConfigurationManager.dll
Assembly:
System.Configuration.dll
Pacote:
System.Configuration.ConfigurationManager v6.0.0
Pacote:
System.Configuration.ConfigurationManager v7.0.0
Pacote:
System.Configuration.ConfigurationManager v8.0.0
Pacote:
System.Configuration.ConfigurationManager v9.0.0-preview.2.24128.5
Origem:
SectionInformation.cs
Origem:
SectionInformation.cs
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.
ConfigurationBuilder

Obtém o objeto ConfigurationBuilder para essa seção de configuração.
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.

Aplica-se a

Confira também