DbCommandBuilder Třída

Definice

Obor názvů:

System.Data.Common

Sestavení:

System.Data.Common.dll

Zdroj:

DBCommandBuilder.cs

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

Object

MarshalByRefObject

Component

DbCommandBuilder

Odvozené

System.Data.Odbc.OdbcCommandBuilder

System.Data.OleDb.OleDbCommandBuilder

System.Data.SqlClient.SqlCommandBuilder

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)

Viz také

• Generování příkazů s CommandBuilders
• Přehled ADO.NET