次の方法で共有


SqlDataSource.ConnectionString プロパティ

定義

SqlDataSource コントロールが基になるデータベースへの接続に使用する ADO.NET プロバイダー固有の接続文字列を取得または設定します。

public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
public virtual string ConnectionString { get; set; }
member this.ConnectionString : string with get, set
Public Overridable Property ConnectionString As String

プロパティ値

SqlDataSource が表す SQL データベースへの接続に使用する .NET Framework データ プロバイダー固有の文字列。 既定値は空の文字列 ("") です。

次のコード例では、ConnectionString プロパティを設定して SQL Server データベースに接続し、GridView コントロールに SelectCommand プロパティの結果を表示する方法を示します。

<%@ Page Language="C#" %>

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

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" 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>
<%@ Page Language="VB" %>

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

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" 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>

注釈

SqlDataSource コントロールはさまざまな ADO.NET プロバイダーと共に使用でき、基になるデータ ソースへの接続に使用される接続文字列の構文はプロバイダーに固有です。

SqlDataSource コントロールを構成するときは、ProviderName プロパティをデータベースの種類 (既定値は System.Data.SqlClient) に設定し、データベースに接続するために必要な情報を含む接続文字列に ConnectionString プロパティを設定します。 接続文字列の内容は、データ ソース管理がアクセスしているデータベースの種類によって異なります。 たとえば、SqlDataSource コントロールには、サーバー名、データベース (カタログ) 名、および SQL Server に接続するときにユーザーを認証する方法に関する情報が必要です。 接続文字列の内容については、SqlConnection クラスの ConnectionString プロパティ、OracleConnection クラスの ConnectionString プロパティ、OleDbConnection クラスの ConnectionString プロパティ、または OdbcConnection クラスの ConnectionString プロパティを参照してください。

ConnectionString プロパティを変更すると、DataSourceChanged イベントが発生し、SqlDataSource コントロールにバインドされているコントロールが再バインドされます。

大事な

接続文字列の格納の詳細については、「方法: データ ソースコントロールを使用するときに接続文字列をセキュリティで保護する」を参照してください。

適用対象

こちらもご覧ください