Adicionar elemento connectionStrings (ASP.NET Settings esquema)

Artigo
08/25/2010

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

Partilhar via