Sdílet prostřednictvím


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

Obor názvů:  Microsoft.VisualStudio.Data
Sestavení:  Microsoft.VisualStudio.Data (v Microsoft.VisualStudio.Data.dll)

Syntaxe

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

Typ DataCommand zveřejňuje následující členy.

Konstruktory

  Název Popis
Chráněná metoda DataCommand Konstruktoru třídy.Konkretizuje novou instanci DataCommand třídy.

Nahoru

Metody

  Název Popis
Veřejná metoda CreateParameter Vytvoří objekt parametr, který může být předán do DeriveSchema, Execute nebo ExecuteWithoutResultsmetod DataCommandinstance třídy.
Veřejná metoda DeriveParameters Odvozuje parametry, které lze zadat pro daný příkaz.
Veřejná metoda DeriveSchema Schéma vrácené zadaný příkaz označující rozložení položek a bloky v Readeru data pochází.
Veřejná metoda Equals Určuje, zda zadaný objekt je rovno aktuální objekt. (Zděděno z Object.)
Veřejná metoda Execute Provede zadaný příkaz, volitelně s parametry a vrátí výsledky jen pro čtení.
Veřejná metoda ExecuteWithoutResults 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í.
Chráněná metoda 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.)
Veřejná metoda GetHashCode Slouží jako funkci hash u určitého typu. (Zděděno z Object.)
Veřejná metoda GetType Získá Type aktuální instance. (Zděděno z Object.)
Chráněná metoda MemberwiseClone Vytvoří kopii aktuálního Object. (Zděděno z Object.)
Veřejná metoda Prepare 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.
Veřejná metoda ToString Vrátí řetězec představující aktuální objekt. (Zděděno z Object.)

Nahoru

Poznámky

DDEX poskytovatelů mohou provádět různé typy příkazů zdroje 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í koncept typ příkazu.Typ příkazu označuje programové výklad řetězec daného příkazu.Například typ příkazu "Text" může rozpoznat DDEX provider, že řetězec příkazu je příkaz SQL, který má být spuštěn přímo.Na druhé straně typ příkazu "TabularFunction" může rozpoznat DDEX provider, že řetězec příkazu je název funkce vyhodnocovaná tabulkou, která má být provedena pomocí odpovídající metodu.

Základní technologie jako ODBC OLE DB, a pokus o výčet sadu typů povolených příkaz 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 tak velkou flexibilitu tím, že poskytovatelé DDEX přidat vlastní příkaz typů, včetně popisu jak a kdy lze použít příkazy.

[!POZNÁMKA]

Poskytovat možnost spuštění příkazu, ale asynchronně, použití DataAsyncCommandtřídy, která má sadu metod, které jsou rovnocenné požadavkům na DataCommand třídy, ale které pracují asynchronně.

Třídy odvozené od DataCommand třídy plnit tyto metody, které jsou podporovány jejich provádění DDEX provider.Základní provedení každé metody jednoduše vyvolá NotSupportedException .

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.

Viz také

Referenční dokumentace

Microsoft.VisualStudio.Data – obor názvů

DataCommandType