次の方法で共有

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 フォーム ページではなく、ビジネス オブジェクトがデータベースと対話するための簡単な方法として中間層オブジェクトの実装で使用されているという 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'。 ただし、プロバイダーが または に System.Data.Odbc 設定されている場合、 System.Data.OleDbパラメーターのプレースホルダーは です '?'。 パラメーター化された SQL クエリとコマンドの詳細については、「 SqlDataSource コントロールでのパラメーターの使用」を参照してください。

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

こちらもご覧ください

適用対象

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'。 ただし、プロバイダーが または に System.Data.Odbc 設定されている場合、 System.Data.OleDbパラメーターのプレースホルダーは です '?'。 パラメーター化された SQL クエリとコマンドの詳細については、「 SqlDataSource コントロールでのパラメーターの使用」を参照してください。

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

こちらもご覧ください

適用対象