Adicionar elemento connectionStrings (ASP.NET Settings Schema)

Artigo
05/28/2012

[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.]

Adiciona uma seqüência de conexão como um par nome/valor à coleção de seqüências 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" 
/>

Attributes and Elements

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

Attributes

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.Provedor de rede 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 gerais, herdada por elementos de seção.

Child Elements

Nenhum.

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.
connectionStrings	Especifica uma coleção de seqüências de conexão de banco de dados (como pares nome/valor) para ASP.NET e ASP.Recursos de rede.

Remarks

O add elemento adiciona uma seqüência de conexão como um par nome/valor à coleção de seqüências de caracteres 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 de rede.

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>

Element Information

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 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

Compartilhar via