This step-by-step article describes how to reuse the SqlCommand
object in your Visual C# .NET code.
Description of the Technique
You can reuse Command
) in code. That is, you can create one Command
object and then run different commands on that object.
Commands are issued against databases to take actions against data stores. Commands include any statement that can be issued against a database. You can use the OleDbCommand
or the SqlCommand
class to get a command for your data store.
In Microsoft ActiveX Data Objects (ADO), you can issue commands through the Command
, the Connection
, or the Recordset
object. In Microsoft ADO.NET, only the Command
) run commands.
Steps to Reuse a SqlCommand Object
- Create a new Windows application in Visual C# .NET as follows:
- Start Microsoft Visual Studio .NET.
- On the File menu, point to New, and then click Project.
- In the New Project dialog box, click Visual C# Projects under Project Types, and then click Windows Application under Templates. Form1 is added to the project by default.
- Verify that your project contains a reference to the System.Data namespace. If it does not, add a reference to this namespace.
- Drag a Button control from the toolbox to Form1. Change the Name property of the button to btnTest.
- Use the using statement on the System and the System.Data namespaces so that you are not required to qualify declarations in those namespaces later in your code. Add the following code to the "General Declarations" section of Form1:
- Copy and paste the following code in the btnTest_Click event:
string myConnString = "User ID=myUID;password=myPWD;Initial Catalog=pubs;Data Source=mySQLServer";
string mySelectQuery = "SELECT * FROM Titles";
SqlConnection myConnection = new SqlConnection(myConnString);
SqlCommand myCommand = new SqlCommand(mySelectQuery, myConnection);
SqlDataReader myReader = myCommand.ExecuteReader();
myReader.Close(); //Close the reader.
myCommand.CommandText = "SELECT * FROM Sales";
SqlDataReader myReader1 = myCommand.ExecuteReader();
myReader1.Close(); //Close the reader.
String myInsertQuery = "INSERT INTO Employee " +
"(emp_id, fname, minit, lname, job_id, job_lvl, pub_id, hire_date)" +
"VALUES ('MSD12923F', 'JP', 'W', 'Mackenzie', " +
myCommand.CommandText = myInsertQuery;
//You can use the command any number of times.
catch (Exception ex)
- Modify the connection string (myConnString) as appropriate for your environment.
- Save your project. On the Debug menu, click Start to run your project.
- While the SqlDataReader object is in use, the associated SqlConnection object serves the SqlDataReader, and you cannot perform any other operations on the SqlConnection object other than to close it. This is true until you call the Close method of the SqlDataReader object. This means, for example, that you cannot retrieve output parameters until after you call Close.For additional information about how to handle output parameters, click the article number below
to view the article in the Microsoft Knowledge Base:
PRB: Output Parameters Are Not Returned When You Run an ADO.NET Command in Visual C# .NET
- If the method that runs a SqlCommand generates a SqlException exception, the SqlConnection remains open if the severity level is 19 or less. If the severity level is 20 or greater, the server usually closes the SqlConnection. However, you can reopen the connection and continue.
For additional information, click the article numbers below
to view the articles in the Microsoft Knowledge Base:
INFO: Roadmap for ADO.NET
INFO: Roadmap for .NET Data Providers
HOW TO: Handle Multiple Results by Using the DataReader in Visual C# .NET
HOW TO: Connect to a Database and Run a Command by Using ADO.NET and Visual C# .NET
Article ID: 317559 - Last Review: September 3, 2003 - Revision: 2.2
- Microsoft ADO.NET 1.1
- Microsoft ADO.NET 1.0
- Microsoft Visual C# .NET 2003 Standard Edition
- Microsoft Visual C# .NET 2002 Standard Edition
|kbhowtomaster kbsqlclient kbsystemdata KB317559|