SectionInformation.ConfigSource Propriedade
Definição
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.
Recebe ou define o nome do ficheiro de inclusão onde a secção de configuração associada está definida, caso tal ficheiro exista.
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 de Propriedade
O nome do ficheiro de inclusão em que o ficheiro associado ConfigurationSection está definido, se tal ficheiro existir; caso contrário, uma cadeia vazia ("").
Observações
A ConfigSource propriedade representa o valor do configSource atributo especificado para um ConfigurationSection objeto associado ao SectionInformation objeto.
Uma ConfigurationSection implementação pode, opcionalmente, especificar um ficheiro separado no qual as definições de configuração para essa secção são definidas. Isto pode ser útil de várias formas:
A utilização de ficheiros include pode resultar numa estrutura mais lógica e modular para os ficheiros de configuração.
A segurança de acesso a ficheiros e permissões podem ser usadas para restringir o acesso a secções das definições de configuração.
As definições num ficheiro de inclusão que não são usadas durante a inicialização da aplicação podem ser modificadas e recarregadas sem necessidade de reiniciar a aplicação.
O exemplo seguinte mostra como este atributo é usado num ficheiro de configuração para especificar que a pages secção está definida num ficheiro de inclusão externo:
<pages configSource="pages.config"/>
Se alguma das definições num ficheiro include de configuração exigir que a aplicação reinicie quando for modificada, defina a RestartOnExternalChanges propriedade para true.
Em ASP.NET aplicações, em tempo de execução pode atribuir à propriedade ConfigSource o nome de um ficheiro de configuração alternativo. Nesse caso, o conteúdo do ficheiro é sobrescrito pela informação cadeia de ligação padrão contida no ficheiro Web.config. Isto ocorre também quando o ficheiro alternativo não existe e este é criado em tempo de execução. Se o ficheiro Web.config não contiver qualquer informação cadeia de ligação, é adicionada uma secção vazia ao ficheiro alternativo.