Sdílet prostřednictvím


DbCommandBuilder Třída

Definice

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::Component
public abstract class DbCommandBuilder : System.ComponentModel.Component
type DbCommandBuilder = class
    inherit Component
Public 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 @p#. Používá se při vytváření vlastního tvůrce příkazů.

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)

Platí pro

Viz také