Podelement add elementu connectionStrings (schéma nastavení ASP.NET)

Článek
08/11/2011

Přidá připojovací řetězec jako dvojici název/hodnota do kolekce připojovacích řetězců.

Tento element je v rozhraní .NET Framework verze 2.0 nový.

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

Atributy a prvky

Následující části popisují atributy, podřízené prvky a rodičovské prvky.

v případě vícehodnotových atributů

Atribut	Popis
connectionString	Požadované String atributu. Definuje hodnotu připojovacího řetězce. Hodnota může být prázdný řetězec (""). Neprovádí se žádná kontrola ověření platnosti. Výchozí hodnota je prázdný řetězec ("").
name	Požadovaný atribut typu String. Určuje klíč použitý pro přístup k hodnotě připojovacího řetězce. Tento atribut přepíše libovolný zděděný klíč se stejným názvem. Výchozí hodnota je prázdný řetězec ("").
providerName	Nepovinný atribut String. Název poskytovatele ADO.NET použitého pro přístup k základnímu úložišti dat. Výchozí je "System.Data.SqlClient".
Zděděné atributy	Volitelné atributy. Atributy, které jsou děděny všemi prvky oddílu. Další informace naleznete v tématu Obecné atributy, které jsou děděny všemi prvky oddílu.

Podřízené prvky

Žádný

Nadřazené prvky

Prvek	Popis
configuration	Určuje požadovaný kořenový element nacházející se v každém konfiguračním souboru, který je používán modulem CLR (Common Language Runtime) a aplikacemi rozhraní .NET Framework.
system.web	Určuje kořenový element konfiguračního souboru s nastavením konfigurace technologie ASP.NET a obsahuje konfigurační prvky, které konfigurují webové aplikace ASP.NET a řídí chování aplikací.
connectionStrings	Určuje kolekci připojovacích řetězců k databázi pro aplikace a funkce technologie ASP.NET ve tvaru dvojic jméno/hodnota.

Poznámky

Element add přidá připojovací řetězec jako dvojici název/hodnota do kolekce připojovacích řetězců v elementu connectionStrings.

Element connectionStrings určuje kolekci připojovacích řetězců k databázi, pro aplikace a funkce technologie ASP.NET, ve tvaru dvojic jméno/hodnota.

Výchozí konfigurace

Připojovací řetězce, které jsou obsaženy v nadřazeném konfiguračním souboru, jsou zděděné, pokud není použit element clear v podřízeném konfiguračním souboru. Následující výchozí element prvek nastaven v souboru 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>

Příklad

Následující příklad kódu ukazuje konfiguraci připojovacího řetězce pro aplikace používající databázi Northwind.

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

Informace prvku

Obslužná rutina konfiguračního oddílu	ConnectionStringsSection
Konfigurační člen	Add(ConnectionStringSettings)
Konfigurovatelná umístění	Machine.config Web.config kořenové úrovně Web.config aplikační úrovně Soubor web.config na úrovni fyzického nebo virtuálního adresáře
Požadavky	Microsoft Internet Information Services (IIS) 5.0, 5.1 nebo 6.0 .NET Framework verze 2.0 Microsoft Visual Studio 2003 nebo Visual Studio 2005

Viz také

Sdílet prostřednictvím