SqlCommand 类
表示要对 SQL Server 数据库执行的一个 Transact-SQL 语句或存储过程。无法继承此类。
**命名空间:**System.Data.SqlClient
**程序集:**System.Data（在 system.data.dll 中）
语法
声明
Public NotInheritable Class SqlCommand
Inherits DbCommand
Implements ICloneable
用法
Dim instance As SqlCommand
public sealed class SqlCommand : DbCommand, ICloneable
public ref class SqlCommand sealed : public DbCommand, ICloneable
public final class SqlCommand extends DbCommand implements ICloneable
public final class SqlCommand extends DbCommand implements ICloneable
备注
当创建 SqlCommand 的实例时，读/写属性将被设置为它们的初始值。有关这些值的列表，请参见 SqlCommand 构造函数。
SqlCommand 特别提供了以下对 SQL Server 数据库执行命令的方法：
项 |
说明 |
|---|---|
启动此 SqlCommand 描述的 Transact-SQL 语句或存储过程的异步执行，一般情况下执行 INSERT、DELETE、UPDATE 和 SET 语句等命令。每调用一次 BeginExecuteNonQuery，都必须调用一次通常在单独的线程上完成操作的 EndExecuteNonQuery。 |
|
启动此 SqlCommand 描述的 Transact-SQL 语句或存储过程的异步执行，并从服务器中检索一个或多个结果集。每调用一次 BeginExecuteReader，都必须调用一次通常在单独的线程上完成操作的 EndExecuteReader。 |
|
启动此 SqlCommand 描述的 Transact-SQL 语句或存储过程的异步执行。每调用一次 BeginExecuteXmlReader，都必须调用一次 EndExecuteXmlReader，它通常在单独的线程上完成操作，并且返回一个 XmlReader 对象。 |
|
执行返回行的命令。为了提高性能，ExecuteReader 使用 Transact-SQL sp_executesql 系统存储过程调用命令。因此，如果 ExecuteReader 用于执行命令（例如 Transact-SQL SET 语句），则它可能不会产生预期的效果。 |
|
执行 Transact-SQL INSERT、DELETE、UPDATE 及 SET 语句等命令。 |
|
从数据库中检索单个值（例如一个聚合值）。 |
|
将 CommandText 发送到 Connection 并生成一个 XmlReader 对象。 |
您可以重置 CommandText 属性并重复使用 SqlCommand 对象。但是，在执行新的命令或先前命令之前，必须关闭 SqlDataReader。
如果执行 SqlCommand 的方法生成 SqlException，那么当严重级别小于等于 19 时，SqlConnection 将仍保持打开状态。当严重级别大于等于 20 时，服务器通常会关闭 SqlConnection。但是，用户可以重新打开连接并继续操作。
| 主题 | 位置 |
|---|---|
| 演练：在 TreeView 控件中显示分层数据 | 在 Visual Studio 中构建 ASP .NET Web 应用程序 |
| 演练：在 TreeView 控件中显示分层数据 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
| 演练：在 TreeView 控件中显示分层数据 | 在 Visual Studio 中生成 ASP .NET Web 应用程序 |
示例
下面的示例创建一个 SqlConnection、一个 SqlCommand 和一个 SqlDataReader。该示例读取所有数据，并将其写到控制台。最后，该示例先关闭 SqlDataReader，然后关闭 SqlConnection。
Public Sub ReadOrderData(ByVal connectionString As String)
Dim queryString As String = _
"SELECT OrderID, CustomerID FROM dbo.Orders;"
Using connection As New SqlConnection(connectionString)
Dim command As New SqlCommand(queryString, connection)
connection.Open()
Dim reader As SqlDataReader = command.ExecuteReader()
Try
While reader.Read()
Console.WriteLine(String.Format("{0}, {1}", _
reader(0), reader(1)))
End While
Finally
' Always call Close when done reading.
reader.Close()
End Try
End Using
End Sub
private static void ReadOrderData(string connectionString)
{
string queryString =
"SELECT OrderID, CustomerID FROM dbo.Orders;";
using (SqlConnection connection = new SqlConnection(
connectionString))
{
SqlCommand command = new SqlCommand(
queryString, connection);
connection.Open();
SqlDataReader reader = command.ExecuteReader();
try
{
while (reader.Read())
{
Console.WriteLine(String.Format("{0}, {1}",
reader[0], reader[1]));
}
}
finally
{
// Always call Close when done reading.
reader.Close();
}
}
}
继承层次结构
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Data.Common.DbCommand
System.Data.SqlClient.SqlCommand
线程安全
此类型的任何公共静态（Visual Basic 中的 Shared）成员都是线程安全的，但不保证所有实例成员都是线程安全的。
平台
Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition
.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。
版本信息
.NET Framework
受以下版本支持：2.0、1.1、1.0
.NET Compact Framework
受以下版本支持：2.0、1.0
请参见
参考
SqlCommand 成员
System.Data.SqlClient 命名空间