SqlDataSource コンストラクター

  • リファレンス

定義

名前空間:
System.Web.UI.WebControls
アセンブリ:
System.Web.dll

SqlDataSource クラスの新しいインスタンスを初期化します。

オーバーロード

SqlDataSource()

SqlDataSource クラスの新しいインスタンスを初期化します。
SqlDataSource(String, String)

接続文字列と SELECT コマンドを指定して、SqlDataSource クラスの新しいインスタンスを初期化します。
SqlDataSource(String, String, String)

接続文字列と SELECT コマンドを指定して、SqlDataSource クラスの新しいインスタンスを初期化します。

SqlDataSource()

SqlDataSource クラスの新しいインスタンスを初期化します。

public:
 SqlDataSource();
public SqlDataSource ();
Public Sub New ()

こちらもご覧ください

適用対象

SqlDataSource(String, String)

接続文字列と SELECT コマンドを指定して、SqlDataSource クラスの新しいインスタンスを初期化します。

public:
 SqlDataSource(System::String ^ connectionString, System::String ^ selectCommand);
public SqlDataSource (string connectionString, string selectCommand);
new System.Web.UI.WebControls.SqlDataSource : string * string -> System.Web.UI.WebControls.SqlDataSource
Public Sub New (connectionString As String, selectCommand As String)

パラメーター

connectionString
String

基になるデータベースに接続するために使用する接続文字列。

selectCommand
String

基になるデータベースからデータを取得するために使用する SQL クエリ。 SQL クエリがパラメーター化された SQL 文字列の場合、Parameter コレクションへの SelectParameters オブジェクトの追加が必要になることがあります。

例

次のコード例では、コンストラクターを使用してコントロールを SqlDataSource 作成する方法を SqlDataSource 示します。 この例は、コントロールがWeb Forms ページではなく、ビジネス オブジェクトがデータベースと対話するための簡単な方法として中間層オブジェクトの実装で使用されている点SqlDataSourceでは珍しいです。 この例では、Web.config ファイルに格納されている接続文字列を使用します。

このコード例は、ObjectDataSource クラスのために提供されている大規模な例の一部です。

// Returns a collection of NorthwindEmployee objects.
public static ICollection GetAllEmployees () {
  ArrayList al = new ArrayList();

  ConnectionStringSettings cts = ConfigurationManager.ConnectionStrings["NorthwindConnection"];

  SqlDataSource sds
    = new SqlDataSource(cts.ConnectionString, "SELECT EmployeeID FROM Employees");

  try {

    IEnumerable IDs = sds.Select(DataSourceSelectArguments.Empty);

    // Iterate through the Enumeration and create a
    // NorthwindEmployee object for each ID.
    foreach (DataRowView row in IDs) {
      string id = row["EmployeeID"].ToString();
      NorthwindEmployee nwe = new NorthwindEmployee(id);
      // Add the NorthwindEmployee object to the collection.
      al.Add(nwe);
    }
  }
  finally {
    // If anything strange happens, clean up.
    sds.Dispose();
  }

  return al;
}

' Returns a collection of NorthwindEmployee objects.
Public Shared Function GetAllEmployees() As ICollection
   Dim al As New ArrayList()

   Dim cts As ConnectionStringSettings = ConfigurationManager.ConnectionStrings("NorthwindConnection")
   Dim sds As New SqlDataSource(cts.ConnectionString, "SELECT EmployeeID FROM Employees")
   Try
      Dim IDs As IEnumerable = sds.Select(DataSourceSelectArguments.Empty)

      ' Iterate through the Enumeration and create a
      ' NorthwindEmployee object for each ID.
      For Each row As DataRowView In IDs
         Dim id As String = row("EmployeeID").ToString()
         Dim nwe As New NorthwindEmployee(id)
         ' Add the NorthwindEmployee object to the collection.
         al.Add(nwe)
      Next
   Finally
      ' If anything strange happens, clean up.
      sds.Dispose()
   End Try

   Return al
End Function 'GetAllEmployees

注釈

データベース製品によって使用されるSQLは異なるため、構文selectCommandは現在使用されている ADO.NET プロバイダーによって異なります。これはプロパティによってProviderName識別されます。 SQL 文字列がパラメーター化されたクエリまたはコメントである場合は、パラメーターのプレースホルダーも現在使用している ADO.NET プロバイダーによって決まります。 たとえば、プロバイダーがクラスの既定の System.Data.SqlClientプロバイダー SqlDataSource である場合、パラメーターのプレースホルダーは '@parameterName'. ただし、プロバイダーが or System.Data.OleDbにSystem.Data.Odbc設定されている場合、パラメーターのプレースホルダーは '?'. パラメーター化されたSQLクエリとコマンドの詳細については、「SqlDataSource コントロールでのパラメーターの使用」を参照してください。

データ ソースがストアド プロシージャをサポートしている場合、値にはSelectCommandSQL文字列またはストアド プロシージャの名前を指定できます。

こちらもご覧ください

適用対象

SqlDataSource(String, String, String)

接続文字列と SELECT コマンドを指定して、SqlDataSource クラスの新しいインスタンスを初期化します。

public:
 SqlDataSource(System::String ^ providerName, System::String ^ connectionString, System::String ^ selectCommand);
public SqlDataSource (string providerName, string connectionString, string selectCommand);
new System.Web.UI.WebControls.SqlDataSource : string * string * string -> System.Web.UI.WebControls.SqlDataSource
Public Sub New (providerName As String, connectionString As String, selectCommand As String)

パラメーター

providerName
String

SqlDataSource が使用するデータ プロバイダーの名前。 プロバイダーが設定されていない場合、SqlDataSource は Microsoft SQL Server の ADO.NET プロバイダーを既定で使用します。

connectionString
String

基になるデータベースに接続するために使用する接続文字列。

selectCommand
String

基になるデータベースからデータを取得するために使用する SQL クエリ。 SQL クエリがパラメーター化された SQL 文字列の場合、Parameter コレクションへの SelectParameters オブジェクトの追加が必要になることがあります。

注釈

データベース製品によってさまざまなSQLが使用されるため、構文selectCommandは現在使用されている ADO.NET プロバイダーによって異なります。これはパラメーターによってproviderName識別されます。 SQL 文字列がパラメーター化されたクエリまたはコメントである場合は、パラメーターのプレースホルダーも現在使用している ADO.NET プロバイダーによって決まります。 たとえば、プロバイダーが System.Data.SqlClientクラスの既定のプロバイダー SqlDataSource である場合、パラメーターのプレースホルダーは '@parameterName'. ただし、プロバイダーが or System.Data.OleDbにSystem.Data.Odbc設定されている場合、パラメーターのプレースホルダーは '?'. パラメーター化されたSQLクエリとコマンドの詳細については、「SqlDataSource コントロールでのパラメーターの使用」を参照してください。

データ ソースがストアド プロシージャをサポートしている場合、プロパティにはSelectCommandSQL文字列またはストアド プロシージャの名前を指定できます。

こちらもご覧ください

適用対象