Sends the System.Data.SqlClient.SqlCommand.CommandText to the System.Data.SqlClient.SqlCommand.Connection, and builds a System.Data.DataTable.

[Visual Basic]
Shared  OverloadsPublic Function ExecuteDataTable( _ 
   ByVal connection As SqlConnection, _ 
   ByVal commandText As String, _ 
   ByVal commandType As CommandType, _ 
   ByVal ParamArray parameters As SqlParameter() _ 
) As DataTable
[C#]
public static DataTable ExecuteDataTable(
   SqlConnection connection,
   string commandText,
   CommandType commandType,
   params SqlParameter[] parameters
);
[C++]
public: static DataTable* ExecuteDataTable(
   SqlConnection* connection,
   String* commandText,
   CommandType commandType,
   SqlParameter* parameters __gc[]
);
[JScript]
public static function ExecuteDataTable(
   SqlConnection connection,
   String commandText,
   CommandType commandType,
   SqlParameter[] parameters
): DataTable;

Parameters

connection

Represents an open connection to a SQL Server database.

commandText

The text of the query.

commandType

Specifies how a command string is interpreted.

parameters

A list of type System.Data.SqlClient.SqlParameter that maps to the System.Data.SqlClient.SqlCommand.

Return Value

A representation of one table of in-memory data.

Remarks

Use the ExecuteDataTable method to retrieve a System.Data.DataTable from a database. This requires less code than using the SqlDataAdapter.Fill method, performing the operations necessary to generate the table of in-memory data returned by a SqlDataAdapter.

Example

[C#, Visual Basic] The following example creates a SqlDataAdapter and then executes it using the Fill method. The example is passed a string that is a Transact-SQL statement that returns an aggregate result.

[C#]
SqlConnection connection = new SqlConnection("Server=127.0.0.1;Database=Northwind;Uid=sa;Pwd=;");

DataTable customers = DatabaseUtility.ExecuteDataTable(
    connection,
    "SELECT * FROM Customers WHERE CustomerID = @CustomerID",
    CommandType.Text,
    new SqlParameter("@CustomerID", "ALFKI")
);
[Visual Basic]
Dim connection As New SqlConnection("Server=127.0.0.1;Database=Northwind;Uid=sa;Pwd=;")

DataTable customers = DatabaseUtility.ExecuteDataTable( _
    connection, _
    "SELECT * FROM Customers WHERE CustomerID = @CustomerID", _
    CommandType.Text, _
    new SqlParameter("@CustomerID", "ALFKI") _
)

            

See Also

DatabaseUtility Class | Joel.Net Namespace | DatabaseUtility.ExecuteDataTable Overload List