Classe SqlCeCommand

Representa uma instrução SQL a ser executada com relação a uma fonte de dados.

Hierarquia de herança

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Data.Common.DbCommand
        System.Data.SqlServerCe.SqlCeCommand

Namespace:  System.Data.SqlServerCe
Assembly:  System.Data.SqlServerCe (em System.Data.SqlServerCe.dll)

Sintaxe

'Declaração
Public NotInheritable Class SqlCeCommand _
    Inherits DbCommand _
    Implements ICloneable
'Uso
Dim instance As SqlCeCommand

public sealed class SqlCeCommand : DbCommand, 
    ICloneable

public ref class SqlCeCommand sealed : public DbCommand, 
    ICloneable

[<SealedAttribute>]
type SqlCeCommand =  
    class
        inherit DbCommand
        interface ICloneable
    end

public final class SqlCeCommand extends DbCommand implements ICloneable

O tipo SqlCeCommand expõe os membros a seguir.

Construtores

	Nome	Descrição
	SqlCeCommand()	Inicializa uma nova instância da classe SqlCeCommand.
	SqlCeCommand(String)	Inicializa uma nova instância da classe SqlCeCommand com o texto da consulta.
	SqlCeCommand(String, SqlCeConnection)	Inicializa uma nova instância da classe SqlCeCommand com o texto da consulta e SqlCeConnection.
	SqlCeCommand(String, SqlCeConnection, SqlCeTransaction)	Inicializa uma nova instância da classe SqlCeCommand com o texto da consulta, SqlCeConnection e SqlCeTransaction.

Início

Propriedades

	Nome	Descrição
	CanRaiseEvents	(herança de Component)
	CommandText	Obtém ou define uma instrução SQL a ser executada na fonte de dados. (Substitui DbCommand.CommandText.)
	CommandTimeout	Obtém ou define o tempo de espera antes de encerrar a tentativa de executar um comando ou gerar um erro. (Substitui DbCommand.CommandTimeout.)
	CommandType	Obtém ou define um valor que indica como a propriedade CommandText é interpretada. (Substitui DbCommand.CommandType.)
	Connection	Obtém ou define a SqlCeConnection usada por esta instância do SqlCeCommand.
	Container	(herança de Component)
	DbConnection	(herança de DbCommand)
	DbParameterCollection	(herança de DbCommand)
	DbTransaction	(herança de DbCommand)
	DesignMode	(herança de Component)
	DesignTimeVisible	Get sempre retorna false; set sempre lança uma NotSupportedException. (Substitui DbCommand.DesignTimeVisible.)
	Events	(herança de Component)
	IndexName	Especifica o índice a ser aberto.
	Parameters	Obtém a SqlCeParameterCollection.
	Site	(herança de Component)
	Transaction	Obtém ou define a transação na qual o SqlCeCommand é executado.
	UpdatedRowSource	Obtém ou define como os resultados do comando são aplicados à DataRow quando usados pelo método Update do DbDataAdapter. Esta propriedade não deve ser usada com o Provedor de Dados do .NET Compact Framework para SQL Server Compact. (Substitui DbCommand.UpdatedRowSource.)

Início

Métodos

	Nome	Descrição
	Cancel	Tentativas de cancelar a execução de um SqlCeCommand. (Substitui DbCommand.Cancel().)
	CreateDbParameter	(herança de DbCommand)
	CreateObjRef	(herança de MarshalByRefObject)
	CreateParameter	Cria uma nova instância de um objeto SqlCeParameter.
	Dispose()	(herança de Component)
	Dispose(Boolean)	(herança de Component)
	Equals	(herança de Object)
	ExecuteDbDataReader	(herança de DbCommand)
	ExecuteNonQuery	Executa uma instrução SQL com relação à SqlCeConnection e retorna o número de linhas afetadas. (Substitui DbCommand.ExecuteNonQuery().)
	ExecuteReader()	Envia o CommandText à Connection e cria um SqlCeDataReader.
	ExecuteReader(CommandBehavior)	Envia CommandText a Connection e cria SqlCeDataReader usando um dos valores de CommandBehavior.
	ExecuteResultSet(ResultSetOptions)	Envia CommandText a Connection e cria SqlCeResultSet usando ResultSetOptions.
	ExecuteResultSet(ResultSetOptions, SqlCeResultSet)	Envia CommandText a Connection e cria SqlCeResultSet usando ResultSetOptions.
	ExecuteScalar	Executa a consulta e retorna a primeira coluna da primeira linha do conjunto de resultados retornado pela consulta. As outras colunas ou linhas são ignoradas. (Substitui DbCommand.ExecuteScalar().)
	Finalize	(herança de Component)
	GetHashCode	(herança de Object)
	GetLifetimeService	(herança de MarshalByRefObject)
	GetService	(herança de Component)
	GetType	(herança de Object)
	InitializeLifetimeService	(herança de MarshalByRefObject)
	MemberwiseClone()	(herança de Object)
	MemberwiseClone(Boolean)	(herança de MarshalByRefObject)
	Prepare	Cria uma versão preparada (ou compilada) do comando na fonte de dados. (Substitui DbCommand.Prepare().)
	SetRange	Restringe o conjunto de linhas que será lido pelo SqlCeDataReader.
	ToString	(herança de Component)

Início

Eventos

	Nome	Descrição
	Disposed	(herança de Component)

Início

Implementações de interfaces explícitas

	Nome	Descrição
	ICloneable.Clone
	IDbCommand.Connection	(herança de DbCommand)
	IDbCommand.CreateParameter	(herança de DbCommand)
	IDbCommand.ExecuteReader()	(herança de DbCommand)
	IDbCommand.ExecuteReader(CommandBehavior)	(herança de DbCommand)
	IDbCommand.Parameters	(herança de DbCommand)
	IDbCommand.Transaction	(herança de DbCommand)

Início

Comentários

Ao criar uma instância do SqlCeCommand, as propriedades de leitura/gravação são definidas com seus valores iniciais. Para obter uma lista desses valores, consulte o construtor do SqlCeCommand.

O SqlCeCommand apresenta os seguintes métodos que executam comandos em uma fonte de dados:

Item	Descrição
ExecuteReader	Executa comandos que retornam linhas.
ExecuteNonQuery	Executa comandos SQL, como as instruções INSERT, DELETE e UPDATE.
ExecuteScalar	Recupera um único valor (por exemplo, um valor agregado) de um banco de dados.
ExecuteResultSet	Executa comandos e retorna um conjunto de resultados.

O Provedor de Dados do SQL Server Compact não dá suporte a consultas em lotes. Os comandos devem estar na seguinte forma:

Select * from Customers e não Select * from Customers; Select * from Orders;

Se estiver usando código gerado para o System.Data.SqlClient, talvez seja necessário alterar suas consultas para que estejam de acordo com essa restrição.

O SQL Server Compact dá suporte a várias conexões simultâneas, assim como a vários comandos que compartilham a mesma conexão. Isso significa que é possível ter várias instâncias do SqlCeDataReader na mesma conexão. Esse comportamento é diferente do comportamento do System.Data.SqlClient.

Se uma SqlCeException fatal for gerada pelo método que executa um SqlCeCommand, a SqlCeConnection poderá ser fechada. Você pode reabrir a conexão e continuar.

Exemplos

O exemplo a seguir usa o SqlCeCommand, juntamente com a SqlCeConnection, para selecionar linhas de um banco de dados.

Dim query As String = "SELECT [Order ID], [Customer] FROM Orders"
Dim conn As New SqlCeConnection(connString)
Dim cmd As New SqlCeCommand(query, conn)

conn.Open()
Dim rdr As SqlCeDataReader = cmd.ExecuteReader()

Try
    ' Iterate through the results
    '
    While rdr.Read()
        Dim val1 As Integer = rdr.GetInt32(0)
        Dim val2 As String = rdr.GetString(1)
    End While
Finally
    ' Always call Close when done reading
    '
    rdr.Close()

    ' Always call Close when done reading
    '
    conn.Close()
End Try

string query = "SELECT [Order ID], [Customer] FROM Orders";
SqlCeConnection conn = new SqlCeConnection(connString);
SqlCeCommand cmd = new SqlCeCommand(query, conn);

conn.Open();
SqlCeDataReader rdr = cmd.ExecuteReader();

try
{
    // Iterate through the results
    //
    while (rdr.Read())
    {
        int val1 = rdr.GetInt32(0);
        string val2 = rdr.GetString(1);
    }
}
finally
{
    // Always call Close when done reading
    //
    rdr.Close();

    // Always call Close when done reading
    //
    conn.Close();
}

Segurança de thread

Qualquer membro estático público (Shared no Microsoft Visual Basic) desse tipo é seguro para threads. Não há garantia de que qualquer membro de instância seja seguro para threads.

Consulte também

Referência

Namespace System.Data.SqlServerCe

SqlCeDataAdapter

SqlCeConnection