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 |
Значение любого из этих свойств можно изменить с помощью отдельного вызова свойства .
См. также раздел
- Подключение и получение данных в 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
Настройка шифрования. Дополнительные сведения см. в разделе Постоянное шифрование.