Udostępnij za pośrednictwem


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

ConnectionStringsSection

Członkowskie konfiguracji

ConnectionStringSettingsCollection

ConnectionStrings

ConnectionStrings

ConnectionStrings

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

Securing Configuration

ASP.NET Data Access Overview

Installing the SQL Server Provider Database

Securing Data Access

Inne zasoby

ASP.NET ustawienia konfiguracji