SelectCommand Property (SqlDataAdapter)

In This Topic

Gets or sets a SQL Server statement used to select records in the data source.

Syntax

Visual Basic
C#

'Declaration
 
Public Shadows Property SelectCommand As SqlCommand

public new SqlCommand SelectCommand {get; set;}

Property Value

A SqlCommand that is used during a fill operation to select records from the data source for placement in the System.Data.DataSet.

Remarks

When SelectCommand is assigned to a previously created SqlCommand, the SqlCommand is not cloned. Instead, the SelectCommand maintains a reference to the previously created SqlCommand object.

If SelectCommand does not return any rows, no tables are added to the System.Data.DataSet, and no exception is raised.

This property supports the InterForm technology.

Example

The following example creates a SqlDataAdapter, sets some of its properties, retrieves data from a table, and displays it.

csharp

public void CreateDataAdapter(SqlConnection myConnection)
{
  SqlDataAdapter myAdapter = new SqlDataAdapter();
  myAdapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;
  DataSet myDataSet = new DataSet();
  myAdapter.SelectCommand = new SqlCommand("SELECT DeptNo, DName FROM Test.Dept", myConnection);
  myAdapter.Fill(myDataSet,"Dept");
  //Get all data from all tables within the dataset
  foreach(DataTable myTable in myDataSet.Tables)
  {
    foreach(DataRow myRow in myTable.Rows)
    {
      foreach (DataColumn myColumn in myTable.Columns)
      {
        Console.Write(myRow[myColumn]+"\t");
      }
      Console.WriteLine();
    }
    Console.WriteLine();
  }
}

Visual Basic

Public Sub CreateDataAdapter(ByVal myConnection As SqlConnection)
  Dim myAdapter As SqlDataAdapter = New SqlDataAdapter
  myAdapter.MissingSchemaAction = MissingSchemaAction.AddWithKey
  Dim myDataSet As DataSet = New DataSet
  myAdapter.SelectCommand = New SqlCommand("SELECT DeptNo, DName FROM Test.Dept", myConnection)
  myAdapter.Fill(myDataSet, "Dept")
  Dim myTable As DataTable
  Dim myRow As DataRow
  Dim myColumn As DataColumn
  ' Get all data from all tables within the dataset
  For Each myTable In myDataSet.Tables
    For Each myRow In myTable.Rows
      For Each myColumn In myTable.Columns
        Console.Write(myRow(myColumn) & Chr(9))
      Next myColumn
      Console.WriteLine()
    Next myRow
    Console.WriteLine()
  Next myTable
End Sub

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

SqlDataAdapter Class
SqlDataAdapter Members
DeleteCommand Property
InsertCommand Property
UpdateCommand Property

Send Feedback