Compartilhar via


connectionStrings elemento (ASP.NET Settings esquema)

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

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

configuração elemento (Geral Settings esquema)
  connectionStrings elemento (ASP.NET Settings esquema)

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

Atributos e elementos

As seções a seguir descrevem os atributos e elementos filho 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 Atributos Geral herdados por elementos de seção.

Elementos filho

Elemento

Descrição

Add

Adiciona um cadeia de conexão sistema autônomo um emparelhar nome/valor à coleção de cadeia de conexão sistema autônomo.

Clear

Remove todas as referências para seqüências de conexão herdados, permitindo que apenas as seqüências de conexão são adicionadas pelo corrente Adicionar elemento.

remove

Remove uma referência a um herdadas cadeia de conexão da coleção de seqüências de conexões.

Elementos pai

Elemento

Descrição

configuration

Especifica o elemento raiz exigido em todos os arquivos de configuração usado pelo common linguagem tempo de execução e os aplicativos do .NET estrutura.

System.web

Especifica o elemento raiz para as definições de configuração do ASP.NET em um arquivo de configuração e contém elementos de configuração configurar aplicativos ASP.NET e o controle como os aplicativos se comportam.

Comentários

The connectionStrings elemento especifica uma coleção de seqüências de caracteres de conexão de banco de dados, sistema autônomo pares nome/valor, para aplicativos ASP.NET e recursos.

Em versões anteriores do ASP.NET, seqüências de caracteres de conexão foram armazenadas na appSettings. No ASP.NET 2.0, recursos, sistema autônomo, por exemplo, sessão, associação, personalização e Gerenciador de funções, contam com seqüências de caracteres de conexão armazenadas no connectionStrings elemento. Você também pode usar o connectionStrings elemento para armazenar seqüências de caracteres de conexão para seus próprios aplicativos.

Configuração padrão

Seqüências de caracteres de conexão que estão contidas em um arquivo de configuração pai são herdadas, a menos que o desmarcar elemento é usado no arquivo de configuração do filho. O seguinte padrão connectionStrings elemento está configurado no arquivo computador.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 caracteres de conexão pode ser usada por um aplicativo ASP.NET e a segunda seqüência de caracteres de conexão é usada 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

Manipulador de seção de configuração

ConnectionStringsSection

Configuração de membro

ConnectionStringSettingsCollection

ConnectionStrings

ConnectionStrings

ConnectionStrings

Locais configuráveis

Machine.config

Web.config de nível de raiz

Web.config de nível de aplicativo

Virtual ou físico diretório–nível Web.config

Requisitos

Serviços de Informações da Internet da Microsoft (IIS) versão 5.0, 5.1 ou 6.0

O .NET estrutura versão 2.0

Microsoft Visual Studio 2003 ou o Visual Studio 2005

Consulte também

Tarefas

Como: Bloquear ASP.NET Configuration Settings

Conceitos

Visão Geral da Configuração ASP.NET

Protegendo configuração ASP.NET

Visão Geral do Acesso a Dados ASP.NET

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

Proteção de acesso a dados

Referência

configuração elemento (Geral Settings esquema)

Adicionar elemento connectionStrings (ASP.NET Settings esquema)

desmarcar elemento connectionStrings (ASP.NET Settings esquema)

Remover elemento connectionStrings (ASP.NET Settings esquema)

Outros recursos

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