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

Определение

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

System.Data.SqlClient

Сборка:

System.Data.SqlClient.dll

Пакет:

System.Data.SqlClient v4.8.6

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

Перегрузки

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

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