Como: Ler as seqüências de conexão do arquivo Web.config

Artigo
10/15/2014

Este exemplo lê uma sequência de caracteres de conexão a partir do arquivo Web.config.O elemento connectionStrings é uma coleção ConnectionStringSettingsCollection de objetos ConnectionStringSettings.Trabalhar com elementos de coleção pode ser levemente mais complicado que trabalhar com outros elementos de configuração.

Para atualizar um parâmetro de configuração, use o método Save ou o método SaveAs do objeto de configuração.Para obter mais informações, consulte Usando as Classes de Configuração.Para exemplos de código adicionais, consulte a classe ConnectionStringsSection e classes relacionadas.

Este exemplo usa o método não estático de obtenção de dados de configuração, o qual lhe permite puxar informações de configuração de qualquer aplicativo.Se você vai obter informações de configuração de um aplicativo no qual seu código reside, use o método estático, que processa mais rapidamente.Para obter mais informações, consulte a seção Trabalhando com Definições de Configuração Local e Remota em Visão Geral da API de Configuração do ASP.NET.

Observação:
Este exemplo refere-se a um site chamado MyWebSiteRoot.Para executar a amostra, você terá ou que executá-la em um site por aquele nome ou substituir a sequência de caracteres fornecida pelo método OpenWebConfiguration pelo nome do seu site.

Exemplo

Dim rootWebConfig As System.Configuration.Configuration
    rootWebConfig = System.Web.Configuration.WebConfigurationManager.OpenWebConfiguration("/MyWebSiteRoot")
Dim connString As System.Configuration.ConnectionStringSettings
If (0 < rootWebConfig.ConnectionStrings.ConnectionStrings.Count) Then
    connString = rootWebConfig.ConnectionStrings.ConnectionStrings("NorthwindConnectionString")
    If Not (Nothing = connString.ConnectionString) Then
        Console.WriteLine("Northwind connection string = {0}", connString.ConnectionString)
    Else
        Console.WriteLine("No Northwind connection string")
    End If
End If

         System.Configuration.Configuration rootWebConfig =
                System.Web.Configuration.WebConfigurationManager.OpenWebConfiguration("/MyWebSiteRoot");
            System.Configuration.ConnectionStringSettings connString;
            if (0 < rootWebConfig.ConnectionStrings.ConnectionStrings.Count)
            {
                connString =
                    rootWebConfig.ConnectionStrings.ConnectionStrings["NorthwindConnectionString"];
                if (null != connString)
                    Console.WriteLine("Northwind connection string = \"{0}\"",
                        connString.ConnectionString);
                else
                    Console.WriteLine("No Northwind connection string");
            }

Compilando o código

Este exemplo requer:

Um elemento connectionStrings no arquivo de origem Web.config que contém uma conexão chamada NorthwindConnectionString.O elemento pode parecer com o seguinte:

<connectionStrings>
  <add 
    name="NorthwindConnectionString" 
    connectionString="Data Source=serverName;Initial 
    Catalog=Northwind;Persist Security Info=True;User 
    ID=userName;Password=password"
    providerName="System.Data.SqlClient"
  />
</connectionStrings>

O elemento connectionStrings é um filho direto do elemento <configuration> e um ponto do elemento system.web.

Observação de segurança:
Quando armazenando informações sigilosas como nomes de usuário e senhas em um arquivo de configuração, você deve criptografar os valores confidenciais usando uma configuração protegida.Para obter mais informações, consulte Como: Seguro Cadeia de caracteres de conexão ao usar controles da fonte de dados.

Programação robusta

Se a sequência de caracteres de conexão especificada não existir no arquivo Web.config, nenhum objeto é retornado.Quando estiver lendo sequências de caracteres de conexão, certifique-se de checar se o código retornou um objeto.

Segurança

O arquivo de configuração deve estar protegido no servidor usando as definições de segurança do Windows para limitar quem pode ler o arquivo.O elemento connectionString pode ser encriptado a fim de protegê-lo.Para obter detalhes, consulte:Criptografando informações de configuração usando configuração protegida.

Consulte também

Referência

connectionStrings elemento (ASP.NET Settings Esquema)

ConfigurationSettings

Partilhar via