DbCommandBuilder Třída

Definice

Obor názvů:

System.Data.Common

Sestavení:

netstandard.dll, System.Data.Common.dll

Zdroj:

DBCommandBuilder.cs

Automaticky vygeneruje příkazy s jednou tabulkou, které slouží k odsouhlasení změn provedených v DataSet přidružené databázi. Toto je abstraktní třída, která může být zděděna pouze.

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

Poznámky

Třída DbCommandBuilder je poskytována pro pohodlí poskytovatelů zapisovačů vytvářejících vlastní tvůrce příkazů. Díky dědění z této třídy můžou vývojáři implementovat chování specifické pro zprostředkovatele ve vlastním kódu.

Negeneruje DbDataAdapter automaticky příkazy SQL potřebné k odsouhlasení změn provedených u DataSet přidruženého zdroje dat. Můžete však vytvořit DbCommandBuilder objekt, který automaticky vygeneruje příkazy SQL pro aktualizace s jednou tabulkou, pokud nastavíte SelectCommand vlastnost DbDataAdapter. Pak všechny další příkazy SQL, které nenastavíte, jsou generovány DbCommandBuilder.

Zaregistruje DbCommandBuilder se jako naslouchací proces pro RowUpdating události při každém nastavení DataAdapter vlastnosti. K sobě můžete přidružit jenom jeden DbDataAdapter objekt DbCommandBuilder najednou.

Chcete-li vygenerovat příkazy INSERT, UPDATE nebo DELETE, DbCommandBuilder použije SelectCommand vlastnost k automatickému načtení požadované sady metadat. Pokud změníte po SelectCommand načtení metadat (například po první aktualizaci), měli byste volat metodu RefreshSchema pro aktualizaci metadat.

SelectCommand musí také vrátit minimálně jeden primární klíč nebo jedinečný sloupec. Pokud žádná neexistuje, InvalidOperationException vygeneruje se výjimka a příkazy se negenerují.

Také DbCommandBuilder používá Connection, CommandTimeouta Transaction vlastnosti odkazované .SelectCommand Uživatel by měl volat RefreshSchema , pokud jsou některé z těchto vlastností změněny nebo pokud SelectCommand je nahrazeno. InsertCommand UpdateCommandV opačném případě , a DeleteCommand vlastnosti zachovat jejich předchozí hodnoty.

Pokud voláte Dispose, DbCommandBuilder je přidružení od objektu DbDataAdaptera vygenerované příkazy se už nepoužívají.

Konstruktory

Name	Description
DbCommandBuilder()	Inicializuje novou instanci třídy, která dědí z DbCommandBuilder třídy.

Vlastnosti

Name	Description
CanRaiseEvents	Získá hodnotu určující, zda komponenta může vyvolat událost. (Zděděno od Component)
CatalogLocation	Získá nebo nastaví CatalogLocation 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žívat DbCommandBuilder.
Container	Získá ten 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 Component je aktuálně v režimu návrhu. (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ý se má použít pro oddělovač mezi identifikátorem schématu a jinými identifikátory.
SetAllValues	Určuje, zda jsou zahrnuty všechny hodnoty sloupců v příkazu update nebo pouze změněny.
Site	Získá nebo nastaví ISite .Component (Zděděno od Component)

Metody

Name	Description
ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)	Umožňuje implementaci DbCommandBuilder zprostředkovatele třídy zpracovat další vlastnosti parametru.
Dispose()	Uvolní všechny prostředky používané nástrojem Component. (Zděděno od Component)
Dispose(Boolean)	Uvolní nespravované prostředky používané DbCommandBuilder a volitelně uvolní spravované prostředky.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetDeleteCommand()	Získá automaticky vygenerovaný objekt vyžadovaný DbCommand k odstranění ve zdroji dat.
GetDeleteCommand(Boolean)	Získá automaticky vygenerovaný DbCommand objekt potřebný k odstranění ve zdroji dat, volitelně pomocí sloupců pro názvy parametrů.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetInsertCommand()	Získá automaticky vygenerovaný DbCommand objekt potřebný k provedení vložení ve zdroji dat.
GetInsertCommand(Boolean)	Získá automaticky vygenerovaný DbCommand objekt potřebný k provedení vložení do zdroje dat, volitelně pomocí sloupců pro názvy parametrů.
GetLifetimeService()	Zastaralé. Načte objekt služby aktuální životnosti, 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 pro objekt DbCommandBuilder.
GetService(Type)	Vrátí objekt, který představuje službu poskytovanou objektem Component nebo jeho Container. (Zděděno od Component)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
GetUpdateCommand()	Získá automaticky vygenerovaný DbCommand objekt potřebný k provádění aktualizací ve zdroji dat.
GetUpdateCommand(Boolean)	Získá automaticky vygenerovaný DbCommand objekt potřebný k provádění aktualizací ve zdroji dat, volitelně pomocí sloupců pro názvy parametrů.
InitializeCommand(DbCommand)	Obnoví hodnotu CommandTimeout, Transaction, CommandTypea UpdateRowSource vlastnosti v objektu DbCommand.
InitializeLifetimeService()	Zastaralé. Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
QuoteIdentifier(String)	Vzhledem k necitovanému identifikátoru ve správném případě katalogu vrátí správnou uvozovku tohoto identifikátoru, včetně správného uvozovek v identifikátoru.
RefreshSchema()	Vymaže příkazy přidružené k tomuto DbCommandBuilderpříkazu .
RowUpdatingHandler(RowUpdatingEventArgs)	Přidá obslužnou rutinu RowUpdating události pro událost.
SetRowUpdatingHandler(DbDataAdapter)	Zaregistruje událost DbCommandBuilderRowUpdating pro DbDataAdapterzpracování události .
ToString()	String Vrátí hodnotu obsahující název Component, pokud existuje. Tato metoda by neměla být přepsána. (Zděděno od Component)
UnquoteIdentifier(String)	Vzhledem k identifikátoru v uvozovkách vrátí správnou necitovanou formu tohoto identifikátoru, včetně správného zrušení zapouzdření všech vložených uvozovek v identifikátoru.

Událost

Name	Description
Disposed	Nastane, když komponenta je uvolněna voláním Dispose() metody. (Zděděno od Component)

Viz také

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