connectionStrings の add 要素 (ASP.NET 設定スキーマ)

  • [アーティクル]

[このドキュメントはプレビューのみを目的としており、以降のリリースで変更される可能性があります。プレースホルダーとして空白のトピックが含まれています。]

接続文字列のコレクションに、接続文字列を名前と値のペアとして追加します。

この要素は、.NET Framework Version 2.0 で追加されました。

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

属性および要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

属性

Description

connectionString

必須の String 属性です。

接続文字列の値を定義します。 値には空の文字列 ("") を指定可能です。 有効性検査のためのチェックは行われません。

既定値は、空の文字列 ("") です。

name

必須の String 属性です。

接続文字列の値にアクセスするために使用するキーを定義します。 この属性により、同じ名前を持つ継承したキーはオーバーライドされます。

既定値は、空の文字列 ("") です。

providerName

省略可能な String 型の属性です。

基になるデータ ストアにアクセスするために使用する ADO.NET プロバイダーの名前。

既定値は、"System.Data.SqlClient" です。

継承される属性

省略可能な属性です。

すべてのセクション要素が継承する属性です。

詳細については、「セクションの要素によって継承される全般属性」を参照してください。

子要素

なし。

親要素

要素

Description

configuration

共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルで必要なルート要素を指定します。

system.web

構成ファイルの ASP.NET 構成設定のルート要素を指定します。ASP.NET Web アプリケーションを構成する構成要素やアプリケーションの動作を制御する構成要素が含まれます。

connectionStrings

ASP.NET アプリケーションと ASP.NET 機能のデータベース接続文字列 (名前と値のペア) のコレクションを指定します。

解説

add 要素は、connectionStrings 要素内の接続文字列のコレクションに、接続文字列を名前と値のペアとして追加します。

connectionStrings 要素は、ASP.NET アプリケーションと ASP.NET 機能のデータベース接続文字列 (名前と値のペア) のコレクションを指定します。

既定の構成

子構成ファイルで clear 要素が使用されている場合を除き、親構成ファイルに格納されている接続文字列が継承されます。 次の既定の element 要素は、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>

使用例

Northwind データベースを使用するアプリケーションの接続文字列を構成する方法を次のコード例に示します。

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

要素情報

構成セクション ハンドラー

ConnectionStringsSection

構成メンバー

Add(ConnectionStringSettings)

構成できる場所

Machine.config

ルート レベルの Web.config

アプリケーション レベルの Web.config

仮想ディレクトリ レベルまたは物理ディレクトリ レベルの Web.config

要件

Microsoft Internet Information Services (IIS) バージョン 5.0、5.1、または 6.0

.NET Framework Version 2.0

Microsoft Visual Studio 2003 または Visual Studio 2005

参照

処理手順

How to: Lock ASP.NET Configuration Settings

Reference

connectionStrings の clear 要素 (ASP.NET 設定スキーマ)

configuration 要素 (全般設定スキーマ)

connectionStrings の clear 要素 (ASP.NET 設定スキーマ)

connectionStrings の remove 要素 (ASP.NET 設定スキーマ)

概念

ASP.NET Configuration Overview

Securing Configuration

ASP.NET Data Access Overview

Securing Data Access

Configuration Inheritance