Element connectionStrings (schéma nastavení ASP.NET)

Článek
08/11/2011

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

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

<connectionStrings > 
   <add />
   <clear />
   <remove />
</connectionStrings>

Atributy a prvky

Následující části popisují atributy, podřízený prvky a rodičovské elementy pro tento element.

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

Žádný, s výjimkou atributů, které jsou zdě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. n aplikacím technologie ASP.NET lze za běhu přiřadit do atributu ConfigSource název alternativního konfiguračního souboru. V tomto případě je obsah souboru přepsán výchozím připojovacím řetězcem, který je obsažen v souboru Web.config. K této situaci dochází také v případě, že alternativní soubor neexistuje a je vytvořen v době spuštění. Pokud soubor Web.config neobsahuje žádné informace o řetězci připojení, je do alternativního souboru přidána prázdná sekce connectionStrings.

Podřízené prvky

Prvek	Popis
Add	Přidá připojovací řetězec jako dvojici název/hodnota do kolekce připojovacích řetězců.
Clear	Odebere všechny odkazy na zděděné připojovací řetězce. Povolí pouze ty, které jsou přidány pomocí aktuálního elementu add.
remove	Odebere odkaz na zděděné připojovací řetězce z kolekce řetězců připojení.

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

Poznámky

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 předchozích verzích technologie ASP.NET byly připojovací řetězce uloženy v appSettings. V technologii ASP.NET 2.0 funkce, jako jsou například relace, členství, přizpůsobení a správce rolí, spoléhají na připojovací řetězce, které jsou uloženy v elementu connectionStrings. Můžete také použít element connectionStrings pro uložení řetězců připojení vlastní aplikace.

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 connectionStrings je konfigurován v souboru Machine.config.

Můžete získat přístup k elementu connectionStrings programově. Další informace naleznete v příkladu ConnectionStrings.

<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 demonstruje konfiguraci dvou řetězců připojení. První připojovací řetězec může být použit aplikací ASP.NET a druhý připojovací řetězec je použit elementem sqlCacheDependency, který je nakonfigurován později.

<configuration>
<!-- Other configuration settings -->

<connectionStrings>

  <add name="Sales" 
       providerName="System.Data.SqlClient"
       connectionString= "server=myserver;database=Products;uid=<user name>;pwd=<secure password>" />

  <add name="NorthWind" 
       providerName="System.Data.SqlClient" 
       connectionString="server=.;database=NorthWind;Integrated Security=SSPI" />

</connectionStrings>

<cache>
  <sqlCacheDependency enabled="true" pollTime="60000">
    <databases>
      <add name="Northwind" />
    </databases>
  </sqlCacheDependency>
</cache>

</configuration>

Informace prvku

Obslužná rutina konfiguračního oddílu	ConnectionStringsSection
Konfigurační člen	ConnectionStringSettingsCollection ConnectionStrings ConnectionStrings ConnectionStrings
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

Element connectionStrings (schéma nastavení ASP.NET)

Atributy a prvky

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

Podřízené prvky

Nadřazené prvky

Poznámky

Výchozí konfigurace

Příklad

Informace prvku

Viz také

Úkoly

Odkaz

Koncepty

Další zdroje

Další materiály