Поделиться через


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

Определение

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

Перегрузки

SqlCommand()

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

SqlCommand(String)

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

SqlCommand(String, SqlConnection)

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

SqlCommand(String, SqlConnection, SqlTransaction)

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

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)

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

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

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

Примеры

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

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

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

Объект 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, 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

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

transaction
SqlTransaction

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

columnEncryptionSetting
SqlCommandColumnEncryptionSetting

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

Применяется к