DataCommand-Klasse
Bietet die Möglichkeit, von Datenbefehlen verschiedener Typen für Datenquellen zu erstellen und auszuführen, und schreibgeschützte Ergebnisse oder einen Befehlsstatuscode abzurufen.
Vererbungshierarchie
Object
Microsoft.VisualStudio.Data.Framework.DataSiteableObject<IVsDataConnection>
Microsoft.VisualStudio.Data.Framework.DataCommand
Namespace: Microsoft.VisualStudio.Data.Framework
Assembly: Microsoft.VisualStudio.Data.Framework (in Microsoft.VisualStudio.Data.Framework.dll)
Syntax
'Declaration
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
Der DataCommand-Typ macht die folgenden Member verfügbar.
Konstruktoren
| Name | Beschreibung | |
|---|---|---|
.gif "Geschützte Methode") |
DataCommand() | Initialisiert eine neue Instanz der DataCommand-Klasse. |
|
DataCommand(IVsDataConnection) | Initialisiert eine neue Instanz der DataCommand-Klasse und eines Datenverbindungsobjekt. |
Zum Seitenanfang
Eigenschaften
| Name | Beschreibung | |
|---|---|---|
.gif "Öffentliche Eigenschaft") |
Site | Ruft ab oder legt diese Objektsite fest. (Von DataSiteableObject<T> geerbt.) |
Zum Seitenanfang
Methoden
| Name | Beschreibung | |
|---|---|---|
.gif "Öffentliche Methode") |
CreateParameter | Erstellt ein Parameterobjekt, das in das DeriveSchema, DeriveSchema, Execute oder ExecuteWithoutResults auf DataCommand-Methoden einer Instanz übergeben werden kann. |
|
DeriveParameters(String) | Berechnet die Parameter, die für einen bestimmten Befehl angegeben werden können. |
|
DeriveParameters(String, DataCommandType) | Berechnet die Parameter, die für einen bestimmten Befehl angegeben werden können. |
|
DeriveParameters(String, DataCommandType, Int32) | Berechnet die Parameter, die für einen bestimmten Befehl angegeben werden können. |
|
DeriveSchema(String) | Berechnet das Schema, das von einem angegebenen Befehl zurückgegeben wird.Das Schema wird das Layout von Elementen und von Ausschnitten in einem Datenreader an. |
|
DeriveSchema(String, DataCommandType) | Berechnet das Schema, das von einem angegebenen Befehl zurückgegeben wird.Das Schema wird das Layout von Elementen und von Ausschnitten in einem Datenreader an. |
|
DeriveSchema(String, DataCommandType, array<IVsDataParameter[]) | Berechnet das Schema, das von einem angegebenen Befehl zurückgegeben wird.Das Schema wird das Layout von Elementen und von Ausschnitten in einem Datenreader an. |
|
DeriveSchema(String, DataCommandType, array<IVsDataParameter[], Int32) | Berechnet das Schema, das von einem angegebenen Befehl zurückgegeben wird.Das Schema wird das Layout von Elementen und von Ausschnitten in einem Datenreader an. |
|
Equals | Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.) |
|
Execute(String) | Führt einen angegebenen Befehl aus und gibt schreibgeschützten Ergebnisse zurück. |
|
Execute(String, DataCommandType) | Führt einen angegebenen Befehl aus und gibt schreibgeschützten Ergebnisse zurück. |
|
Execute(String, DataCommandType, array<IVsDataParameter[]) | Führt einen bestimmten Befehl, optional mit Parametern und Ergebnisse der schreibgeschützte gibt aus. |
|
Execute(String, DataCommandType, array<IVsDataParameter[], Int32) | Führt einen bestimmten Befehl, optional mit Parametern und Ergebnisse der schreibgeschützte gibt aus. |
|
ExecuteWithoutResults(String) | Führt aus, aber einen Befehl erfordert keine Ergebnisse und stattdessen gibt eine ganze Zahl zurück, die das Ergebnis des Aufrufs angibt. |
|
ExecuteWithoutResults(String, DataCommandType) | Führt aus, aber einen Befehl erfordert keine Ergebnisse und stattdessen gibt eine ganze Zahl zurück, die das Ergebnis des Aufrufs angibt. |
|
ExecuteWithoutResults(String, DataCommandType, array<IVsDataParameter[]) | Führt einen Befehl, optional mit Parametern aus, doch erfordert keine Ergebnisse und stattdessen gibt eine ganze Zahl zurück, die das Ergebnis des Aufrufs angibt. |
|
ExecuteWithoutResults(String, DataCommandType, array<IVsDataParameter[], Int32) | Führt einen Befehl, optional mit Parametern aus, doch erfordert 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.) |
|
OnSiteChanged | Löst das SiteChanged-Ereignis aus. (Von DataSiteableObject<T> geerbt.) |
|
Prepare(String) | Bereitet den angegebenen Befehl auf der Datenquelle vor ausgeführt werden; der Befehl kann, mit unterschiedlichen Parametern dann mehrmals ausgeführt werden. |
|
Prepare(String, DataCommandType) | Bereitet den angegebenen Befehl auf der Datenquelle vor ausgeführt werden; der Befehl kann, mit unterschiedlichen Parametern dann mehrmals ausgeführt werden. |
|
Prepare(String, DataCommandType, array<IVsDataParameter[]) | Bereitet den angegebenen Befehl auf der Datenquelle vor ausgeführt werden; der Befehl kann, mit unterschiedlichen Parametern dann mehrmals ausgeführt werden. |
|
Prepare(String, DataCommandType, array<IVsDataParameter[], Int32) | Bereitet den angegebenen Befehl auf der Datenquelle vor ausgeführt werden; der Befehl kann, mit unterschiedlichen Parametern dann mehrmals ausgeführt werden. |
|
ToString | Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.) |
Zum Seitenanfang
Ereignisse
| Name | Beschreibung | |
|---|---|---|
.gif "Öffentliches Ereignis") |
SiteChanged | Tritt ein, wenn die Site-Eigenschaft geändert wird. (Von DataSiteableObject<T> geerbt.) |
Zum Seitenanfang
Hinweise
Daten-Designer-Erweiterbarkeits (ddex)- Anbieter können verschiedene Arten von Befehlen anhand einer Datenquelle ausführen. Dies zu einschließen, aber wird eingeschränkt werden, SQL-Anweisungen, Prozeduren und Funktionsaufrufe. Sie stellen möglicherweise auch die Möglichkeit, Parameter und Schemas für Befehle vorzubereiten und zu berechnen.
Die DataCommand-Klasse stellt Befehlstypen vor. Ein Befehlstyp gibt einer programmgesteuerten Interpretation einer angegebenen Befehlszeichenfolge an. Beispielsweise meldet möglicherweise ein DDEX-Anbieter den Befehlstyp Text, dass die eine Befehlszeichenfolge SQL-Anweisung ist, die direkt ausgeführt werden soll. Alternativ dem ein TabularFunctions-Befehlstyp möglicherweise den DDEX-Anbieter, dass die Befehlszeichenfolge der Name eine Tabellenwertfunktion ist, ausgeführt werden soll, indem Sie die entsprechende Methode beschrieben.
Zugrunde liegende Technologien wie ODBC (Open Database Connectivity), OLE DB und ADO.NET versucht, einen Satz von zulässigen Befehlstypen, normalerweise als Nur-Text, der in Tabellenform oder gespeicherte Prozeduren aufzulisten. Die DataCommand-Klasse erweitert dieses Konzept, indem Sie die Forderung nicht gelockert, die ein solches Befehlstyp aus einer festen Enumeration stammen. Dies bietet Flexibilität im Aktivieren von DDEX-Anbietern, um benutzerdefinierten Befehlstypen hinzuzufügen, sowie Beschreibungen dazu bereit, wie und wann die Befehle verwendet werden können.
Hinweis
Um Befehlsausführungsfunktion asynchron bereitzustellen, verwenden Sie die Klasse DataAsyncCommand.Diese Klasse verfügt über einen Satz von Methoden, die auf die DataCommand der Klasse entsprechen, aber diese Methoden funktionieren asynchron.
Hinweise zur Vererbung
Wenn Sie von der DataCommand-Klasse erben, müssen Sie alle Methoden aus dieser Klasse überschreiben, die von ihrer DDEX-Anbieterimplementierung unterstützt werden soll. Die Basisimplementierung jede Methode in dieser Klasse löst NotSupportedException aus.
Beachten Sie, dass die ExecuteWithoutResults-Methode eine Basisimplementierung verfügt, die dem Execute die Methode delegiert.
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.