SectionInformation.ConfigSource Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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, setPublic Property ConfigSource As StringValor da propriedade
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.
