SectionInformation Classe

Definição

Espaço de Nomes:: System.Configuration

Assemblagem:: System.Configuration.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Contém metadados sobre uma secção individual dentro da hierarquia de configuração. Esta 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 seguinte 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 seguinte é um excerto do ficheiro de configuração utilizado 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>

Observações

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

Propriedades

Name	Description
AllowDefinition	Recebe ou define um valor que indica onde, na hierarquia do ficheiro de configuração, a secção de configuração associada pode ser definida.
AllowExeDefinition	Recebe ou define um valor que indica onde, na hierarquia do ficheiro de configuração, a secção de configuração associada pode ser declarada.
AllowLocation	Recebe ou define um valor que indica se a secção de configuração permite o `location` atributo.
AllowOverride	Recebe ou define um valor que indica se a secção de configuração associada pode ser sobreposta por ficheiros de configuração de nível inferior.
ConfigSource	Recebe ou define o nome do ficheiro de inclusão onde a secção de configuração associada está definida, caso tal ficheiro exista.
ConfigurationBuilder	Obtém o ConfigurationBuilder objeto para esta secção de configuração.
ForceSave	Recebe ou define um valor que indica se a secção de configuração associada será guardada mesmo que não tenha sido modificada.
InheritInChildApplications	Recebe ou define um valor que indica se as definições especificadas na secção de configuração associada são herdadas por aplicações que residem num subdiretório da aplicação relevante.
IsDeclarationRequired	Recebe um valor que indica se a secção de configuração deve ser declarada no ficheiro de configuração.
IsDeclared	Recebe um valor que indica se a secção de configuração associada está declarada no ficheiro de configuração.
IsLocked	Recebe um valor que indica se a secção de configuração associada está bloqueada.
IsProtected	Recebe um valor que indica se a secção de configuração associada está protegida.
Name	Recebe o nome da secção de configuração associada.
OverrideMode	Obtém ou define o OverrideMode valor de enumeração que especifica se a secção de configuração associada pode ser sobreposta por ficheiros de configuração filhos.
OverrideModeDefault	Obtém ou define um valor que especifica o comportamento padrão de sobreposição de uma secção de configuração por ficheiros de configuração filhos.
OverrideModeEffective	Obtém o comportamento de sobreposição de uma secção de configuração que, por sua vez, depende se os ficheiros de configuração filhos conseguem bloquear a secção de configuração.
ProtectionProvider	Obtém o fornecedor de configuração protegida para a secção de configuração associada.
RequirePermission	Recebe um valor que indica se a secção de configuração associada requer permissões de acesso.
RestartOnExternalChanges	Recebe ou define um valor que especifica se uma alteração num ficheiro de inclusão de configuração externa requer um reinício da aplicação.
SectionName	Recebe o nome da secção de configuração associada.
Type	Recebe ou define o nome da classe da secção.

Métodos

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

Aplica-se a

Ver também

ConfigurationSection

Comentários

Esta página foi útil?