DataCommand-Klasse

Artikel
05/16/2015

Stellt die Möglichkeit, Datenbefehle verschiedener Typen für Datenquellen zu erstellen und auszuführen, und schreibgeschützte Ergebnisse oder einen Befehlsstatuscode abzurufen.

Vererbungshierarchie

Object
Microsoft.VisualStudio.Data.DataCommand

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

Syntax

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

Der DataCommand-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	DataCommand	Klassenkonstruktor.Instanziiert eine neue Instanz der DataCommand-Klasse.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	CreateParameter	Erstellt ein Parameterobjekt, das in das DeriveSchema, in Execute oder in ExecuteWithoutResults Vorgehensweisen auf einer DataCommand-Klasseninstanz übergeben werden kann.
	DeriveParameters	Berechnet die Parameter, die für einen angegebenen Befehl angegeben werden können.
	DeriveSchema	Berechnet das Schema, das aus einem angegebenen Befehl zurückgegeben wird und das Layout von Elementen und - in einem Datenreader an.
	Equals	Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
	Execute	Führt einen angegebenen Befehl, optional mit Parametern und schreibgeschützte Ergebnisse der gibt aus.
	ExecuteWithoutResults	Führt einen Befehl, optional mit Parametern aus, erfordert aber keine Ergebnisse und stattdessen gibt eine ganze Zahl zurück, die das Ergebnis des Aufrufs angibt.
	Finalize	Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
	GetHashCode	Fungiert als die Standardhashfunktion. (Von Object geerbt.)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	MemberwiseClone	Erstellt eine flache Kopie vom aktuellen Object. (Von Object geerbt.)
	Prepare	Bereitet den angegebenen Befehl auf der Datenquelle vor ausgeführt werden; der Befehl wird mehrmals, mit verschiedenen Parametern ausgeführt werden.
	ToString	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)

Zum Seitenanfang

Hinweise

DDEX-Anbieter können verschiedene Typen von Befehlen anhand der Datenquelle ausführen. Dieses auf einfügen, jedoch kann eingeschränkt werden, SQL-Anweisungen, Prozeduren und Funktionsaufrufe. Sie führen möglicherweise auch die Fähigkeit verfügbar, Parameter und Schemas für Befehle vorzubereiten und zu berechnen.

Die Klasse stellt DataCommand das Konzept eines Befehlstyps vor. Ein Befehlstyp gibt eine programmgesteuerte Interpretation einer angegebenen Befehlszeichenfolge an. Beispielsweise teilte möglicherweise ein Befehlstyp "Text" dem DDEX-Anbieter mit, dass die Befehlszeichenfolge eine SQL-Anweisung ist, die direkt ausgeführt werden soll. Umgekehrt teilte möglicherweise ein Befehlstyp "TabularFunction" dem DDEX-Anbieter mit, dass die Befehlszeichenfolge der Name einer Tabellenwertfunktion ist, die mit der entsprechenden Methode ausgeführt werden soll.

Zugrunde liegende Technologien wie ODBC, OLE DB und ADO.NET Versuch, einen Satz von zulässigen Befehlstypen, normalerweise als Nur-Text, der in Tabellenform oder als gespeicherte Prozeduren aufzulisten. Die DataCommand-Klasse erweitert dieses Konzept, indem sie die Anforderung sich gelockert, die ein solches Befehlstyp aus einer festen Enumeration stammen. Dies stellt enorme Flexibilität vom zulassen DDEX-Anbietern hinzuzufügen, um benutzerdefinierte Befehlstypen, einschließlich Beschreibungen dazu bereit, wie und wann die Befehle verwendet werden können.

Hinweis

Um Befehlsausführungsfunktion bereitzustellen, aber asynchron, verwenden Sie die DataAsyncCommand-Klasse, die einen Satz von Methoden verfügt, die auf die auf der DataCommand-Klasse entsprechen, die asynchron werden.

Die Klassen, die von der DataCommand-Klasse abgeleitet werden, sollten diese Methoden implementieren, die von ihrer DDEX-Anbieterimplementierung unterstützt werden. Die Basisimplementierung jeder Methode löst einfach NotSupportedException aus.

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

Microsoft.VisualStudio.Data-Namespace

DataCommandType

Freigeben über