SqlCommand 构造函数

定义

命名空间:

System.Data.SqlClient

程序集:

System.Data.SqlClient.dll

包:

System.Data.SqlClient v4.8.6

初始化 SqlCommand 类的新实例。

重载

SqlCommand()	初始化 SqlCommand 类的新实例。
SqlCommand(String)	使用查询的文本初始化 SqlCommand 类的新实例。
SqlCommand(String, SqlConnection)	使用查询的文本和 SqlConnection 初始化 SqlCommand 类的新实例。
SqlCommand(String, SqlConnection, SqlTransaction)	使用查询文本、SqlConnection 以及 SqlTransaction 初始化 SqlCommand 类的新实例。

SqlCommand()

初始化 SqlCommand 类的新实例。

public:
 SqlCommand();

public SqlCommand ();

Public Sub New ()

示例

以下示例创建 SqlCommand 并设置 CommandTimeout 属性。

public void CreateSqlCommand()
{
   SqlCommand command = new SqlCommand();
   command.CommandTimeout = 15;
   command.CommandType = CommandType.Text;
}

Public Sub CreateSqlCommand()
    Dim command As New SqlCommand()
    command.CommandTimeout = 15
    command.CommandType = CommandType.Text
End Sub

注解

基构造函数将所有字段初始化为其默认值。 下表显示了 实例 SqlCommand的初始属性值。

属性	初始值
CommandText	空字符串 (“”)
CommandTimeout	30
CommandType	CommandType.Text
Connection	Null

可以通过单独调用 属性来更改其中任何属性的值。

另请参阅

• 在 ADO.NET 中检索和修改数据
• SQL Server 和 ADO.NET
• ADO.NET 概述

SqlCommand(String)

使用查询的文本初始化 SqlCommand 类的新实例。

public:
 SqlCommand(System::String ^ cmdText);

public SqlCommand (string cmdText);

new System.Data.SqlClient.SqlCommand : string -> System.Data.SqlClient.SqlCommand

Public Sub New (cmdText As String)

参数

cmdText

String

查询的文本。

示例

以下示例创建一个 SqlCommand，传入连接字符串和命令文本。

public void CreateCommand()
 {
    string queryString = "SELECT * FROM Categories ORDER BY CategoryID";
    SqlCommand command = new SqlCommand(queryString);
    command.CommandTimeout = 15;
    command.CommandType = CommandType.Text;
 }

Public Sub CreateCommand()
    Dim queryString As String = "SELECT * FROM Categories ORDER BY CategoryID"
    Dim command As New SqlCommand(queryString)
    command.CommandTimeout = 15
    command.CommandType = CommandType.Text
End Sub

注解

创建 实例 SqlCommand 时，以下读/写属性设置为初始值。

属性	初始值
CommandText	cmdText
CommandTimeout	30
CommandType	CommandType.Text
Connection	null

可以通过单独调用 属性来更改其中任何属性的值。

另请参阅

• 在 ADO.NET 中连接和检索数据
• 使用适用于 SQL Server 的 .NET Framework 数据提供程序
• ADO.NET 概述

SqlCommand(String, SqlConnection)

使用查询的文本和 SqlConnection 初始化 SqlCommand 类的新实例。

public:
 SqlCommand(System::String ^ cmdText, System::Data::SqlClient::SqlConnection ^ connection);

public SqlCommand (string cmdText, System.Data.SqlClient.SqlConnection connection);

new System.Data.SqlClient.SqlCommand : string * System.Data.SqlClient.SqlConnection -> System.Data.SqlClient.SqlCommand

Public Sub New (cmdText As String, connection As SqlConnection)

参数

cmdText

String

查询的文本。

connection

SqlConnection

表示到 SQL Server 实例的连接的 SqlConnection。

示例

以下示例创建 SqlCommand 并设置其一些属性。

private static void CreateCommand(string queryString,
    string connectionString)
{
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand(
            queryString, connection);
        connection.Open();
        SqlDataReader reader = command.ExecuteReader();
        while (reader.Read())
        {
            Console.WriteLine(String.Format("{0}, {1}",
                reader[0], reader[1]));
        }
    }
}

Public Sub CreateCommand(ByVal queryString As String, _
  ByVal connectionString As String)
    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)

        connection.Open()
        Dim reader As SqlDataReader = command.ExecuteReader()
            While reader.Read()
            Console.WriteLine(String.Format("{0}, {1}", _
                reader(0), reader(1)))
        End While
    End Using
End Sub

注解

下表显示了 实例 SqlCommand的初始属性值。

属性	初始值
CommandText	cmdText
CommandTimeout	30
CommandType	CommandType.Text
Connection	一个新的 SqlConnection ，它是 参数的值 connection 。

可以通过设置相关属性来更改其中任何参数的值。

另请参阅

• 在 ADO.NET 中连接和检索数据
• 使用适用于 SQL Server 的 .NET Framework 数据提供程序
• ADO.NET 概述

SqlCommand(String, SqlConnection, SqlTransaction)

使用查询文本、SqlConnection 以及 SqlTransaction 初始化 SqlCommand 类的新实例。

public:
 SqlCommand(System::String ^ cmdText, System::Data::SqlClient::SqlConnection ^ connection, System::Data::SqlClient::SqlTransaction ^ transaction);

public SqlCommand (string cmdText, System.Data.SqlClient.SqlConnection connection, System.Data.SqlClient.SqlTransaction transaction);

new System.Data.SqlClient.SqlCommand : string * System.Data.SqlClient.SqlConnection * System.Data.SqlClient.SqlTransaction -> System.Data.SqlClient.SqlCommand

Public Sub New (cmdText As String, connection As SqlConnection, transaction As SqlTransaction)

参数

cmdText

String

查询的文本。

connection

SqlConnection

表示到 SQL Server 实例的连接的 SqlConnection。

transaction

SqlTransaction

其中执行 SqlCommand 的 SqlTransaction。

注解

下表显示了 实例 SqlCommand的初始属性值。

属性	初始值
CommandText	cmdText
CommandTimeout	30
CommandType	CommandType.Text
Connection	一个新的 SqlConnection ，它是 参数的值 connection 。

可以通过设置相关属性来更改其中任何参数的值。

另请参阅

• 在 ADO.NET 中连接和检索数据
• 使用适用于 SQL Server 的 .NET Framework 数据提供程序
• ADO.NET 概述