DbCommandBuilder Osztály

Definíció

Névtér:

System.Data.Common

Szerelvények:

netstandard.dll, System.Data.Common.dll

Forrás:

DBCommandBuilder.cs

Automatikusan létrehoz egytáblás parancsokat a társított adatbázissal végzett módosítások egyeztetéséhez DataSet . Ez egy olyan absztrakt osztály, amely csak örökölhető.

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

Öröklődés

Object

MarshalByRefObject

Component

DbCommandBuilder

Származtatott

System.Data.Odbc.OdbcCommandBuilder

System.Data.OleDb.OleDbCommandBuilder

Megjegyzések

Az DbCommandBuilder osztály a szolgáltatói írók kényelmét szolgálja, és saját parancsszerkesztőket hoz létre. Az osztály öröklésével a fejlesztők saját kódjukban implementálhatják a szolgáltatóspecifikus viselkedést.

A DbDataAdapter rendszer nem hozza létre automatikusan azokat az SQL-utasításokat, amelyek a társított adatforrás módosításainak DataSet egyeztetéséhez szükségesek. Létrehozhat azonban egy objektumotDbCommandBuilder, amely automatikusan létrehoz SQL-utasításokat az egytáblás frissítésekhez, ha beállítja a SelectCommand tulajdonságot.DbDataAdapter Ezután a nem beállított további SQL-utasításokat a rendszer létrehozza.DbCommandBuilder

A DbCommandBuilder tulajdonság beállításakor a rendszer figyelőként regisztrálja magát az RowUpdating eseményekhezDataAdapter. Egyszerre csak egyet DbDataAdapter vagy DbCommandBuilder objektumot társíthat egymáshoz.

AZ INSERT, UPDATE vagy DELETE utasítások létrehozásához a DbCommandBuilderSelectCommand tulajdonság használatával automatikusan lekéri a szükséges metaadatokat. Ha módosítja a SelectCommand metaadatok lekérése után (például az első frissítés után), hívja meg a RefreshSchema metódust a metaadatok frissítéséhez.

A SelectCommand kulcsnak legalább egy elsődleges kulcsot vagy egyedi oszlopot is vissza kell adnia. Ha nincs ilyen, a rendszer kivételt InvalidOperationException hoz létre, és a parancsok nem jönnek létre.

Az DbCommandBuilder is használja a Connection, CommandTimeoutés Transaction a tulajdonságok által SelectCommandhivatkozott. A felhasználónak fel kell hívnia RefreshSchema , ha ezen tulajdonságok bármelyike módosul, vagy ha a SelectCommand rendszer lecseréli magát. Ellenkező esetben a InsertCommand, UpdateCommandés DeleteCommand a tulajdonságok megőrzik a korábbi értékeket.

Ha meghívja Dispose, a rendszer nem társítja a DbCommandBuilder parancsot, DbDataAdapterés a generált parancsok már nem lesznek használatban.

Konstruktorok

Name	Description
DbCommandBuilder()	Inicializálja az osztályból öröklő osztály új példányát DbCommandBuilder .

Tulajdonságok

Name	Description
CanRaiseEvents	Beolvas egy értéket, amely jelzi, hogy az összetevő képes-e eseményt létrehozni. (Öröklődés forrása Component)
CatalogLocation	Lekéri vagy beállítja az CatalogLocation osztály egy példányát DbCommandBuilder .
CatalogSeparator	Lekéri vagy beállítja az osztály egy példányának katalóguselválasztójaként használt sztringet DbCommandBuilder .
ConflictOption	Megadja, hogy melyiket ConflictOption használja a DbCommandBuilderrendszer.
Container	Lekéri a IContainer .Component (Öröklődés forrása Component)
DataAdapter	Lekéri vagy beállít egy DbDataAdapter objektumot, amelyhez a Transact-SQL utasítások automatikusan létrejönnek.
DesignMode	Olyan értéket kap, amely jelzi, hogy az Component aktuálisan tervezési módban van-e. (Öröklődés forrása Component)
Events	Lekéri az ehhez Componentcsatolt eseménykezelők listáját. (Öröklődés forrása Component)
QuotePrefix	Lekéri vagy beállítja a kezdő karaktert vagy karaktereket, amikor olyan adatbázis-objektumokat (például táblákat vagy oszlopokat) ad meg, amelyek neve olyan karaktereket tartalmaz, mint a szóközök vagy a fenntartott jogkivonatok.
QuoteSuffix	Lekéri vagy beállítja azokat a záró karaktereket vagy karaktereket, amelyek olyan adatbázis-objektumokat (például táblákat vagy oszlopokat) ad meg, amelyek neve olyan karaktereket tartalmaz, mint a szóközök vagy a fenntartott jogkivonatok.
SchemaSeparator	Lekéri vagy beállítja az elválasztó karaktert a sémaazonosító és bármely más azonosító között.
SetAllValues	Megadja, hogy a frissítési utasításban szereplő összes oszlopérték szerepel-e benne, vagy csak módosítva.
Site	Lekéri vagy megadja a ISite értékét a Component-hez. (Öröklődés forrása Component)

Metódusok

Name	Description
ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)	Lehetővé teszi az osztály szolgáltatói implementációjának DbCommandBuilder további paramétertulajdonságok kezelését.
Dispose()	Felszabadítja a .-hez használt összes erőforrást Component. (Öröklődés forrása Component)
Dispose(Boolean)	Felszabadítja a felügyelt erőforrások által DbCommandBuilder használt nem felügyelt erőforrásokat, és opcionálisan felszabadítja a felügyelt erőforrásokat.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetDeleteCommand()	Lekéri az adatforrás törléséhez szükséges automatikusan létrehozott DbCommand objektumot.
GetDeleteCommand(Boolean)	Lekéri az adatforrás törléséhez szükséges automatikusan létrehozott DbCommand objektumot, opcionálisan a paraméternevek oszlopait használva.
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetInsertCommand()	Lekéri az adatforrásba történő beszúráshoz szükséges automatikusan létrehozott DbCommand objektumot.
GetInsertCommand(Boolean)	Lekéri az adatforrásba történő beszúráshoz szükséges automatikusan létrehozott DbCommand objektumot, opcionálisan a paraméternevek oszlopait használva.
GetLifetimeService()	Elavult. Lekéri a példány élettartamszabályzatát vezérlő aktuális élettartam-szolgáltatásobjektumot. (Öröklődés forrása MarshalByRefObject)
GetParameterName(Int32)	A megadott paraméter nevét adja vissza a következő formátumban @p#: . Egyéni parancsszerkesztő létrehozásakor használható.
GetParameterName(String)	A teljes paraméternevet adja vissza a részleges paraméternév alapján.
GetParameterPlaceholder(Int32)	A paraméter helyőrzőjének értékét adja vissza a társított SQL-utasításban.
GetSchemaTable(DbCommand)	A sématábláját adja vissza.DbCommandBuilder
GetService(Type)	Olyan objektumot ad vissza, amely az általa vagy annak által ComponentContainernyújtott szolgáltatást jelöli. (Öröklődés forrása Component)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
GetUpdateCommand()	Lekéri az adatforrásban a frissítések végrehajtásához szükséges automatikusan létrehozott DbCommand objektumot.
GetUpdateCommand(Boolean)	Lekéri az adatforrásban a frissítések végrehajtásához szükséges automatikusan létrehozott DbCommand objektumot, opcionálisan a paraméternevek oszlopait használva.
InitializeCommand(DbCommand)	Alaphelyzetbe állítja a CommandTimeout, Transaction, CommandTypeés UpdateRowSource tulajdonságokat a DbCommand.
InitializeLifetimeService()	Elavult. Beolvas egy élettartam-szolgáltatásobjektumot a példány élettartam-szabályzatának szabályozásához. (Öröklődés forrása MarshalByRefObject)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
MemberwiseClone(Boolean)	Az aktuális MarshalByRefObject objektum sekély másolatát hozza létre. (Öröklődés forrása MarshalByRefObject)
QuoteIdentifier(String)	Ha a katalógus helyes esetében egy nem kvótált azonosítót ad vissza, az azonosító helyes idézőjeles formáját adja vissza, beleértve az azonosítóban lévő beágyazott idézőjelek megfelelő kizárását is.
RefreshSchema()	Törli az ezzel DbCommandBuildera paranccsal társított parancsokat.
RowUpdatingHandler(RowUpdatingEventArgs)	Hozzáad egy eseménykezelőt az RowUpdating eseményhez.
SetRowUpdatingHandler(DbDataAdapter)	Regisztrálja az DbCommandBuilder esemény kezeléséhez RowUpdating egy DbDataAdapter.
ToString()	String A ( ha van) nevet tartalmazó értéket Componentad vissza. Ezt a módszert nem szabad felülírni. (Öröklődés forrása Component)
UnquoteIdentifier(String)	Idézett azonosító esetén az azonosító helyes, nem kvótált formáját adja vissza, beleértve az azonosítóban lévő beágyazott idézőjelek megfelelő feloldását is.

esemény

Name	Description
Disposed	Akkor fordul elő, ha az összetevőt a metódus hívása megsemmisíti Dispose() . (Öröklődés forrása Component)

Lásd még

• Parancsok létrehozása CommandBuilders használatával
• ADO.NET áttekintése