DataCommand – třída
Umožňuje vytvořit a spustit příkazy data různých typů vůči zdroje dat a získat výsledky jen pro čtení nebo příkaz stavový kód.
Hierarchie dědičnosti
System.Object
Microsoft.VisualStudio.Data.Framework.DataSiteableObject<IVsDataConnection>
Microsoft.VisualStudio.Data.Framework.DataCommand
Obor názvů: Microsoft.VisualStudio.Data.Framework
Sestavení: Microsoft.VisualStudio.Data.Framework (v Microsoft.VisualStudio.Data.Framework.dll)
Syntaxe
'Deklarace
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
Typ DataCommand zveřejňuje následující členy.
Konstruktory
| Název | Popis | |
|---|---|---|
.gif "Chráněná metoda") |
DataCommand() | Vytvoří novou instanci třídy DataCommand. |
|
DataCommand(IVsDataConnection) | Inicializuje novou instanci DataCommand třídy s datový objekt připojení. |
Nahoru
Vlastnosti
| Název | Popis | |
|---|---|---|
.gif "Veřejná vlastnost") |
Site | Získá nebo nastaví objekt serveru. (Zděděno z DataSiteableObject<T>.) |
Nahoru
Metody
| Název | Popis | |
|---|---|---|
.gif "Veřejná metoda") |
CreateParameter | Vytvoří objekt parametr, který může být předán do DeriveSchema, DeriveSchema, Execute, nebo ExecuteWithoutResults metod DataCommand instance. |
|
DeriveParameters(String) | Odvozuje parametry, které lze zadat pro daný příkaz. |
|
DeriveParameters(String, DataCommandType) | Odvozuje parametry, které lze zadat pro daný příkaz. |
|
DeriveParameters(String, DataCommandType, Int32) | Odvozuje parametry, které lze zadat pro daný příkaz. |
|
DeriveSchema(String) | Schéma vrácené zadaný příkaz pochází.Schéma označuje rozložení položek a bloky v Readeru data. |
|
DeriveSchema(String, DataCommandType) | Schéma vrácené zadaný příkaz pochází.Schéma označuje rozložení položek a bloky v Readeru data. |
|
DeriveSchema(String, DataCommandType, array<IVsDataParameter[]) | Schéma vrácené zadaný příkaz pochází.Schéma označuje rozložení položek a bloky v Readeru data. |
|
DeriveSchema(String, DataCommandType, array<IVsDataParameter[], Int32) | Schéma vrácené zadaný příkaz pochází.Schéma označuje rozložení položek a bloky v Readeru data. |
|
Equals | Určuje, zda zadaný objekt je rovno aktuální objekt. (Zděděno z Object.) |
|
Execute(String) | Provede zadaný příkaz a vrátí výsledky jen pro čtení. |
|
Execute(String, DataCommandType) | Provede zadaný příkaz a vrátí výsledky jen pro čtení. |
|
Execute(String, DataCommandType, array<IVsDataParameter[]) | Provede zadaný příkaz, volitelně s parametry a vrátí výsledky jen pro čtení. |
|
Execute(String, DataCommandType, array<IVsDataParameter[], Int32) | Provede zadaný příkaz, volitelně s parametry a vrátí výsledky jen pro čtení. |
|
ExecuteWithoutResults(String) | Spustí příkaz ale nepožaduje výsledků místo toho vrací celé číslo označující výsledek volání. |
|
ExecuteWithoutResults(String, DataCommandType) | Spustí příkaz ale nepožaduje výsledků místo toho vrací celé číslo označující výsledek volání. |
|
ExecuteWithoutResults(String, DataCommandType, array<IVsDataParameter[]) | Provede příkaz, volitelně s parametry, ale nebude vyžadovat výsledků místo toho vrací celé číslo označující výsledek volání. |
|
ExecuteWithoutResults(String, DataCommandType, array<IVsDataParameter[], Int32) | Provede příkaz, volitelně s parametry, ale nebude vyžadovat výsledků místo toho vrací celé číslo označující výsledek volání. |
|
Finalize | Umožňuje objekt při uvolnění prostředků a provádět jiné operace vyčištění před je zažádáno systémem uvolňování paměti. (Zděděno z Object.) |
|
GetHashCode | Slouží jako funkci hash u určitého typu. (Zděděno z Object.) |
|
GetType | Získá Type aktuální instance. (Zděděno z Object.) |
|
MemberwiseClone | Vytvoří kopii aktuálního Object. (Zděděno z Object.) |
|
OnSiteChanged | Vyvolá událost SiteChanged. (Zděděno z DataSiteableObject<T>.) |
|
Prepare(String) | Připraví zadaný příkaz na zdroji dat mají být provedeny; příkaz může být spuštěn vícekrát s různými parametry. |
|
Prepare(String, DataCommandType) | Připraví zadaný příkaz na zdroji dat mají být provedeny; příkaz může být spuštěn vícekrát s různými parametry. |
|
Prepare(String, DataCommandType, array<IVsDataParameter[]) | Připraví zadaný příkaz na zdroji dat mají být provedeny; příkaz může být spuštěn vícekrát s různými parametry. |
|
Prepare(String, DataCommandType, array<IVsDataParameter[], Int32) | Připraví zadaný příkaz na zdroji dat mají být provedeny; příkaz může být spuštěn vícekrát s různými parametry. |
|
ToString | Vrátí řetězec představující aktuální objekt. (Zděděno z Object.) |
Nahoru
Události
| Název | Popis | |
|---|---|---|
.gif "Veřejná událost") |
SiteChanged | Dochází, když Site je změněna vlastnost. (Zděděno z DataSiteableObject<T>.) |
Nahoru
Poznámky
Zprostředkovatelé dat rozšíření Designer (DDEX) můžete provést různé typy příkazů zdroj dat.Mohou zahrnovat, ale není omezen pouze na příkazy SQL, postupy a volání funkce.Také vystavuje schopnost připravit a odvodit schémata pro příkazy a parametry.
DataCommand Třídy zavádí typy příkazů.Typ příkazu označuje programové výklad řetězec daného příkazu.Například příkaz typu Text může upozornit DDEX provider, že řetězec příkazu je příkaz SQL, který má být spuštěn přímo.Případně typ příkazu TabularFunction může upozornit DDEX provider, že řetězec příkazu je název funkce vyhodnocovaná tabulkou, který má být spuštěn pomocí vhodné metody.
Základní technologie jako připojení ODBC (Open Database), OLE DB, a pokus o výčet sadu příkazů povolených typů obvykle jako prostý text ve formě tabulky nebo jako uložené procedury.DataCommand Třída rozšiřuje tento pojem oslabením požadavek, že příkaz Typ pocházejí z dlouhodobého výčtu.To poskytuje flexibilitu povolením DDEX zprostředkovatele přidat vlastní příkaz typy s popisy jak a kdy lze použít příkazy.
[!POZNÁMKA]
Poskytovat možnost spuštění příkazu asynchronně, použití DataAsyncCommand třídy.Tato třída má sadu metod, které jsou rovnocenné požadavkům na DataCommand třídy, ale tyto metody pracují asynchronně.
Poznámky pro dědice
Když Zdědit DataCommand třídy, musíte změnit každou metodu z této třídy, který je podporován jeho provádění DDEX provider.Vyvolá základní implementace každá metoda v této třídě NotSupportedException.
Všimněte si, že ExecuteWithoutResults metoda má základní implementace, která deleguje na Execute metoda.
Bezpečný přístup z více vláken
Všechny veřejné členy static (Shared v jazyce Visual Basic) tohoto typu jsou bezpečné pro přístup z více vláken. Není zaručeno, že členy instancí jsou bezpečné pro přístup z více vláken.