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

Artikel
05/27/2012

[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]

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

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

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

Attribut	Beschreibung
connectionString	Erforderliches String-Attribut. Gibt den Wert der Verbindungszeichenfolge an. Der Standardwert kann eine leere Zeichenfolge ("") sein. Die Gültigkeit des Werts wird nicht überprüft. Der Standardwert ist eine leere Zeichenfolge ("").
name	Erforderliches String-Attribut. Definiert den für den Zugriff auf den Wert der Verbindungszeichenfolge zu verwendenden Schlüssel. Dieses Attribut überschreibt alle geerbten Schlüssel desselben Namen. Der Standardwert ist eine leere Zeichenfolge ("").
providerName	Optionales String-Attribut. Der Name des ADO.NET-Anbieters, der für den Zugriff auf den zugrunde liegenden Datenspeicher verwendet werden soll. Der Standardwert ist "System.Data.SqlClient".
Geerbte Attribute	Optionale Attribute. Attribute, die von allen Abschnittselementen geerbt werden. Weitere Informationen finden Sie unter Von Abschnittselementen geerbte allgemeine Attribute.

Untergeordnete Elemente

Keine.

Übergeordnete Elemente

Element	Beschreibung
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.
connectionStrings	Gibt eine Auflistung von Verbindungszeichenfolgen (als Name-Wert-Paare) für Datenbanken in ASP.NET-Anwendungen und ASP.NET-Features an.

Hinweise

Das add-Element fügt eine Verbindungszeichenfolge in Form eines Name-Wert-Paars zur Auflistung der Verbindungszeichenfolgen im connectionStrings-Element hinzu.

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

Standardkonfiguration

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

<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 eine Verbindungszeichenfolge für eine Anwendung konfiguriert wird, die die Datenbank Northwind verwendet.

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

Elementinformationen

Konfigurationsabschnittshandler	ConnectionStringsSection
Konfigurationsmember	Add(ConnectionStringSettings)
Konfigurierbare Speicherorte	Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene Web.config auf der Ebene virtueller oder physischer 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

Share via