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

Определение

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

System.Data.SqlClient

Сборка:

System.Data.dll

Инициализирует новый экземпляр класса 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

Значение любого из этих свойств можно изменить с помощью отдельного вызова свойства .

См. также раздел

• Извлечение и изменение данных в 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
• Использование поставщика данных платформа .NET Framework для SQL Server
• Общие сведения об ADO.NET

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 параметра .

Вы можете изменить значение для любого из этих параметров, задав связанное свойство.

См. также раздел

• Подключение и получение данных в ADO.NET
• Использование поставщика данных платформа .NET Framework для SQL Server
• Общие сведения об ADO.NET

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 параметра .

Вы можете изменить значение для любого из этих параметров, задав связанное свойство.

См. также раздел

• Подключение и получение данных в ADO.NET
• Использование поставщика данных платформа .NET Framework для SQL Server
• Общие сведения об ADO.NET

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

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