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

Artigo
08/04/2011

Adiciona uma seqüência de caracteres de conexão como um par nome/valor à coleção de seqüências de caracteres de conexão.

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

<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	Obrigatório String atributo. Define o valor de seqüência de caracteres de conexão. O valor pode ser uma seqüência vazia (""). Nenhuma verificação é feita para verificar sua validade. The default is an empty string ("").
name	Obrigatório String atributo. Define a chave usar para acessar o valor de seqüência de caracteres de conexão. Este 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 provider 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 Geral Atributos Herdados por elementos de seção.

Elementos filho

Nenhum.

Elementos pai

Elemento	Descrição
configuration	Especifica o elemento raiz necessários em cada arquivo de configuração que é usado pelo common language runtime e a.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 para configurar aplicativos ASP.NET e controlar como os aplicativos se comportam.
connectionStrings	Especifica uma coleção de seqüências de conexão de banco de dados (como pares nome/valor) para o ASP.NET e ASP.Recursos de rede.

Comentários

O add elemento adiciona uma seqüência de caracteres de conexão como um par nome/valor à coleção de seqüências de conexão na connectionStrings elemento.

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

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 element elemento é configurado no arquivo Machine. 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 seqüência 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 da seção de configuração	ConnectionStringsSection
Membro de configuração	Add(ConnectionStringSettings)
Locais configuráveis	Machine.config Web. config de nível de raiz Web. config de nível de aplicativo Virtual ou física directory–level Web. config
Requisitos	De da (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

Compartilhar via