Classe DataCommand

Consente di compilare ed eseguire comandi dati di tipi diversi rispetto alle origini dati e recuperare i risultati di sola lettura o un codice di stato del comando.

Gerarchia di ereditarietà

Object
  Microsoft.VisualStudio.Data.DataCommand

Spazio dei nomi:  Microsoft.VisualStudio.Data
Assembly:  Microsoft.VisualStudio.Data (in Microsoft.VisualStudio.Data.dll)

Sintassi

'Dichiarazione
<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

Il tipo DataCommand espone i seguenti membri.

Costruttori

	Nome	Descrizione
	DataCommand	Costruttore di classe.Crea una nuova istanza della classe DataCommand.

In alto

Metodi

	Nome	Descrizione
	CreateParameter	Crea un oggetto Parameter che può essere convertito in DeriveSchema, Execute o metodi ExecuteWithoutResultssu un'istanza della classe DataCommand.
	DeriveParameters	Deriva parametri che possono essere specificati per un comando specificato.
	DeriveSchema	Deriva dallo schema restituito dal comando specificato, per indicare il layout degli elementi e dei blocchi di un lettore dati.
	Equals	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
	Execute	Esegue un comando specificato, facoltativamente con i parametri e i risultati di sola lettura di risultato.
	ExecuteWithoutResults	Esegue un comando, facoltativamente con parametri, ma non richiede i risultati, anziché restituiscono un intero che indica il risultato della chiamata.
	Finalize	Consente a un oggetto di effettuare un tentativo di liberare risorse ed eseguire altre operazioni di pulizia prima che venga recuperato da Garbage Collection. (Ereditato da Object)
	GetHashCode	Funge da funzione hash predefinita. (Ereditato da Object)
	GetType	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
	MemberwiseClone	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
	Prepare	Prepara il comando specificato nell'origine dati essere eseguito; il comando può essere eseguito più volte, con parametri variabili.
	ToString	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

In alto

Note

I provider di DDEX possono eseguire i vari tipi di controlli in base all'origine dati. Ciò non può includere, ma è limitata a, istruzioni SQL, procedure e chiamate di funzione. È possibile esporre la possibilità di far derivare e i parametri e gli schemi per i controlli.

La classe DataCommand viene introdotto il concetto di un tipo di comando. Un tipo di comando indica un'interpretazione a livello di codice di una stringa di comando specificata. Ad esempio, un tipo "testo" di comando potrebbe indicare al provider di DDEX che la stringa di comando è un'istruzione SQL che deve essere eseguita direttamente. Di altra parte, un tipo di comando "di TabularFunction" può segnalare al provider di DDEX che la stringa di comando è il nome di una funzione con valori di tabella che deve essere eseguita mediante il metodo appropriato.

Le tecnologie di supporto come ODBC, OLE DB e il tentativo ADO.NET enumerare un set di tipi consentiti di comando, in genere come testo normale, in forma di tabella, o come stored procedure. La classe DataCommand estende questo concetto rilassandosi la condizione che tale tipo di comando proviene da un'enumerazione fissa. Ciò offre una notevole flessibilità consentendo ai provider di DDEX aggiungere tipi personalizzati di comando, incluse le descrizioni di come e quando i controlli possono essere utilizzati.

Nota

Per fornire la funzionalità di esecuzione dei comandi, ma in modo asincrono, utilizzare la classe DataAsyncCommand, che dispone di un set di metodi equivalenti a quelle della classe DataCommand, ma che funzioni in modo asincrono.

Le classi derivate dalla classe DataCommand devono implementare i metodi supportati dalla loro implementazione del provider di DDEX. l'implementazione di base di ogni metodo genera semplicemente NotSupportedException.

Codice thread safe

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Vedere anche

Riferimenti

Spazio dei nomi Microsoft.VisualStudio.Data

DataCommandType