ExecuteDataSet(CommandType,String,DataParameterCollection) Method
The CommandType to use when executing the commandText statement.
The text command to execute. The default value is an empty string ("").
A collection of parameters to use as replacements for the parameterized sections of the commandText
Executes the the specified parameterized SQL command with the specified parameters against the database using the default DbProvider and returns the results as a DataSet
Syntax
'Declaration
Public Overloads Shared Function ExecuteDataSet( _
ByVal _commandType_ As CommandType, _
ByVal _commandText_ As String, _
ByVal _commandParams_ As DataParameterCollection _
) As DataSet
public static DataSet ExecuteDataSet(
CommandType _commandType_,
string _commandText_,
DataParameterCollection _commandParams_
)
Parameters
commandType
The CommandType to use when executing the commandText statement.
commandText
The text command to execute. The default value is an empty string ("").
commandParams
A collection of parameters to use as replacements for the parameterized sections of the commandText
Return Value
A DataSet with zero or more DataTable objects each containing zero or more rows.
Remarks
The parameters in the commandParams parameter must be in the same ordinal number as the parameters specified in the commandText parameter. For example, if the "nameVal" parameter is to replace the {0} parameter in the commandText, it must be the first (zero position) parameter in the commandParams collection.
Not all providers return a DataSet with the same structure if no results are returned by the query. Some providers return an empty DataSet. Some providers return a DataSet with a single DataTable which contains zero rows. Test for tables and rows using the Count property on the DataSet and any DataTables before assuming any Tables or Rows exist.
In no case will the DataSet returned be a null reference (Nothing in Visual Basic).
When the commandType parameter is set to StoredProcedure, set the commandText parameter to the name of the stored procedure. The user may be required to use escape character syntax if the stored procedure name contains any special characters. The command will call this stored procedure when you call one of the Execute methods.
Requirements
Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server family