connectionStrings elemento (ASP.NET Configurações Schema)

Especifica uma coleção de seqüências de conexão de banco de dados, como pares nome/valor, para aplicativos ASP.NET e recursos.

Esse elemento é novo no .NET Framework versão 2.0.

<connectionStrings > 
   <add />
   <clear />
   <remove />
</connectionStrings>

Atributos e elementos

As seções a seguir descrevem os atributos, elementos filho e os elementos pai para esse elemento.

Atributos

Nenhum, exceto os atributos que são herdados por todos os elementos de seção. Para obter mais informações, consulte Geral Atributos Herdados por elementos de seção. n ASP.NET applications, em tempo de execução, você pode atribuir a ConfigSource atributo um nome de um arquivo de configuração alternativa. Nesse caso, o conteúdo do arquivo é substituído pelas informações de seqüência de caracteres de conexão padrão que estã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 Web. config não contém qualquer informação de seqüência de caracteres de conexão, um vazio connectionStrings seção é adicionada ao arquivo alternativo.

Elementos filho

Elementos pai

Comentários

O connectionStrings elemento Especifica uma coleção de seqüências de conexão de banco de dados, como pares nome/valor, para aplicativos ASP.NET e recursos.

Em versões anteriores do ASP.NET, seqüências de conexão eram armazenadas na appSettings. No ASP.NET 2.0, recursos, como, por exemplo, sessão, associação, personalização e Gerenciador de função, dependem de cadeias de caracteres de conexão são armazenadas na connectionStrings elemento. Você também pode usar o connectionStrings elemento para armazenar seqüências de conexão para seus próprios aplicativos.

Configuração padrão

Seqüências de conexão que estão contidas em um arquivo de configuração pai são herdadas, a menos que o Limpar elemento é usado no arquivo de configuração do filho. O seguinte padrão connectionStrings elemento é configurado no arquivo Machine. config.

Você pode acessar o connectionStrings elemento programaticamente. Para obter mais informações, consulte o ConnectionStrings exemplo.

<connectionStrings>
   <add 
      name="LocalSqlServer" 
      connectionString="data source=.\SQLEXPRESS;Integrated Security=SSPI;AttachDBFilename=|DataDirectory|aspnetdb.mdf;User Instance=true" 
      providerName="System.Data.SqlClient"
   />
</connectionStrings>

Exemplo

O exemplo de código a seguir demonstra como configurar duas seqüências de caracteres de conexão. A primeira seqüência de conexão pode ser usada por um aplicativo ASP.NET e a segunda seqüência de conexão é usado pelo sqlCacheDependency elemento, que é configurado posteriormente.

<configuration>
<!-- Other configuration settings -->

<connectionStrings>

  <add name="Sales" 
       providerName="System.Data.SqlClient"
       connectionString= "server=myserver;database=Products;uid=<user name>;pwd=<secure password>" />

  <add name="NorthWind" 
       providerName="System.Data.SqlClient" 
       connectionString="server=.;database=NorthWind;Integrated Security=SSPI" />

</connectionStrings>

<cache>
  <sqlCacheDependency enabled="true" pollTime="60000">
    <databases>
      <add name="Northwind" />
    </databases>
  </sqlCacheDependency>
</cache>

</configuration>

Informações do elemento

Consulte também

Tarefas

Como: Bloquear definições de configuração ASP.NET

Referência

configuração Element (Geral Configurações Schema)

Adicionar elemento connectionStrings (ASP.NET Configurações Schema)

Limpe o elemento connectionStrings (ASP.NET Configurações Schema)

remover o elemento connectionStrings (ASP.NET Configurações Schema)

Conceitos

Visão geral da configuração ASP.NET

Protegendo a configuração do ASP.NET

Visão geral do acesso a dados ASP.NET

Criando o banco de dados dos serviços de aplicativos para SQL Server

Protegendo o acesso a dados

Outros recursos

ASP.NET Configuration Settings