Partilhar via


SqlCommand Construtores

Definição

Sobrecargas

SqlCommand()

Inicializa uma nova instância da classe SqlCommand.

SqlCommand(String)

Inicializa uma nova instância da classe SqlCommand com o texto da consulta.

SqlCommand(String, SqlConnection)

Inicializa uma nova instância da SqlCommand classe com o texto da consulta e um SqlConnection .

SqlCommand(String, SqlConnection, SqlTransaction)

Inicializa uma nova instância da SqlCommand classe com o texto da consulta, um SqlConnection e o SqlTransaction .

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)

Inicializa uma nova instância da classe SqlCommand com texto de comando especificado, conexões, transações e configuração de criptografia.

SqlCommand()

Inicializa uma nova instância da classe SqlCommand.

public:
 SqlCommand();
public SqlCommand ();
Public Sub New ()

Exemplos

O exemplo a seguir cria um SqlCommand e define a CommandTimeout propriedade .

// <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>
}

Comentários

O construtor base inicializa todos os campos para seus valores padrão. A tabela a seguir mostra valores de propriedade iniciais para uma instância do SqlCommand.

Propriedades Valor inicial
CommandText cadeia de caracteres vazia ("")
CommandTimeout 30
CommandType CommandType.Text
Connection Nulo

Você pode alterar o valor de qualquer uma dessas propriedades por meio de uma chamada separada para a propriedade .

Aplica-se a

SqlCommand(String)

Inicializa uma nova instância da classe SqlCommand com o texto da consulta.

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)

Parâmetros

cmdText
String

O texto da consulta.

Exemplos

O exemplo a seguir cria um SqlCommand, passando a cadeia de conexão e o texto do comando.

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;
    }

Comentários

Quando uma instância de é criada, as propriedades de SqlCommand leitura/gravação a seguir são definidas como valores iniciais.

Propriedades Valor inicial
CommandText cmdText
CommandTimeout 30
CommandType CommandType.Text
Connection null

Você pode alterar o valor de qualquer uma dessas propriedades por meio de uma chamada separada para a propriedade .

Aplica-se a

SqlCommand(String, SqlConnection)

Inicializa uma nova instância da SqlCommand classe com o texto da consulta e um 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)

Parâmetros

cmdText
String

O texto da consulta.

connection
SqlConnection

Um SqlConnection que representa a conexão com uma instância do SQL Server.

Exemplos

O exemplo a seguir cria um SqlCommand e define algumas de suas propriedades.

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]));
                }
            }
        }

Comentários

A tabela a seguir mostra valores de propriedade iniciais para uma instância do SqlCommand.

Propriedades Valor inicial
CommandText cmdText
CommandTimeout 30
CommandType CommandType.Text
Connection Uma nova SqlConnection que é o valor para o connection parâmetro .

Você pode alterar o valor de qualquer um desses parâmetros definindo a propriedade relacionada.

Aplica-se a

SqlCommand(String, SqlConnection, SqlTransaction)

Inicializa uma nova instância da SqlCommand classe com o texto da consulta, um SqlConnection e o SqlTransaction .

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)

Parâmetros

cmdText
String

O texto da consulta.

connection
SqlConnection

Um SqlConnection que representa a conexão com uma instância do SQL Server.

transaction
SqlTransaction

O SqlTransaction no qual o SqlCommand é executado.

Comentários

A tabela a seguir mostra valores de propriedade iniciais para uma instância do SqlCommand.

Propriedades Valor inicial
CommandText cmdText
CommandTimeout 30
CommandType CommandType.Text
Connection Uma nova SqlConnection que é o valor para o connection parâmetro .

Você pode alterar o valor de qualquer um desses parâmetros definindo a propriedade relacionada.

Aplica-se a

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)

Inicializa uma nova instância da classe SqlCommand com texto de comando especificado, conexões, transações e configuração de criptografia.

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)

Parâmetros

cmdText
String

O texto da consulta.

connection
SqlConnection

Um SqlConnection que representa a conexão com uma instância do SQL Server.

transaction
SqlTransaction

O SqlTransaction no qual o SqlCommand é executado.

columnEncryptionSetting
SqlCommandColumnEncryptionSetting

A configuração de criptografia. Para obter mais informações, consulte Always Encrypted.

Aplica-se a