connectionStrings Element (ASP.NET Settings Schema)

[Esta documentação destina-se apenas à visualização e está sujeita a alterações em versões posteriores. Os tópicos em branco estão incluídos como espaços reservados.]

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>

Attributes and Elements

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

Attributes

Nenhum, exceto os atributos que são herdados por todos os elementos de seção. Para obter mais informações, consulte Atributos gerais, herdada por elementos de seção. n ASP.NET applications, em tempo de execução, você pode atribuir a ConfigSource um nome de um arquivo de configuração alternativa de atributo. 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.

Child Elements

Elemento	Descrição
Add	Adiciona uma seqüência de conexão como um par nome/valor à coleção de seqüências de conexão.
Clear	Remove todas as referências para seqüências de caracteres de conexão herdados, permitindo que as seqüências de conexão que são adicionadas pelo atual Adicionar elemento.
remove	Remove uma referência a uma seqüência de conexão herdados da coleção de seqüências de caracteres de conexões.

Parent Elements

Elemento	Descrição
configuration	Especifica o elemento raiz necessários em cada arquivo de configuração que é usado pelo common language runtime e o.Aplicativos do NET Framework.
System.web	Especifica o elemento raiz para o ASP.Definições de configuração de rede em uma configuração de arquivo e contém elementos de configuração que configurar aplicativos ASP.NET e controlar como os aplicativos se comportam.

Remarks

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.

Nas 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ções, contam com seqüências de conexã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>

Element Information

Manipulador da seção de configuração	ConnectionStringsSection
Membro de configuração	ConnectionStringSettingsCollection ConnectionStrings ConnectionStrings ConnectionStrings
Locais configuráveis	Machine.config Web. config de nível de raiz Web. config de nível de aplicativo Directory–level virtuais ou físicas Web. config
Requisitos	Serviços de Informações da Internet da Microsoft (IIS) versão 5.0, 5.1 ou 6.0 A.NET Framework versão 2.0 Microsoft Visual Studio 2003 ou 2005 de Visual Studio

Consulte também

Tasks

How to: Lock ASP.NET Configuration Settings

Reference

configuração Element (General Settings Schema)

Adicionar elemento connectionStrings (ASP.NET Settings Schema)

Desmarque elemento connectionStrings (ASP.NET Settings Schema)

remover o elemento connectionStrings (ASP.NET Settings Schema)

Concepts

ASP.NET Configuration Overview

Securing Configuration

ASP.NET Data Access Overview

Installing the SQL Server Provider Database

Securing Data Access

Other Resources

ASP.Definições de configuração de rede