Partilhar via


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
Método público SqlCeCommand() Inicializa uma nova instância da classe SqlCeCommand.
Método público SqlCeCommand(String) Inicializa uma nova instância da classe SqlCeCommand com o texto da consulta.
Método público SqlCeCommand(String, SqlCeConnection) Inicializa uma nova instância da classe SqlCeCommand com o texto da consulta e SqlCeConnection.
Método público 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
Propriedade protegida CanRaiseEvents (herança de Component)
Propriedade pública CommandText Obtém ou define uma instrução SQL a ser executada na fonte de dados. (Substitui DbCommand.CommandText.)
Propriedade pública 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.)
Propriedade pública CommandType Obtém ou define um valor que indica como a propriedade CommandText é interpretada. (Substitui DbCommand.CommandType.)
Propriedade pública Connection Obtém ou define a SqlCeConnection usada por esta instância do SqlCeCommand.
Propriedade pública Container (herança de Component)
Propriedade protegida DbConnection (herança de DbCommand)
Propriedade protegida DbParameterCollection (herança de DbCommand)
Propriedade protegida DbTransaction (herança de DbCommand)
Propriedade protegida DesignMode (herança de Component)
Propriedade pública DesignTimeVisible Get sempre retorna false; set sempre lança uma NotSupportedException. (Substitui DbCommand.DesignTimeVisible.)
Propriedade protegida Events (herança de Component)
Propriedade pública IndexName Especifica o índice a ser aberto.
Propriedade pública Parameters Obtém a SqlCeParameterCollection.
Propriedade pública Site (herança de Component)
Propriedade pública Transaction Obtém ou define a transação na qual o SqlCeCommand é executado.
Propriedade pública 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
Método público Cancel Tentativas de cancelar a execução de um SqlCeCommand. (Substitui DbCommand.Cancel().)
Método protegido CreateDbParameter (herança de DbCommand)
Método público CreateObjRef (herança de MarshalByRefObject)
Método público CreateParameter Cria uma nova instância de um objeto SqlCeParameter.
Método público Dispose() (herança de Component)
Método protegido Dispose(Boolean) (herança de Component)
Método público Equals (herança de Object)
Método protegido ExecuteDbDataReader (herança de DbCommand)
Método público ExecuteNonQuery Executa uma instrução SQL com relação à SqlCeConnection e retorna o número de linhas afetadas. (Substitui DbCommand.ExecuteNonQuery().)
Método público ExecuteReader() Envia o CommandText à Connection e cria um SqlCeDataReader.
Método público ExecuteReader(CommandBehavior) Envia CommandText a Connection e cria SqlCeDataReader usando um dos valores de CommandBehavior.
Método público ExecuteResultSet(ResultSetOptions) Envia CommandText a Connection e cria SqlCeResultSet usando ResultSetOptions.
Método público ExecuteResultSet(ResultSetOptions, SqlCeResultSet) Envia CommandText a Connection e cria SqlCeResultSet usando ResultSetOptions.
Método público 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().)
Método protegido Finalize (herança de Component)
Método público GetHashCode (herança de Object)
Método público GetLifetimeService (herança de MarshalByRefObject)
Método protegido GetService (herança de Component)
Método público GetType (herança de Object)
Método público InitializeLifetimeService (herança de MarshalByRefObject)
Método protegido MemberwiseClone() (herança de Object)
Método protegido MemberwiseClone(Boolean) (herança de MarshalByRefObject)
Método público Prepare Cria uma versão preparada (ou compilada) do comando na fonte de dados. (Substitui DbCommand.Prepare().)
Método público SetRange Restringe o conjunto de linhas que será lido pelo SqlCeDataReader.
Método público ToString (herança de Component)

Início

Eventos

  Nome Descrição
Evento público Disposed (herança de Component)

Início

Implementações de interfaces explícitas

  Nome Descrição
Implementações de interfaces explícitasMétodo privado ICloneable.Clone
Implementações de interfaces explícitasPropriedade privada IDbCommand.Connection (herança de DbCommand)
Implementações de interfaces explícitasMétodo privado IDbCommand.CreateParameter (herança de DbCommand)
Implementações de interfaces explícitasMétodo privado IDbCommand.ExecuteReader() (herança de DbCommand)
Implementações de interfaces explícitasMétodo privado IDbCommand.ExecuteReader(CommandBehavior) (herança de DbCommand)
Implementações de interfaces explícitasPropriedade privada IDbCommand.Parameters (herança de DbCommand)
Implementações de interfaces explícitasPropriedade privada 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