DbCommandBuilder Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Automaticky vygeneruje příkazy s jednou tabulkou, které slouží k odsouhlasení změn provedených DataSet v přidružené databázi. Toto je abstraktní třída, která může být pouze zděděna.
public ref class DbCommandBuilder abstract : System::ComponentModel::Componentpublic abstract class DbCommandBuilder : System.ComponentModel.Componenttype DbCommandBuilder = class
inherit ComponentPublic MustInherit Class DbCommandBuilder
Inherits Component- Dědičnost
- Odvozené
Poznámky
Třída DbCommandBuilder je poskytována pro usnadnění zapisovačů zprostředkovatelů, kteří vytvářejí vlastní tvůrce příkazů. Díky dědění z této třídy mohou vývojáři implementovat chování specifické pro zprostředkovatele ve svém vlastním kódu.
Negeneruje DbDataAdapter automaticky příkazy SQL potřebné k odsouhlasení změn provedených DataSet v souboru s přidruženým zdrojem dat. Pokud však nastavíte SelectCommand vlastnost DbDataAdapter, můžete vytvořit DbCommandBuilder objekt, který automaticky vygeneruje příkazy SQL pro aktualizace s jednou tabulkou. Všechny další příkazy SQL, které nenastavíte, pak vygeneruje .DbCommandBuilder
Objekt se DbCommandBuilder zaregistruje jako naslouchací proces pro RowUpdating události, kdykoli nastavíte DataAdapter vlastnost . Najednou můžete k sobě přidružit jenom jeden DbDataAdapter objekt nebo DbCommandBuilder objekt.
Chcete-li generovat příkazy INSERT, UPDATE nebo DELETE, DbCommandBuilder používá SelectCommand vlastnost k automatickému načtení požadované sady metadat. Pokud změníte SelectCommand hodnotu po načtení metadat (například po první aktualizaci), měli byste zavolat metodu RefreshSchema pro aktualizaci metadat.
Musí SelectCommand také vrátit alespoň jeden primární klíč nebo jedinečný sloupec. Pokud žádná neexistuje, InvalidOperationException vygeneruje se výjimka a příkazy se nevygenerují.
Používá DbCommandBuilder také Connectionvlastnosti , CommandTimeouta , na Transaction které SelectCommandodkazuje . Uživatel by měl volat RefreshSchema , pokud je některá z těchto vlastností změněna nebo pokud SelectCommand je nahrazena sama o sobě. V opačném případě si InsertCommandvlastnosti , UpdateCommanda DeleteCommand zachovají své předchozí hodnoty.
Pokud zavoláte Dispose, dojde k DbCommandBuilder odpojení od a vygenerované příkazy se už nebudou DbDataAdapterpoužívat.
Konstruktory
| DbCommandBuilder() |
Inicializuje novou instanci třídy, která dědí z DbCommandBuilder třídy . |
Vlastnosti
| CanRaiseEvents |
Získá hodnotu označující, zda komponenta může vyvolat událost. (Zděděno od Component) |
| CatalogLocation |
Získá nebo nastaví CatalogLocation pro instanci DbCommandBuilder třídy . |
| CatalogSeparator |
Získá nebo nastaví řetězec použitý jako oddělovač katalogu pro instanci DbCommandBuilder třídy. |
| ConflictOption |
Určuje, který ConflictOption parametr má použít DbCommandBuilder. |
| Container |
Získá objekt IContainer , který obsahuje Component. (Zděděno od Component) |
| DataAdapter |
Získá nebo nastaví DbDataAdapter objekt, pro který transact-SQL příkazy jsou automaticky generovány. |
| DesignMode |
Získá hodnotu, která označuje, zda je aktuálně v režimu návrhu Component . (Zděděno od Component) |
| Events |
Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component. (Zděděno od Component) |
| QuotePrefix |
Získá nebo nastaví počáteční znak nebo znaky, které se mají použít při zadávání databázových objektů (například tabulek nebo sloupců), jejichž názvy obsahují znaky, jako jsou mezery nebo rezervované tokeny. |
| QuoteSuffix |
Získá nebo nastaví koncový znak nebo znaky, které se mají použít při zadávání databázových objektů (například tabulek nebo sloupců), jejichž názvy obsahují znaky, jako jsou mezery nebo rezervované tokeny. |
| SchemaSeparator |
Získá nebo nastaví znak, který má být použit pro oddělovač mezi identifikátor schématu a jakékoli jiné identifikátory. |
| SetAllValues |
Určuje, jestli jsou zahrnuté všechny hodnoty sloupců v příkazu update, nebo jenom hodnoty změněné. |
| Site |
Získá nebo nastaví ISite z Component. (Zděděno od Component) |
Metody
| ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean) |
Umožňuje implementaci DbCommandBuilder zprostředkovatele třídy zpracovat další vlastnosti parametru. |
| CreateObjRef(Type) |
Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy sloužící ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject) |
| Dispose() |
Uvolní všechny prostředky používané nástrojem Component. (Zděděno od Component) |
| Dispose(Boolean) |
Uvolní nespravované prostředky používané nástrojem DbCommandBuilder a volitelně uvolní spravované prostředky. |
| Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
| GetDeleteCommand() |
Získá automaticky generovaný DbCommand objekt potřebný k provedení odstranění ve zdroji dat. |
| GetDeleteCommand(Boolean) |
Získá automaticky generovaný DbCommand objekt vyžadovaný k provedení odstranění ve zdroji dat, volitelně pomocí sloupců pro názvy parametrů. |
| GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
| GetInsertCommand() |
Získá automaticky generovaný DbCommand objekt potřebný k provedení vložení do zdroje dat. |
| GetInsertCommand(Boolean) |
Získá automaticky generovaný DbCommand objekt potřebný k provedení vložení do zdroje dat, volitelně pomocí sloupců pro názvy parametrů. |
| GetLifetimeService() |
Zastaralé.
Načte aktuální životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject) |
| GetParameterName(Int32) |
Vrátí název zadaného parametru ve formátu |
| GetParameterName(String) |
Vrátí úplný název parametru vzhledem k částečnému názvu parametru. |
| GetParameterPlaceholder(Int32) |
Vrátí zástupný symbol pro parametr v přidruženém příkazu SQL. |
| GetSchemaTable(DbCommand) |
Vrátí tabulku schématu DbCommandBuilderpro . |
| GetService(Type) |
Vrátí objekt, který představuje službu poskytovanou objektem Component nebo .Container (Zděděno od Component) |
| GetType() |
Type Získá z aktuální instance. (Zděděno od Object) |
| GetUpdateCommand() |
Získá automaticky generovaný DbCommand objekt potřebný k provedení aktualizací ve zdroji dat. |
| GetUpdateCommand(Boolean) |
Získá automaticky generovaný objekt vyžadovaný DbCommand k provedení aktualizací ve zdroji dat, volitelně pomocí sloupců pro názvy parametrů. |
| InitializeCommand(DbCommand) |
CommandTimeoutObnoví vlastnosti , Transaction, CommandTypea UpdateRowSource na objektu DbCommand. |
| InitializeLifetimeService() |
Zastaralé.
Získá životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
| MemberwiseClone(Boolean) |
Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject) |
| QuoteIdentifier(String) |
Pokud je identifikátor bez uvozovek ve správném případě katalogu, vrátí správný tvar tohoto identifikátoru v uvozovkách, včetně správného uvozovek v identifikátoru. |
| RefreshSchema() |
Vymaže příkazy přidružené k tomuto DbCommandBuilder. |
| RowUpdatingHandler(RowUpdatingEventArgs) |
Přidá obslužnou rutinu RowUpdating události pro událost. |
| SetRowUpdatingHandler(DbDataAdapter) |
Zaregistruje DbCommandBuilder pro zpracování RowUpdating události pro DbDataAdapter. |
| ToString() |
String Vrátí hodnotu obsahující název , Componentpokud existuje. Tato metoda by neměla být přepsána. (Zděděno od Component) |
| UnquoteIdentifier(String) |
Při použití identifikátoru v uvozovkách vrátí správnou formu tohoto identifikátoru bez uvozovek, včetně správného zrušení uvozovek v identifikátoru. |
Událost
| Disposed |
Vyvolá se, když je komponenta uvolněna voláním Dispose() metody . (Zděděno od Component) |
