Dodawanie elementu do connectionStrings (ASP.Schemat ustawień netto)

Artykuł
06/25/2012

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Dodaje ciąg połączenia jako pary nazwa/wartość Kolekcja ciągów połączenia.

Ten element jest nowego w.NET Framework w wersji 2.0.

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

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty i elementy podrzędne elementy nadrzędne.

Atrybuty

Atrybut	Opis
connectionString	Wymagane String atrybut. Określa wartość ciągu połączenia. Wartość może być pusty ciąg (""). Wykonywane jest sprawdzanie nie, aby sprawdzić jego ważności. Wartością domyślną jest ciąg pusty ("").
name	Wymagane String atrybut. Określa klucz do użycia do uzyskania dostępu do wartości ciągu połączenia. Atrybut ten zastępuje wszelkie dziedziczone klucza o tej samej nazwie. Wartością domyślną jest ciąg pusty ("").
providerName	Opcjonalny String atrybut. Nazwa ADO.NET dostawcy do uzyskiwania dostępu do magazynu danych podstawowych. Wartością domyślną jest "System.Data.SqlClient".
Atrybuty dziedziczone	Opcjonalne atrybuty. Atrybuty dziedziczone przez wszystkie elementy z sekcji. Aby uzyskać więcej informacji, zobacz Atrybuty ogólne dziedziczone przez elementy sekcji.

Elementy podrzędne

Brak.

Elementy nadrzędne

Element	Opis
configuration	Określa element główny wymagane w każdym pliku konfiguracyjnym, który jest używany przez aparatu plików wykonywalnych języka wspólnego oraz.NET Framework aplikacji.
system.web	Określa element główny dla aplikacji ASP.Ustawienia konfiguracji netto w konfiguracji pliku i zawiera elementy konfiguracyjne określające konfigurację programu ASP.NET aplikacje sieci Web i kontrolować zachowanie tych aplikacji.
connectionStrings	Określa Kolekcja ciągów połączenia bazy danych (jako pary nazwa/wartość) dla aplikacji ASP.NET i ASP.Funkcje netto.

Uwagi

add Element dodaje ciąg połączenia jako pary nazwa/wartość Kolekcja ciągów połączenia w connectionStrings element.

connectionStrings Element określa Kolekcja ciągów połączenia bazy danych (jako pary nazwa/wartość) dla aplikacji ASP.NET i ASP.Funkcje netto.

Domyślna konfiguracja

Ciągi połączeń, które są zawarte w pliku konfiguracyjnym nadrzędnego są dziedziczone, chyba że Wyczyść element jest używany w pliku konfiguracyjnym dziecka. Następujące domyślne element element jest skonfigurowany w pliku 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>

Przykład

Poniższy przykład kodu demonstruje, jak skonfigurować ciąg połączenia dla aplikacji, która korzysta z bazy danych Northwind.

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

Informacje o elementach

Program obsługi sekcji konfiguracji	ConnectionStringsSection
Członkowskie konfiguracji	Add(ConnectionStringSettings)
Lokalizacje konfigurowalne	Machine.config Web.config na poziomie katalogu głównego Poziom aplikacji Web.config Directory–level wirtualnego lub fizycznego Web.config
Wymagania	Microsoft Internet Information Services (IIS) w wersji 5.0, 5.1 lub 6.0 .NET Framework w wersji 2.0 Microsoft Visual Studio 2003 lub Visual Studio 2005

Zobacz też

Udostępnij za pośrednictwem