SqlCommand 构造函数

参考

定义

命名空间:: Microsoft.Data.SqlClient

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

包:: Microsoft.Data.SqlClient v1.0.19269.1

包:: Microsoft.Data.SqlClient v1.1.4

包:: Microsoft.Data.SqlClient v2.0.1

包:: Microsoft.Data.SqlClient v2.1.4

包:: Microsoft.Data.SqlClient v3.0.1

包:: Microsoft.Data.SqlClient v3.1.0

包:: Microsoft.Data.SqlClient v4.0.1

包:: Microsoft.Data.SqlClient v4.1.0

包:: Microsoft.Data.SqlClient v5.0.0

包:: Microsoft.Data.SqlClient v5.1.0

包:: Microsoft.Data.SqlClient v5.2.0

重要

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

重载

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 属性。

// <Snippet1>
using System;
using System.Xml;
using System.Data;
using Microsoft.Data.SqlClient;
using System.Data.Common;
using System.Windows.Forms;

public class Form1 : Form
{
    protected DataSet DataSet1;
    protected DataGrid dataGrid1;


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

注解

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

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

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

适用于

SqlCommand(String)

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

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

public SqlCommand (string cmdText);

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

Public Sub New (cmdText As String)

参数

cmdText: String

查询的文本。

示例

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

using System;
using System.Xml;
using System.Data;
using Microsoft.Data.SqlClient;
using System.Data.Common;
using System.Windows.Forms;

public class Form1 : Form
{
    protected DataSet DataSet1;
    protected DataGrid dataGrid1;


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

注解

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

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

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

适用于

SqlCommand(String, SqlConnection)

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

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

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

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

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

参数

cmdText: String

查询的文本。

connection: SqlConnection

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

示例

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

using System;
using System.Data;
using Microsoft.Data.SqlClient;


namespace SqlCommandCS
{
    class Program
    {
        static void Main()
        {
            string str = "Data Source=(local);Initial Catalog=Northwind;"
                + "Integrated Security=SSPI";
            string qs = "SELECT OrderID, CustomerID FROM dbo.Orders;";
            CreateCommand(qs, str);

        }

        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]));
                }
            }
        }

注解

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

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

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

适用于

SqlCommand(String, SqlConnection, SqlTransaction)

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

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

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

new Microsoft.Data.SqlClient.SqlCommand : string * Microsoft.Data.SqlClient.SqlConnection * Microsoft.Data.SqlClient.SqlTransaction -> Microsoft.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, Microsoft::Data::SqlClient::SqlConnection ^ connection, Microsoft::Data::SqlClient::SqlTransaction ^ transaction, Microsoft::Data::SqlClient::SqlCommandColumnEncryptionSetting columnEncryptionSetting);

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

new Microsoft.Data.SqlClient.SqlCommand : string * Microsoft.Data.SqlClient.SqlConnection * Microsoft.Data.SqlClient.SqlTransaction * Microsoft.Data.SqlClient.SqlCommandColumnEncryptionSetting -> Microsoft.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)

参数

适用于

其他资源