SectionInformation Classe

Definição

Contém metadados sobre uma seção individual dentro da hierarquia de configuração.Contains metadata about an individual section within the configuration hierarchy. Essa classe não pode ser herdada.This class cannot be inherited.

public ref class SectionInformation sealed
public sealed class SectionInformation
type SectionInformation = class
Public NotInheritable Class SectionInformation
Herança
SectionInformation

Exemplos

O exemplo a seguir mostra como obter os SectionInformation metadados associados a um ConfigurationSection objeto.The following example shows how to get the SectionInformation metadata that is associated with a ConfigurationSection object.

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 que é usado pelo exemplo anterior.The following example is an excerpt of the configuration file that is used by the previous example.

<?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.The SectionInformation object contains the metadata about an individual section within the configuration hierarchy. Esse objeto pode ser usado para validar e alterar as propriedades de uma seção individual.This object can be used in order to validate and change the properties of an individual section.

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.Gets or sets a value that indicates where in the configuration file hierarchy the associated configuration section can be defined.

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.Gets or sets a value that indicates where in the configuration file hierarchy the associated configuration section can be declared.

AllowLocation

Obtém ou define um valor que indica se a seção de configuração permite usar o atributo location.Gets or sets a value that indicates whether the configuration section allows the location attribute.

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.Gets or sets a value that indicates whether the associated configuration section can be overridden by lower-level configuration files.

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.Gets or sets the name of the include file in which the associated configuration section is defined, if such a file exists.

ConfigurationBuilder

Obtém o objeto ConfigurationBuilder para essa seção de configuração.Gets the ConfigurationBuilder object for this configuration section.

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.Gets or sets a value that indicates whether the associated configuration section will be saved even if it has not been modified.

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.Gets or sets a value that indicates whether the settings that are specified in the associated configuration section are inherited by applications that reside in a subdirectory of the relevant application.

IsDeclarationRequired

Obtém um valor que indica se a seção de configuração deve ser declarada no arquivo de configuração.Gets a value that indicates whether the configuration section must be declared in the configuration file.

IsDeclared

Obtém um valor que indica se a seção de configuração associada está declarada no arquivo de configuração.Gets a value that indicates whether the associated configuration section is declared in the configuration file.

IsLocked

Obtém um valor que indica se a seção de configuração associada está bloqueada.Gets a value that indicates whether the associated configuration section is locked.

IsProtected

Obtém um valor que indica se a seção de configuração associada está protegida.Gets a value that indicates whether the associated configuration section is protected.

Name

Obtém o nome da seção de configuração associada.Gets the name of the associated configuration section.

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.Gets or sets the OverrideMode enumeration value that specifies whether the associated configuration section can be overridden by child configuration files.

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.Gets or sets a value that specifies the default override behavior of a configuration section by child configuration files.

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.Gets the override behavior of a configuration section that is in turn based on whether child configuration files can lock the configuration section.

ProtectionProvider

Obtém o provedor de configuração protegido para a seção de configuração associada.Gets the protected configuration provider for the associated configuration section.

RequirePermission

Obtém um valor que indica se a seção de configuração associada requer permissões de acesso.Gets a value that indicates whether the associated configuration section requires access permissions.

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.Gets or sets a value that specifies whether a change in an external configuration include file requires an application restart.

SectionName

Obtém o nome da seção de configuração associada.Gets the name of the associated configuration section.

Type

Obtém ou define o nome de classe da seção.Gets or sets the section class name.

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
ForceDeclaration()

Força a seção de configuração associada a aparecer no arquivo de configuração.Forces the associated configuration section to appear in the configuration file.

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.Forces the associated configuration section to appear in the configuration file, or removes an existing section from the configuration file.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(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.Gets the configuration section that contains the configuration section associated with this object.

GetRawXml()

Retorna um objeto de nó XML que representa o objeto da seção de configuração associada.Returns an XML node object that represents the associated configuration-section object.

GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
ProtectSection(String)

Marca uma seção de configuração para proteção.Marks a configuration section for protection.

RevertToParent()

Faz a seção de configuração associada herdar todos os seus valores da seção pai.Causes the associated configuration section to inherit all its values from the parent section.

SetRawXml(String)

Define o objeto como uma representação XML da seção de configuração associada dentro do arquivo de configuração.Sets the object to an XML representation of the associated configuration section within the configuration file.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)
UnprotectSection()

Remove a criptografia de configuração protegida da seção de configuração associada.Removes the protected configuration encryption from the associated configuration section.

Aplica-se a

Veja também