Freigeben über


connectionStrings-Element (ASP.NET-Einstellungsschema)

Gibt eine Auflistung von Verbindungszeichenfolgen für Datenbanken in ASP.NET-Anwendungen und ASP.NET-Features an (in Form von Name-Wert-Paaren).

Dieses Element ist neu in .NET Framework, Version 2.0.

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente sowie übergeordnete Elemente für dieses Element beschrieben.

Attribute

Keine, mit Ausnahme der Attribute, die von allen Abschnittselementen geerbt werden. Weitere Informationen finden Sie unter Von Abschnittselementen geerbte allgemeine Attribute. In ASP.NET-Anwendungen können Sie dem ConfigSource-Attribut den Namen einer alternativen Konfigurationsdatei zuweisen. In diesem Fall wird der Inhalt der Datei von den Standardverbindungszeichenfolgeninformationen überschrieben, die in der Datei Web.config enthalten sind. Dies tritt auch auf, wenn die alternative Datei nicht vorhanden ist und zur Laufzeit erstellt wird. Wenn die Datei Web.config keine Verbindungszeichenfolgeninformationen enthält, wird der alternativen Datei ein leerer connectionStrings-Abschnitt hinzugefügt.

Untergeordnete Elemente

Element

Beschreibungen

Add

Fügt der Auflistung von Verbindungszeichenfolgen eine Verbindungszeichenfolge in Form eines Name-Wert-Paars hinzu.

Clear

Entfernt alle Verweise auf geerbte Verbindungszeichenfolgen bis auf die vom aktuellen add-Element hinzugefügten Verbindungszeichenfolgen.

remove

Entfernt einen Verweis auf eine geerbte Verbindungszeichenfolge aus der Auflistung der Verbindungszeichenfolgen.

Übergeordnete Elemente

Element

Beschreibungen

configuration

Gibt das erforderliche Stammelement in jeder Konfigurationsdatei an, die von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.

System.web

Gibt das Stammelement für die ASP.NET-Konfigurationseinstellungen in einer Konfigurationsdatei an und enthält Konfigurationselemente, die ASP.NET-Webanwendungen konfigurieren und das Verhalten der Anwendungen steuern.

Hinweise

Das connectionStrings-Element gibt eine Auflistung von Verbindungszeichenfolgen für Datenbanken in ASP.NET-Anwendungen und ASP.NET-Features an (als Name-Wert-Paare).

In früheren Versionen von ASP.NET wurden Verbindungszeichenfolgen in den appSettings gespeichert. Einige der Features von ASP.NET 2.0 wie Sitzung, Mitgliedschaft, Personalisierung und Rollenmanager hängen von Verbindungszeichenfolgen ab, die im connectionStrings-Element gespeichert sind. Sie können das connectionStrings-Element auch zum Speichern von Verbindungszeichenfolgen für Ihre eigenen Anwendungen verwenden.

Standardkonfiguration

Die in einer übergeordneten Konfigurationsdatei enthaltenen Verbindungszeichenfolgen werden vererbt, solange in der untergeordneten Konfigurationsdatei kein clear-Element verwendet wird. Das folgende connectionStrings-Standardelement ist in der Datei Machine.config konfiguriert.

Sie können programmgesteuert auf das connectionStrings-Element zugreifen. Weitere Informationen finden Sie im Beispiel ConnectionStrings.

<connectionStrings>
   <add 
      name="LocalSqlServer" 
      connectionString="data source=.\SQLEXPRESS;Integrated Security=SSPI;AttachDBFilename=|DataDirectory|aspnetdb.mdf;User Instance=true" 
      providerName="System.Data.SqlClient"
   />
</connectionStrings>

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie zwei Verbindungszeichenfolgen konfiguriert werden. Die erste Verbindungszeichenfolge kann von einer ASP.NET-Anwendung verwendet werden, die zweite wird vom später konfigurierten sqlCacheDependency-Element verwendet.

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

Elementinformationen

Konfigurationsabschnittshandler

ConnectionStringsSection

Konfigurationsmember

ConnectionStringSettingsCollection

ConnectionStrings

ConnectionStrings

ConnectionStrings

Konfigurierbare Speicherorte

Machine.config

Web.config auf der Stammebene

Web.config auf der Anwendungsebene

Web.config auf der Ebene virtueller oder physikalischer Verzeichnisse

Anforderungen

Microsoft Internetinformationsdienste (IIS), Version 5.0, 5.1 oder 6.0

.NET Framework, Version 2.0

Microsoft Visual Studio 2003 oder Visual Studio 2005

Siehe auch

Aufgaben

Gewusst wie: Sperren von ASP.NET-Konfigurationseinstellungen

Referenz

configuration-Element (allgemeines Einstellungsschema)

add-Element für connectionStrings (ASP.NET-Einstellungsschema)

clear-Element für connectionStrings (ASP.NET-Einstellungsschema)

remove-Element für connectionStrings (ASP.NET-Einstellungsschema)

Konzepte

Übersicht über die ASP.NET-Konfiguration

Absichern der ASP.NET-Konfiguration

Überblick über den ASP.NET-Datenzugriff

Erstellen der Datenbank für die Anwendungsdienste für SQL Server

Sichern des Datenzugriffs

Weitere Ressourcen

ASP.NET-Konfigurationseinstellungen