SectionInformation.ConfigSource Propriedade

Definição

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacote:

System.Configuration.ConfigurationManager v8.0.0

Origem:

SectionInformation.cs

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.

public:
 property System::String ^ ConfigSource { System::String ^ get(); void set(System::String ^ value); };

public string ConfigSource { get; set; }

member this.ConfigSource : string with get, set

Public Property ConfigSource As String

Valor da propriedade

String

O nome do arquivo de inclusão no qual o ConfigurationSection associado é definido, se tal arquivo existir; caso contrário, uma cadeia de caracteres vazia ("").

Comentários

A ConfigSource propriedade representa o valor do configSource atributo especificado para um ConfigurationSection objeto associado ao SectionInformation objeto .

Opcionalmente ConfigurationSection , uma implementação pode especificar um arquivo separado no qual as definições de configuração para essa seção são definidas. Isso pode ser útil de várias maneiras:

• Usar arquivos de inclusão pode resultar em uma estrutura mais lógica e modular para arquivos de configuração.

• A segurança e as permissões de acesso a arquivos podem ser usadas para restringir o acesso a seções de definições de configuração.

• As configurações em um arquivo de inclusão que não são usadas durante a inicialização do aplicativo podem ser modificadas e recarregadas sem a necessidade de uma reinicialização do aplicativo.

O exemplo a seguir mostra como esse atributo é usado em um arquivo de configuração para especificar que a pages seção é definida em um arquivo de inclusão externo:

<pages configSource="pages.config"/>

Se qualquer uma das configurações em um arquivo de configuração incluir exigir que o aplicativo seja reiniciado quando for modificado, defina a RestartOnExternalChanges propriedade como true.

Em aplicativos ASP.NET, em tempo de execução, você pode atribuir à propriedade o ConfigSource nome de um arquivo de configuração alternativo. Nesse caso, o conteúdo do arquivo é substituído pelas informações de cadeia de conexão padrão contidas no arquivo Web.config. Isso também ocorre quando o arquivo alternativo não existe e é criado em tempo de execução. Se o arquivo Web.config não contiver nenhuma informação de cadeia de conexão, uma seção vazia será adicionada ao arquivo alternativo.

Confira também

• RestartOnExternalChanges