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

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

Parameters

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 System.Data.SqlClient.SqlDataReader object.

Example

[C#, Visual Basic] The following example creates a SqlCommand, then executes it by passing a string that is a Transact-SQL SELECT statement, and a string to use to connect to the data source. CommandBehavior is set to CloseConnection.

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

SqlDataReader reader = DatabaseUtility.ExecuteReader(
    "SELECT * FROM Customers WHERE CustomerID = @CustomerID",
    CommandType.Text,
    new SqlParameter("@CustomerID", "ALFKI")
);

if (reader.Read()) {
    Console.WriteLine("ExecuteReader: {0}, {1}, {2}", reader["CustomerID"], reader["CompanyName"], reader["ContactName"]);
}

reader.Close(); // this will close the connection (only if connection was not opened before ExecuteReader)
[Visual Basic]
DatabaseUtility.Connection = New SqlConnection("Server=127.0.0.1;Database=Northwind;Uid=sa;Pwd=;")

SqlDataReader reader = DatabaseUtility.ExecuteReader( _
    "SELECT * FROM Customers WHERE CustomerID = @CustomerID", _
    CommandType.Text, _
    new SqlParameter("@CustomerID", "ALFKI") _
)

If (reader.Read()) Then
    Console.WriteLine("ExecuteReader: {0}, {1}, {2}", reader["CustomerID"], reader["CompanyName"], reader["ContactName"])
End If

reader.Close() // this will close the connection (only if connection was not opened before ExecuteReader)

            

See Also

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