SqlCommand. This type deals with databases. It executes SQL commands on a database. It sends an SQL command to a database that is specified by an SqlConnection object.
We then call instance methods to physically apply the command to the database. We use a SELECT TOP command text, and also ORDER BY.
Example. This program uses the SqlCommand data object in C#. We use SqlCommand in the context of a complete but trivial program that reads data from a specific database on the disk.
Info The SqlCommand type has a public parameterized constructor and it can be used with one or more arguments.
And The first parameter specifies the SQL statement. The second parameter is the SqlConnection. The third parameter is the SqlTransaction.
Important This program interfaces with the SQL Server engine. It uses some project-specific external data.
Detail It will not work for you unless you change the connection string reference and the SQL command text for your environment.
using System;
using System.Data.SqlClient;
class Program
{
static void Main()
{
//// The program accesses the connection string.// ... It uses it on a connection.//
string conString = ConsoleApplication1.Properties.Settings.Default.ConnectionString;
using (SqlConnection connection = new SqlConnection(conString))
{
connection.Open();
//// SqlCommand should be created inside using.// ... It receives the SQL statement.// ... It receives the connection object.// ... The SQL text works with a specific database.//
using (SqlCommand command = new SqlCommand("SELECT TOP 3 * FROM Dogs1 ORDER BY Weight", connection))
{
//// Instance methods can be used on the SqlCommand.// ... These read data.//
using (SqlDataReader reader = command.ExecuteReader())
{
while (reader.Read())
{
for (int i = 0; i < reader.FieldCount; i++)
{
Console.WriteLine(reader.GetValue(i));
}
Console.WriteLine();
}
}
}
}
}
}7
Candy
Yorkshire Terrier
25
Charles
Cavalier King Charles Spaniel
57
Koko
Shar Pei
Using. The SQL data objects are wrapped in a resource acquisition statement. This ensures that resources are properly acquired and disposed of when no longer needed.
Constructor. The call to the SqlCommand constructor uses 2 parameters. The first parameter is the actual SQL source text. This string uses SQL and is not compiled by the C# compiler.
And The second parameter is the SqlConnection object. This is set up elsewhere in the program.
Detail You must manually specify the connection to use on the SqlCommand. This can be done with a parameter on the constructor.
A summary. We wrote a complete program that reads from a database on the local disk. The SqlCommand has a constructor. You can specify its connection and the SQL text.
Dot Net Perls is a collection of tested code examples. Pages are continually updated to stay current, with code correctness a top priority.
Sam Allen is passionate about computer languages. In the past, his work has been recommended by Apple and Microsoft and he has studied computers at a selective university in the United States.
This page was last updated on Oct 11, 2023 (edit).