Partilhar via


Adicionar elemento connectionStrings (ASP.NET Settings esquema)

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

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

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

<add 
      name="connection string name"
   connectionString="connection string"
   providerName="ADO.NET data provider" 
/>

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho, e elementos pai.

Atributos

Atributo

Descrição

connectionString

Necessário String atributo.

Define o valor de cadeia de conexão. O valor pode ser uma seqüência de caracteres vazia (""). Nenhuma verificação é feita para verificar sua validade.

The default is an empty string ("").

name

Necessário String atributo.

Define a chave para acesso o valor de cadeia de conexão. Esse atributo substitui qualquer tecla herdada com o mesmo nome.

The default is an empty string ("").

providerName

Opcional String atributo.

O nome do provedor ADO.NET para usar para acessar o armazenamento de dados subjacente.

O padrão é "System.Data.SqlClient".

Atributos herdados

Atributos opcionais.

Atributos herdados por todos os elementos de seção.

Para obter mais informações, consulte Atributos Geral herdados por elementos de seção.

Elementos filho

Nenhum.

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.

connectionStrings

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 do ASP.NET.

Comentários

The add elemento adiciona uma seqüência de caracteres de conexão sistema autônomo um emparelhar nome/valor à coleção de seqüências de conexão na connectionStrings elemento.

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 do ASP.NET.

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 element elemento está configurado no arquivo computador.config.

<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 uma cadeia de conexão para um aplicativo que usa o banco de dados Northwind.

<configuration>
  <connectionStrings>
    <add name="Northwind"
         connectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind;" 
         providerName="System.Data.SqlClient" />
  </connectionStrings>
</configuration>

Informações do elemento

Manipulador de seção de configuração

ConnectionStringsSection

Configuração de membro

Add(ConnectionStringSettings)

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

Proteção de acesso a dados

Cenários de configuração ASP.NET

Referência

desmarcar elemento connectionStrings (ASP.NET Settings esquema)

configuração elemento (Geral Settings esquema)

desmarcar elemento connectionStrings (ASP.NET Settings esquema)

Remover elemento connectionStrings (ASP.NET Settings esquema)