connectionStrings Element (ASP.Schemat ustawień netto)
[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]
Określa Kolekcja ciągów połączenia bazy danych, jako pary nazwa/wartość dla aplikacji ASP.NET i funkcje.
Ten element jest nowego w.NET Framework w wersji 2.0.
<connectionStrings >
<add />
<clear />
<remove />
</connectionStrings>
Atrybuty i elementy
W poniższych sekcjach opisano atrybuty i elementy podrzędne elementy nadrzędne dla tego elementu.
Atrybuty
Brak, z wyjątkiem atrybutów, które są dziedziczone przez wszystkie elementy z sekcji. Aby uzyskać więcej informacji, zobacz Atrybuty ogólne dziedziczone przez elementy sekcji. n ASP.NET applications, w czasie wykonywania, można przypisać do ConfigSource atrybutu nazwy pliku konfiguracji alternatywnej. W przypadku zawartości pliku jest zastępowana przez domyślne informacje ciągu połączenia, zawarte w pliku Web.config. Występuje to również, gdy alternatywny plik nie istnieje i jest tworzony w czasie wykonywania. Jeśli w pliku Web.config nie zawiera wszelkie informacje ciągu połączenia, pusty connectionStrings dodaje się sekcję do innego pliku.
Elementy podrzędne
Element |
Opis |
---|---|
Add |
Dodaje ciąg połączenia jako pary nazwa/wartość Kolekcja ciągów połączenia. |
Clear |
Usuwa wszystkie odwołania do ciągów połączeń dziedziczone, umożliwiając tylko ciągi połączeń, dodanych przez bieżący dodać element. |
remove |
Usuwa odwołanie do ciągu połączenia dziedziczone z kolekcji ciągów połączeń. |
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. |
Uwagi
connectionStrings Element określa Kolekcja ciągów połączenia bazy danych, jako pary nazwa/wartość dla aplikacji ASP.NET i funkcje.
W poprzednich wersjach programu ASP.NET, ciągi połączeń były przechowywane w appSettings. W programie ASP.NET 2.0, funkcje, takie jak sesji, członkostwa, personalizacji i Menedżer ról polegać na ciągi połączeń, które są przechowywane w connectionStrings element. Można również użyć connectionStrings element z przechowywać ciągi połączeń dla własnych aplikacji.
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 connectionStrings element jest skonfigurowany w pliku Machine.config.
Dostęp można uzyskać connectionStrings element programowo. Aby uzyskać więcej informacji, zobacz ConnectionStrings przykład.
<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ć dwa ciągi połączeń. Pierwszy ciąg połączenia można używanego przez aplikację ASP.NET, a drugi ciąg połączenia jest używany przez sqlCacheDependency element, który jest skonfigurowany później.
<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>
Informacje o elementach
Program obsługi sekcji konfiguracji |
|
Członkowskie konfiguracji |
|
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ż
Zadania
How to: Lock ASP.NET Configuration Settings
Informacje
Konfiguracja elementu (schemat ustawień ogólne)
Dodawanie elementu do connectionStrings (ASP.Schemat ustawień netto)
Usuń zaznaczenie elementu dla connectionStrings (ASP.Schemat ustawień netto)
Usuń Element dla connectionStrings (ASP.Schemat ustawień netto)
Koncepcje
ASP.NET Configuration Overview
Installing the SQL Server Provider Database