Partilhar via

Classe DataCommand

  • Artigo

Fornece a capacidade de criar e executar comandos de dados de vários tipos de fontes de dados, e recuperar resultados somente leitura ou um código de status de comando.

Hierarquia de herança

System.Object
  Microsoft.VisualStudio.Data.Framework.DataSiteableObject<IVsDataConnection>
    Microsoft.VisualStudio.Data.Framework.DataCommand

Namespace:  Microsoft.VisualStudio.Data.Framework
Assembly:  Microsoft.VisualStudio.Data.Framework (em Microsoft.VisualStudio.Data.Framework.dll)

Sintaxe

'Declaração
Public MustInherit Class DataCommand _
    Inherits DataSiteableObject(Of IVsDataConnection) _
    Implements IVsDataCommand

public abstract class DataCommand : DataSiteableObject<IVsDataConnection>, 
    IVsDataCommand

public ref class DataCommand abstract : public DataSiteableObject<IVsDataConnection^>, 
    IVsDataCommand

[<AbstractClass>]
type DataCommand =  
    class
        inherit DataSiteableObject<IVsDataConnection>
        interface IVsDataCommand
    end

public abstract class DataCommand extends DataSiteableObject<IVsDataConnection> implements IVsDataCommand

O tipo DataCommand expõe os membros a seguir.

Construtores

  Nome Descrição
Método protegido DataCommand() Inicializa uma nova instância da classe DataCommand.
Método protegido DataCommand(IVsDataConnection) Inicializa uma nova instância da classe de DataCommand juntamente com um objeto de conexão de dados.

Superior

Propriedades

  Nome Descrição
Propriedade pública Site Obtém ou define o site do objeto. (Herdado de DataSiteableObject<T>.)

Superior

Métodos

  Nome Descrição
Método público CreateParameter Cria um objeto de parâmetro que pode ser passado em DeriveSchema, em DeriveSchema, em Execute, ou os métodos do ExecuteWithoutResults em uma instância de DataCommand .
Método público DeriveParameters(String) Derivado os parâmetros que podem ser especificados para um determinado comando.
Método público DeriveParameters(String, DataCommandType) Derivado os parâmetros que podem ser especificados para um determinado comando.
Método público DeriveParameters(String, DataCommandType, Int32) Derivado os parâmetros que podem ser especificados para um determinado comando.
Método público DeriveSchema(String) Derivado o esquema retornado de um comando especificado.O esquema indica o layout dos itens e os blocos em um leitor de dados.
Método público DeriveSchema(String, DataCommandType) Derivado o esquema retornado de um comando especificado.O esquema indica o layout dos itens e os blocos em um leitor de dados.
Método público DeriveSchema(String, DataCommandType, array<IVsDataParameter[]) Derivado o esquema retornado de um comando especificado.O esquema indica o layout dos itens e os blocos em um leitor de dados.
Método público DeriveSchema(String, DataCommandType, array<IVsDataParameter[], Int32) Derivado o esquema retornado de um comando especificado.O esquema indica o layout dos itens e os blocos em um leitor de dados.
Método público Equals determina se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
Método público Execute(String) Executa um comando especificado e retorna resultados somente leitura.
Método público Execute(String, DataCommandType) Executa um comando especificado e retorna resultados somente leitura.
Método público Execute(String, DataCommandType, array<IVsDataParameter[]) Executa um comando especificado, opcionalmente com parâmetros, e somente leitura resulta de retorna.
Método público Execute(String, DataCommandType, array<IVsDataParameter[], Int32) Executa um comando especificado, opcionalmente com parâmetros, e somente leitura resulta de retorna.
Método público ExecuteWithoutResults(String) Executa um comando mas não requer resultados em vez de isso, retornando um inteiro que indica o resultado de chamada.
Método público ExecuteWithoutResults(String, DataCommandType) Executa um comando mas não requer resultados em vez de isso, retornando um inteiro que indica o resultado de chamada.
Método público ExecuteWithoutResults(String, DataCommandType, array<IVsDataParameter[]) Executa um comando com parâmetros, opcionalmente, mas não requer resultados em vez de isso, retornando um inteiro que indica o resultado de chamada.
Método público ExecuteWithoutResults(String, DataCommandType, array<IVsDataParameter[], Int32) Executa um comando com parâmetros, opcionalmente, mas não requer resultados em vez de isso, retornando um inteiro que indica o resultado de chamada.
Método protegido Finalize Permite que um objeto tentar liberar recursos e realizar outras operações de limpeza antes de ser recuperados pela coleta de lixo. (Herdado de Object.)
Método público GetHashCode Serve como uma função de hash para um tipo específico. (Herdado de Object.)
Método público GetType Obtém Type da instância atual. (Herdado de Object.)
Método protegido MemberwiseClone Cria uma cópia superficial de Objectatual. (Herdado de Object.)
Método protegido OnSiteChanged Gera o evento SiteChanged. (Herdado de DataSiteableObject<T>.)
Método público Prepare(String) Prepara o comando especificado na fonte de dados ser executado; o comando pode então ser executado várias vezes, com parâmetros de variação.
Método público Prepare(String, DataCommandType) Prepara o comando especificado na fonte de dados ser executado; o comando pode então ser executado várias vezes, com parâmetros de variação.
Método público Prepare(String, DataCommandType, array<IVsDataParameter[]) Prepara o comando especificado na fonte de dados ser executado; o comando pode então ser executado várias vezes, com parâmetros de variação.
Método público Prepare(String, DataCommandType, array<IVsDataParameter[], Int32) Prepara o comando especificado na fonte de dados ser executado; o comando pode então ser executado várias vezes, com parâmetros de variação.
Método público ToString Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object.)

Superior

Eventos

  Nome Descrição
Evento público SiteChanged Ocorre quando a propriedade de Site é alterada. (Herdado de DataSiteableObject<T>.)

Superior

Comentários

Provedores de (DDEX) de extensibilidade designer de dados podem executar vários tipos de comandos contra uma fonte de dados.Isso pode incluir, mas não ser limitado a, instruções SQL, procedimentos, e chamadas de função.Também podem expor a capacidade de preparar e derivar parâmetros e esquemas para comandos.

A classe de DataCommand apresenta tipos de comando.Um tipo de comando indica uma interpretação através de uma cadeia de caracteres de comando fornecida.Por exemplo, um texto de comando tipo pode notificar o provedor de DDEX que a cadeia de caracteres de comando é uma instrução SQL que deve ser executada diretamente.Como alternativa, um tipo de comando de TabularFunction pode notificar o provedor de DDEX que a cadeia de caracteres de comando é o nome de uma função de tabela valorizada que deve ser executada usando o método apropriado.

Tecnologias subjacentes como Open Database Connectivity (ODBC), OLE DB, e a tentativa de ADO.NET em enumerar um conjunto de tipos permissão de comando, normalmente como texto sem formatação, no formulário da tabela, ou como procedimentos armazenados.A classe de DataCommand estende esse conceito relaxando o requisito que esse tipo de comando se origina em uma enumeração fixa.Isso fornece flexibilidade ativando provedores de DDEX para adicionar tipos personalizados de comando, juntamente com descrições de como e quando de comandos podem ser usados.

ObservaçãoObservação

Para fornecer de forma assíncrona o recurso de execução do comando, use a classe de DataAsyncCommand .Esta classe tem um conjunto de métodos que são equivalentes aquelas na classe de DataCommand , mas esses métodos operam de forma assíncrona.

Observações para herdeiros

Quando você herda da classe de DataCommand , você deve substituir cada método da classe que deve ser suportada pela implementação de provedor de DDEX.A implementação base de cada método na classe gera NotSupportedException.

Observe que o método de ExecuteWithoutResults tem uma implementação base que representantes para o método de Execute .

Acesso thread-safe

Quaisquer membros estático (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Consulte também

Referência

Namespace Microsoft.VisualStudio.Data.Framework

DataCommandType