SqlCommand Construtores

Definição

Espaço de Nomes:: System.Data.SqlClient

Assemblagem:: System.Data.SqlClient.dll

Assemblagem:: System.Data.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Inicializa uma nova instância da SqlCommand classe.

Sobrecargas

Name	Descrição
SqlCommand()	Inicializa uma nova instância da SqlCommand classe.
SqlCommand(String)	Inicializa uma nova instância da SqlCommand classe 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 SqlCommand classe com texto de comando especificado, ligação, transação e definição de encriptação.

SqlCommand()

Origem:: System.Data.SqlClient.notsupported.cs

Inicializa uma nova instância da SqlCommand classe.

public:
 SqlCommand();

public SqlCommand();

Public Sub New ()

Exemplos

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

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

Observações

O construtor base inicializa todos os campos aos seus valores padrão. A tabela seguinte mostra os valores iniciais das propriedades para uma instância de SqlCommand.

Properties	Valor inicial
CommandText	corda vazia ("")
CommandTimeout	30
CommandType	`CommandType.Text`
Connection	Null

Pode alterar o valor de qualquer uma destas propriedades através de uma chamada separada para a propriedade.

Ver também

Aplica-se a

SqlCommand(String)

Origem:: System.Data.SqlClient.notsupported.cs

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

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)

Parâmetros

cmdText: String

O texto da consulta.

Exemplos

O exemplo seguinte cria um SqlCommand, passando o texto do comando.

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

Observações

Quando uma instância de SqlCommand é criada, as seguintes propriedades de leitura/escrita são definidas para valores iniciais.

Properties	Valor inicial
CommandText	`cmdText`
CommandTimeout	30
CommandType	`CommandType.Text`
Connection	null

Pode alterar o valor de qualquer uma destas propriedades através de uma chamada separada para a propriedade.

Ver também

Aplica-se a

SqlCommand(String, SqlConnection)

Origem:: System.Data.SqlClient.notsupported.cs

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

Parâmetros

cmdText: String

O texto da consulta.

connection: SqlConnection

Um SqlConnection que representa a ligação a uma instância de SQL Server.

Exemplos

O exemplo seguinte cria um SqlCommand e define algumas das suas propriedades.

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

Observações

A tabela seguinte mostra os valores iniciais das propriedades para uma instância de SqlCommand.

Properties	Valor inicial
CommandText	`cmdText`
CommandTimeout	30
CommandType	`CommandType.Text`
Connection	Um novo SqlConnection é o valor do `connection` parâmetro.

Pode alterar o valor de qualquer um destes parâmetros definindo a propriedade relacionada.

Ver também

Aplica-se a

SqlCommand(String, SqlConnection, SqlTransaction)

Origem:: System.Data.SqlClient.notsupported.cs

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

Parâmetros

cmdText: String

O texto da consulta.

connection: SqlConnection

Um SqlConnection que representa a ligação a uma instância de SQL Server.

transaction: SqlTransaction

O SqlTransaction em que o SqlCommand executa.

Observações

A tabela seguinte mostra os valores iniciais das propriedades para uma instância de SqlCommand.

Properties	Valor inicial
CommandText	`cmdText`
CommandTimeout	30
CommandType	`CommandType.Text`
Connection	Um novo SqlConnection é o valor do `connection` parâmetro.

Pode alterar o valor de qualquer um destes parâmetros definindo a propriedade relacionada.

Ver também

Aplica-se a

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)

Inicializa uma nova instância da SqlCommand classe com texto de comando especificado, ligação, transação e definição de encriptação.

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)

Parâmetros

cmdText: String

O texto da consulta.

connection: SqlConnection

Um SqlConnection que representa a ligação a uma instância de SQL Server.

transaction: SqlTransaction

O SqlTransaction em que o SqlCommand executa.

columnEncryptionSetting: SqlCommandColumnEncryptionSetting

A definição de encriptação. Para obter mais informações, consulte Sempre criptografado.

Aplica-se a

Comentários

Esta página foi útil?