SqlCommand 构造函数

参考

定义

命名空间:: System.Data.SqlClient

程序集:: System.Data.SqlClient.dll

程序集:: System.Data.dll

程序集:: netstandard.dll, System.Data.SqlClient.dll

包:: System.Data.SqlClient v4.8.6

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

初始化 SqlCommand 类的新实例。

重载

SqlCommand()	初始化 SqlCommand 类的新实例。
SqlCommand(String)	使用查询的文本初始化 SqlCommand 类的新实例。
SqlCommand(String, SqlConnection)	使用查询的文本和 SqlConnection 初始化 SqlCommand 类的新实例。
SqlCommand(String, SqlConnection, SqlTransaction)	使用查询文本、SqlConnection 以及 SqlTransaction 初始化 SqlCommand 类的新实例。
SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)	使用指定的命令文本、连接、事务和加密设置初始化 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

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

另请参阅

适用于

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

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

另请参阅

适用于

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` 。

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

另请参阅

适用于

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` 。

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

另请参阅

适用于

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)

使用指定的命令文本、连接、事务和加密设置初始化 SqlCommand 类的新实例。

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

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

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

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

参数

cmdText: String

查询的文本。

connection: SqlConnection

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

transaction: SqlTransaction

其中执行 SqlCommand 的 SqlTransaction。

columnEncryptionSetting: SqlCommandColumnEncryptionSetting

加密设置。有关详细信息，请参阅 Always Encrypted。

适用于

通过

SqlCommand 构造函数

定义

重载

SqlCommand()

示例

注解

另请参阅

适用于

SqlCommand(String)

参数

示例

注解

另请参阅

适用于

SqlCommand(String, SqlConnection)

参数

示例

注解

另请参阅

适用于

SqlCommand(String, SqlConnection, SqlTransaction)

参数

注解

另请参阅

适用于

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)

参数

适用于

其他资源