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.Framework.DataSiteableObject<IVsDataConnection>
    Microsoft.VisualStudio.Data.Framework.DataCommand

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

Sintassi

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

Il tipo DataCommand espone i seguenti membri.

Costruttori

	Nome	Descrizione
	DataCommand()	Inizializza una nuova istanza della classe DataCommand.
	DataCommand(IVsDataConnection)	Inizializza una nuova istanza della classe DataCommand insieme a un oggetto connessione dati.

In alto

Proprietà

	Nome	Descrizione
	Site	Ottiene o imposta il sito dell'oggetto. (Ereditato da DataSiteableObject<T>)

In alto

Metodi

	Nome	Descrizione
	CreateParameter	Crea un oggetto Parameter che può essere convertito in DeriveSchema, DeriveSchema, Execute, o metodi ExecuteWithoutResults su un'istanza DataCommand.
	DeriveParameters(String)	Deriva i parametri che possono essere specificati per un comando specificato.
	DeriveParameters(String, DataCommandType)	Deriva i parametri che possono essere specificati per un comando specificato.
	DeriveParameters(String, DataCommandType, Int32)	Deriva i parametri che possono essere specificati per un comando specificato.
	DeriveSchema(String)	Deriva lo schema restituito dal comando specificato.Lo schema indica il layout degli elementi e dei blocchi di un lettore dati.
	DeriveSchema(String, DataCommandType)	Deriva lo schema restituito dal comando specificato.Lo schema indica il layout degli elementi e dei blocchi di un lettore dati.
	DeriveSchema(String, DataCommandType, array<IVsDataParameter[])	Deriva lo schema restituito dal comando specificato.Lo schema indica il layout degli elementi e dei blocchi di un lettore dati.
	DeriveSchema(String, DataCommandType, array<IVsDataParameter[], Int32)	Deriva lo schema restituito dal comando specificato.Lo schema indica 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(String)	Esegue un comando specificato e restituisce risultati di sola lettura.
	Execute(String, DataCommandType)	Esegue un comando specificato e restituisce risultati di sola lettura.
	Execute(String, DataCommandType, array<IVsDataParameter[])	Esegue un comando specificato, facoltativamente con i parametri e i risultati di sola lettura viene restituito.
	Execute(String, DataCommandType, array<IVsDataParameter[], Int32)	Esegue un comando specificato, facoltativamente con i parametri e i risultati di sola lettura viene restituito.
	ExecuteWithoutResults(String)	Esegue un comando ma non richiede i risultati, anziché restituiscono un intero che indica il risultato della chiamata.
	ExecuteWithoutResults(String, DataCommandType)	Esegue un comando ma non richiede i risultati, anziché restituiscono un intero che indica il risultato della chiamata.
	ExecuteWithoutResults(String, DataCommandType, array<IVsDataParameter[])	Esegue un comando, facoltativamente con parametri, ma non richiede i risultati, anziché restituiscono un intero che indica il risultato della chiamata.
	ExecuteWithoutResults(String, DataCommandType, array<IVsDataParameter[], Int32)	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)
	OnSiteChanged	Genera l'evento SiteChanged. (Ereditato da DataSiteableObject<T>)
	Prepare(String)	Preparerà il comando specificato nell'origine dati essere eseguito; il comando può quindi essere eseguito più volte, con parametri variabili.
	Prepare(String, DataCommandType)	Preparerà il comando specificato nell'origine dati essere eseguito; il comando può quindi essere eseguito più volte, con parametri variabili.
	Prepare(String, DataCommandType, array<IVsDataParameter[])	Preparerà il comando specificato nell'origine dati essere eseguito; il comando può quindi essere eseguito più volte, con parametri variabili.
	Prepare(String, DataCommandType, array<IVsDataParameter[], Int32)	Preparerà il comando specificato nell'origine dati essere eseguito; il comando può quindi essere eseguito più volte, con parametri variabili.
	ToString	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

In alto

Eventi

	Nome	Descrizione
	SiteChanged	Viene generato quando si modifica la proprietà Site. (Ereditato da DataSiteableObject<T>)

In alto

Note

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

La classe DataCommand vengono illustrati i tipi di comandi. Un tipo di comando indica un'interpretazione a livello di codice di una stringa di comando specificata. Ad esempio, un testo del tipo di comando potrebbe inviare il provider di DDEX che la stringa di comando è un'istruzione SQL che deve essere eseguito direttamente. In alternativa, un tipo di comando di TabularFunction potrebbe inviare il 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.

Tecnologie di supporto come ODBC (open database connectivity), OLE DB e si tenta di ADO.NET enumerare un set dei 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 ha origine da un'enumerazione fissa. Ciò offre flessibilità consentendo ai provider di DDEX per aggiungere tipi personalizzati di comando, con descrizioni di come e quando i controlli possono essere utilizzati.

Nota

Per fornire la funzionalità di esecuzione di comandi in modo asincrono, utilizzare la classe DataAsyncCommand.Tale classe dispone di un set di metodi che corrispondono a quelli sulla classe DataCommand, ma questi metodi funzionano in modo asincrono.

Note per gli eredi

Quando si eredita dalla classe DataCommand, è necessario eseguire l'override di ogni metodo da questa classe che deve essere supportata dalla relativa implementazione del provider di DDEX. L'implementazione di base di ciascun metodo di questa classe genera NotSupportedException.

Si noti che il metodo ExecuteWithoutResults è un'implementazione di base che delega al metodo Execute.

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.Framework

DataCommandType