ConnectionStringsExpressionBuilder クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

ConnectionStringsExpressionBuilder クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

Web.config ファイルの <connectionStrings> セクションから値を取得します。または、値を取得するコードを生成します。

名前空間: System.Web.Compilation
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Class ConnectionStringsExpressionBuilder
    Inherits ExpressionBuilder

Visual Basic (使用法)

Dim instance As ConnectionStringsExpressionBuilder

public class ConnectionStringsExpressionBuilder
 : ExpressionBuilder

C++

public ref class ConnectionStringsExpressionBuilder
 : public ExpressionBuilder

public class ConnectionStringsExpressionBuilder
 extends ExpressionBuilder

JScript

public class ConnectionStringsExpressionBuilder
 extends ExpressionBuilder

解説

ConnectionStringsExpressionBuilder クラスは、Web.config ファイルの <connectionStrings> セクションの値へのアクセスを提供します。Web.config ファイルの <connectionStrings> セクションには、名前/値ペア形式の接続文字列値が含まれています。

接続文字列値は、形式

<%$ ConnectionStrings: secureConnectionString %>

の式をコントロールプロパティに割り当てることによって取得されます。式のコロン (:) の前の部分は取得する式の種類を表し、コロンの後の部分は接続文字列の名前を表します。前述の式は、Web.config ファイルから次の値を取得します。

<connectionStrings>

<add name="secureConnectionString" connectionString="Data

Source=localhost;Integrated Security=SSPI;Initial

Catalog=Northwind;" providerName="System.Data.SqlClient" />

</connectionStrings>

ページパーサーは、プレフィックスが ConnectionStrings の式を見つけると、ConnectionStringsExpressionBuilder クラスのインスタンスを作成して、その式を処理します。

コンパイルされるページにこの式がある場合、ConnectionStringsExpressionBuilder オブジェクトは、指定した接続文字列を Web.config ファイルから取得するコードを生成します。コンパイルされないページにこの式がある場合、ConnectionStringsExpressionBuilder オブジェクトはページの解析時に Web.config ファイルの値を返します。

使用例

SqlDataSource コントロールを宣言によって使用して、Microsoft SQL Server が実行されているコンピュータからデータを取得し、それを GridView コントロールに表示する方法を次のコード例に示します。

Visual Basic

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML
 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<HTML>
  <BODY>
    <FORM runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT FirstName, LastName, Title FROM
 Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </FORM>
  </BODY>
</HTML>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<HTML>
  <BODY>
    <FORM runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </FORM>
  </BODY>
</HTML>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<HTML>
  <BODY>
    <FORM runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="Data Source=localhost;Integrated Security=SSPI;Initial
 Catalog=Northwind;"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </FORM>
  </BODY>
</HTML>

このコードは、Web.config ファイルから次の接続文字列を取得します。

<configuration xmlns="http://schemas.microsoft.com/.NetConfiguration/v2.0">

<connectionStrings>

<add name="MyNorthwind" connectionString="Data

Source=localhost;Integrated Security=SSPI;Initial

Catalog=Northwind;" providerName="System.Data.SqlClient" />

</connectionStrings>

</configuration>

.NET Framework のセキュリティ

AspNetHostingPermission 値の取得に使用します。Minimal (関連する列挙体)

継承階層

System.Object
System.Web.Compilation.ExpressionBuilder
System.Web.Compilation.ConnectionStringsExpressionBuilder

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ConnectionStringsExpressionBuilder メンバ
System.Web.Compilation 名前空間
CompilationMode
ConnectionStrings
ConfigurationManager
ConnectionStringsExpressionEditor
その他の技術情報
ASP.NET 式の概要

>> 「ConnectionStringsExpressionBuilder クラス」を含む用語の索引
ConnectionStringsExpressionBuilder クラスのページへのリンク

ConnectionStringsExpressionBuilder クラスとは？わかりやすく解説