- The first step is to create the following variables
- SQLCommand – The 'SQLCommand' is a class defined within C#. This class is used to perform operations of reading and writing into the database. Hence, the first step is to make sure that we create a variable type of this class. This variable will then be used in subsequent steps of reading data from our database.
- The DataReader object is used to get all the data specified by the SQL query. We can then read all the table rows one by one using the data reader.
- We then define 2 string variables, one is "SQL" to hold our SQL command string. The next is the "Output" which will contain all the table values.
- The next step is to define the SQL statement, which will be used against our database. In our case, it is "Select TutorialID, TutorialName from demotb". This will fetch all the rows from the table demotb.
- Next, we create the command object which is used to execute the SQL statement against the database. In the SQL command, you have to pass the connection object and the SQL string.
- Next, we will execute the data reader command, which will fetch all the rows from the demotb table.
- Now that we have all the rows of the table with us, we need a mechanism to access the row one by one. For this, we will use the while statement. The while statement will be used to access the rows from the data reader one at a time. We then use the GetValue method to get the value of TutorialID and TutorialName.
Step 2) In the final step, we will just display the output to the user and close all the objects related to the database operation.
Code Explanation:-
- We will continue our code by displaying the value of the Output variable using the MessageBox. The Output variable will contain all the values from the demotb table.
- We finally close all the objects related to our database operation. Remember this is always a good practice.
When the above code is set, and the project is run using Visual Studio, you will get the below output. Once the form is displayed, click the Connect button.
Output:-
From the output, you can clearly see that the program was able to get the values from the database. The data is then displayed in the message box.
C# Insert Into Database
Just like Accessing data, C# has the ability to insert records into the database as well. To showcase how to insert records into our database, let's take the same table structure which was used above.
TutorialID | TutorialName |
1 | C# |
2 | ASP.Net |
Let's change the code in our form, so that we can insert the following row into the table
TutorialID | TutorialName |
3 | VB.Net
|
So let's add the following code to our program. The below code snippet will be used to insert an existing record in our database.
Code Explanation:-
- The first step is to create the following variables
- SQLCommand – This data type is used to define objects which are used to perform SQL operations against a database. This object will hold the SQL command which will run against our SQL Server database.
- The DataAdapter object is used to perform specific SQL operations such as insert, delete and update commands.
- We then define a string variable, which is "SQL" to hold our SQL command string.
- The next step is to actually define the SQL statement which will be used against our database. In our case, we are issuing an insert statement, which will insert the record of TutorialID=1 and TutorialName=VB.Net
- Next, we create the command object which is used to execute the SQL statement against the database. In the SQL command, you have to pass the connection object and the SQL string
- In our data adapter command, we now associate the insert SQL command to our adapter. We also then issue the ExecuteNonQuery method which is used to execute the Insert statement against our database. The 'ExecuteNonQuery' method is used in C# to issue any DML statements against the database. By DML statements, we mean the insert, delete, and update operation. In C# , if you want to issue any of these statements against a table, you need to use the ExecuteNonQuery method.
- We finally close all the objects related to our database operation. Remember this is always a good practice.
When the above code is set, and the project is executed using Visual Studio, you will get the below output. Once the form is displayed, click the Connect button.
Output:-
If you go to SQL Server Express and see the rows in the demotb table, you will see the row inserted as shown below
C# Update Database
Just like Accessing data, C# has the ability to update existing records from the database as well. To showcase how to update records into our database, let's take the same table structure which was used above.
TutorialID | TutorialName |
1 | C# |
2 | ASP.Net |
3 | VB.Net |
Let's change the code in our form, so that we can update the following row. The old row value is TutorialID as "3" and Tutorial Name as "VB.Net". Which we will update it to "VB.Net complete" while the row value for Tutorial ID will remain same.
Old row
TutorialID | TutorialName |
3 | VB.Net |
New row
TutorialID | TutorialName |
3 | VB.Net complete |
So let's add the following code to our program. The below code snippet will be used to update an existing record in our database.
C# SqlCommand Example With Code Explanation:-
- The first step is to create the following variables
- SQLCommand – This data type is used to define objects which are used to perform SQL operations against a database. This object will hold the SQL command which will run against our SQL Server database.
- The dataadapter object is used to perform specific SQL operations such as insert, delete and update commands.
- We then define a string variable, which is SQL to hold our SQL command string.
- The next step is to define the SQL statement which will be used against our database. In our case we are issuing an update statement, this will update the Tutorial name to "VB.Net Complete" while the TutorialID is unchanged and kept as 3.
- Next, we will create the command object, which is used to execute the SQL statement against the database. In the SQL command, you have passed the connection object and the SQL string.
- In our data adapter command, we now associate the insert SQL command to our adapter. We also then issue the ExecuteNonQuery method which is used to execute the Update statement against our database.
- We finally close all the objects related to our database operation. Remember this is always a good practice.
When the above code is set, and the project is executed using Visual Studio, you will get the below output. Once the form is displayed, click the Connect button.
Output:-
If you actually go to SQL Server Express and see the rows in the demotb table, you will see the row was successfully updated as shown below.
Deleting Records
Just like Accessing data, C# has the ability to delete existing records from the database as well. To showcase how to delete records into our database, let's take the same table structure which was used above.
TutorialID | TutorialName |
1 | C# |
2 | ASP.Net |
3 | VB.Net complete |
Let's change the code in our form, so that we can delete the following row
TutorialID | TutorialName |
3 | VB.Net complete |
So let's add the following code to our program. The below code snippet will be used to delete an existing record in our database.
Code Explanation:-
- The Key difference in this code is that we are now issuing the delete SQL statement. The delete statement is used to delete the row in the demotb table in which the TutorialID has a value of 3.
- In our data adapter command, we now associate the insert SQL command to our adapter. We also then issue the ExecuteNonQuery method which is used to execute the Delete statement against our database.
When the above code is set, and the project is executed using Visual Studio, you will get the below output. Once the form is displayed, click the Connect button.
Output:-
If you actually go to SQL Server Express and see the rows in the demotb table, you will see the row was successfully deleted as shown below.
Connecting Controls to Data
In the earlier sections, we have seen how to we can use C# commands such as SQLCommand and SQLReader to fetch data from a database. We also saw how we read each row of the table and use a messagebox to display the contents of a table to the user.
But obviously, users don't want to see data sent via message boxes and would want better controls to display the data. Let's take the below data structure in a table
TutorialID | TutorialName |
1 | C# |
2 | ASP.Net |
3 | VB.Net complete |
From the above data structure, the user would ideally want to see the TutorialID and Tutorial Name displayed in a textbox. Secondly, they might want to have some sort of button control which could allow them to go to the next record or to the previous record in the table. This would require a bit of extra coding from the developer's end.
The good news is that C# can reduce the additional coding effort by allowing binding of controls to data. What this means is that C# can automatically populate the value of the textbox as per a particular field of the table.
So, you can have 2 textboxes in a windows form. You can then link one text box to the TutorialID field and another textbox to the TutorialName field. This linking is done in the Visual Studio designer itself, and you don't need to write extra code for this.
Visual Studio will ensure that it writes the code for you to ensure the linkage works. Then when you run your application, the textbox controls will automatically connect to the database, fetch the data and display it in the textbox controls. No coding is required from the developer's end to achieve this.
Let's look at a code example of how we can achieve binding of controls.
In our example, we are going to create 2 textboxes on the windows form. They are going to represent the Tutorial ID and Tutorial Name respectively. They will be bound to the Tutorial ID and TutorialName fields of the database accordingly.
Let's follow the below-mentioned steps to achieve this.
Step 1) Construct the basic form. In the form drag and drop 2 components- labels and textboxes. Then carry out the following substeps
- Put the text value of the first label as TutorialID
- Put the text value of the second label as TutorialName
- Put the name property of the first textbox as txtID
- Put the name property of the second textbox as txtName
Below is the how the form would look like once the above-mentioned steps are performed.
Step 2) The next step is to add a binding Navigator to the form. The binding Navigator control can automatically navigate through each row of the table. To add the binding navigator, just go to the toolbox and drag it to the form.
Step 3) The next step is to add a binding to our database. This can be done by going to any of the Textbox control and clicking on the DataBindings->Text property. The Binding Navigator is used to establish a link from your application to a database.
When you perform this step, Visual Studio will automatically add the required code to the application to make sure the application is linked to the database. Normally the database in Visual Studio is referred to as a Project Data Source. So to ensure the connection is established between the application and the database, the first step is to create a project data source.
The following screen will show up. Click on the link- "Add Project Data Source". When you click on the project data source, you will be presented with a wizard; this will allow you to define the database connection.
Step 4) Once you click on the Add Project Data Source link, you will be presented with a wizard which will be used to create a connection to the demotb database. The following steps show in detail what needs to be configured during each step of the wizard.
- In the screen which pops up , choose the Data Source type as Database and then click on next button.
- In the next screen, you need to start the creation of the connection string to the database. The connection string is required for the application to establish a connection to the database. It contains the parameters such as server name, database name, and the name of the driver.
- Click on the New connection button
- Choose the Data Source as Microsoft SQL Server
- Click the Continue button.
- Next, you need to add the credentials to connect to the database
- Choose the server name on which the SQL Server resides
- Enter the user id and password to connect to the database
- Choose the database as demotb
- Click the 'ok' button.
- In this screen, we will confirm all the settings which were carried on the previous screens.
- Choose the option "Yes" to include sensitive data in the connection string
- Click on the "Next" button.
- In the next screen, click on the "Next" button to confirm the creation of the connection string
- In this step,
- Choose the tables of Demotb, which will be shown in the next screen.
- This table will now become an available data source in the C# project
When you click the Finish button, Visual Studio will now ensure that the application can query all the rows in the table Demotb.
Step 5) Now that the data source is defined, we now need to connect the TutorialID and TutorialName textbox to the demotb table. When you click on the Text property of either the TutorialID or TutorialName textbox, you will now see that the binding source to Demotb is available.
For the first text box choose the Tutorial ID. Repeat this step for the second textbox and choose the field as TutorialName. The below steps shows how we can navigate to each control and change the binding accordingly.
- Click on the Tutorial ID control.
- In the Properties window, you will see the properties of the TutorialID textbox. Go to the text property and click on the down arrow button.
- When you click the down arrow button, you will see the demotbBinding Source option. And under this, you will see the options of TutorialName and TutorialID. Choose the Tutorial ID one.
Repeat the above 3 steps for the Tutorial Name text box.
- So click on the Tutorial Name text box
- Go to the properties window
- Choose the Text property
- Choose the TutorialName option under demotbBindingSource
Step 6) Next we need to change the Binding Source property of the BindingNavigator to point to our Demotb data source. The reason we do this is that the Binding Navigator also needs to know which table it needs to refer to.
The Binding Navigator is used to select the next or previous record in the table. So even though the data source is added to the project as a whole and to the text box control, we still need to ensure the Binding Navigator also has a link to our data source. In order to do this, we need to click the Binding navigator object, go to the Binding Source property and choose the one that is available
Next, we need to go to the Properties window so that we can make the change to Binding Source property.
When all of the above steps are executed successfully, you will get the below-mentioned output.
Output:-
Now when the project is launched, you can see that the textboxes automatically get the values from the table.
When you click the Next button on the Navigator, it automatically goes to the next record in the table. And the values of the next record automatically come in the text boxes
C# DataGridView
Data Grids are used to display data from a table in a grid-like format. When a user sees's table data, they normally prefer seeing all the table rows in one shot. This can be achieved if we can display the data in a grid on the form.
C# and Visual Studio have inbuilt data grids, this can be used to display data. Let's take a look at an example of this. In our example, we will have a data grid, which will be used to display the Tutorial ID and Tutorial Name values from the demotb table.
Step 1) Drag the DataGridView control from the toolbox to the Form in Visual Studio. The DataGridView control is used in Visual Studio to display the rows of a table in a grid-like format.
Step 2) In the next step, we need to connect our data grid to the database. In the last section, we had created a project data source. Let's use the same data source in our example.
- First, you need to choose the grid and click on the arrow in the grid. This will bring up the grid configuration options.
- In the configuration options, just choose the data source as demotbBindingSource which was the data source created in the earlier section.
If all the above steps are executed as shown, you will get the below-mentioned output.
Output:-
From the output, you can see that the grid was populated by the values from the database.
Summary
- C# SQL can work with databases such as Oracle and Microsoft SQL Server.
- This C# database tutorial has all the commands which are required to work with databases. This involves establishing a connection to the database. You can perform operations such as select, update, insert and delete using the commands in C#.
- The DataReader object in C# is used to hold all the data returned by the database. The While loop in C# can be used to read the data rows one at a time.
- The data adapter object is used to perform SQL operations such as insert, delete, and update against the database.
- C# can bind controls to the various fields in a table. They are bound by defining a data source in C#. The data source is used to pull the data from the database and populate them in the controls.
- The binding navigator is used to automatically navigate through the rows in a table.
- The data grid in C# can connect to the database and display all the values from the table in a grid-like format.