SqlCommand Конструкторы

Определение

Пространство имен:

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v5.2.0

Перегрузки

SqlCommand()	Инициализирует новый экземпляр класса SqlCommand.
SqlCommand(String)	Инициализирует новый экземпляр класса SqlCommand текстом запроса.
SqlCommand(String, SqlConnection)	Инициализирует новый экземпляр SqlCommand класса с текстом запроса и .SqlConnection
SqlCommand(String, SqlConnection, SqlTransaction)	Инициализирует новый экземпляр SqlCommand класса с текстом запроса , и SqlConnectionSqlTransaction .
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)

Инициализирует новый экземпляр SqlCommand класса с текстом запроса и .SqlConnection

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

Объект SqlConnection, представляющий подключение к экземпляру SQL Server.

Примеры

В следующем примере создается 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)

Инициализирует новый экземпляр SqlCommand класса с текстом запроса , и SqlConnectionSqlTransaction .

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

Объект SqlConnection, представляющий подключение к экземпляру SQL Server.

transaction

SqlTransaction

SqlTransaction, в которой выполняется SqlCommand.

Комментарии

В следующей таблице показаны начальные значения свойств для экземпляра 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

Объект SqlConnection, представляющий подключение к экземпляру SQL Server.

transaction

SqlTransaction

SqlTransaction, в которой выполняется SqlCommand.

columnEncryptionSetting

SqlCommandColumnEncryptionSetting

Настройка шифрования. Дополнительные сведения см. в разделе Постоянное шифрование.