Classe DataCommand

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

Object
  Microsoft.VisualStudio.Data.DataCommand

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

Sintaxe

'Declaração
<GuidAttribute("E19F79F4-3219-423d-97A4-5A2B8A8F45F3")> _
Public MustInherit Class DataCommand

[GuidAttribute("E19F79F4-3219-423d-97A4-5A2B8A8F45F3")]
public abstract class DataCommand

[GuidAttribute(L"E19F79F4-3219-423d-97A4-5A2B8A8F45F3")]
public ref class DataCommand abstract

[<AbstractClass>]
[<GuidAttribute("E19F79F4-3219-423d-97A4-5A2B8A8F45F3")>]
type DataCommand =  class end

public abstract class DataCommand

O tipo DataCommand expõe os membros a seguir.

Construtores

	Nome	Descrição
	DataCommand	Construtor da classe.Cria uma nova instância da classe de DataCommand .

Superior

Métodos

	Nome	Descrição
	CreateParameter	Cria um objeto de parâmetro que pode ser passado em DeriveSchema, em Execute ou os métodos do ExecuteWithoutResultsem uma instância da classe de DataCommand.
	DeriveParameters	Derivado os parâmetros que podem ser especificados para um determinado comando.
	DeriveSchema	Derivado o esquema retornado de um comando especificado, indicando o layout dos itens e os blocos em um leitor de dados.
	Equals	Determines whether the specified object is equal to the current object. (Herdado de Object.)
	Execute	Executa um comando especificado, opcionalmente com parâmetros, e somente leitura resulta de retorna.
	ExecuteWithoutResults	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.
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Herdado de Object.)
	GetHashCode	Serves as the default hash function. (Herdado de Object.)
	GetType	Gets the Type of the current instance. (Herdado de Object.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Herdado de Object.)
	Prepare	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.
	ToString	Returns a string that represents the current object. (Herdado de Object.)

Superior

Comentários

Provedores de DDEX podem executar vários tipos de comandos na 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 o conceito de um tipo de comando. Um tipo de comando indica uma interpretação através de uma cadeia de caracteres de comando fornecida. Por exemplo, um tipo “texto” de comando pode instruir o provedor de DDEX que a cadeia de caracteres de comando é uma instrução SQL que deve ser executada diretamente. Por outro lado, um comando tipo de “TabularFunction” pode instruir 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.

As tecnologias subjacentes como ODBC, OLE DB, e a tentativa de ADO.NET enumerar um conjunto de tipos permitido 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 enorme permitindo que os provedores de DDEX adicionar tipos personalizados de comando, incluindo descrições de como e quando de comandos podem ser usados.

Dica

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

Classes derivadas de classes de DataCommand devem implementar esses métodos que são suportados pela implementação de provedor de DDEX. A implementação base de cada método gera simplesmente NotSupportedException.

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

DataCommandType