OleDbCommandBuilder Třída

Definice

Automaticky vygeneruje příkazy s jednou tabulkou, které se používají k odsouhlasení změn provedených v databázi s přidruženou DataSet databází. Tuto třídu nelze dědit.

public ref class OleDbCommandBuilder sealed : System::Data::Common::DbCommandBuilder
public ref class OleDbCommandBuilder sealed : System::ComponentModel::Component
public sealed class OleDbCommandBuilder : System.Data.Common.DbCommandBuilder
public sealed class OleDbCommandBuilder : System.ComponentModel.Component
type OleDbCommandBuilder = class
    inherit DbCommandBuilder
type OleDbCommandBuilder = class
    inherit Component
Public NotInheritable Class OleDbCommandBuilder
Inherits DbCommandBuilder
Public NotInheritable Class OleDbCommandBuilder
Inherits Component
Dědičnost
Dědičnost
OleDbCommandBuilder

Příklady

Následující příklad používá OleDbCommand, spolu OleDbDataAdapter a OleDbConnection, k výběru řádků ze zdroje dat. Příklad je předán inicializovaný DataSet, připojovací řetězec, řetězec dotazu, který je příkazem SQL SELECT, a řetězec, který je názvem tabulky zdroje dat. Příklad pak vytvoří .OleDbCommandBuilder

public static DataSet UpdateRows(string connectionString,
    string queryString, string tableName)
{
    DataSet dataSet = new DataSet();
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter = new OleDbDataAdapter();
        adapter.SelectCommand = new OleDbCommand(queryString, connection);
        OleDbCommandBuilder cb = new OleDbCommandBuilder(adapter);

        connection.Open();

        adapter.Fill(dataSet, tableName);

        //code to modify data in DataSet here

        cb.GetDeleteCommand();
        //Without the OleDbCommandBuilder this line would fail
        adapter.Update(dataSet, tableName);

        connection.Close();
    }
    return dataSet;
}
Public Shared Function UpdateRows(ByVal connectionString As String, _
ByVal queryString As String, ByVal tableName As String) As DataSet

    Dim dataSet As New DataSet()

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New OleDbDataAdapter()
        adapter.SelectCommand = New OleDbCommand(queryString, connection)
        Dim builder As New OleDbCommandBuilder(adapter)

        connection.Open()

        adapter.Fill(dataSet, tableName)

        ' Code to modify data in DataSet here 

        builder.GetUpdateCommand()

        ' Without the OleDbCommandBuilder this line would fail.
        adapter.Update(dataSet, tableName)
    End Using

    Return dataSet
End Function

Poznámky

Nástroj OleDbDataAdapter negeneruje automaticky příkazy SQL potřebné k odsouhlasení změn provedených v DataSet souboru s přidruženým zdrojem dat. Pokud ale nastavíte SelectCommand vlastnost OleDbDataAdapter, můžete vytvořit objekt, který OleDbCommandBuilder automaticky vygeneruje příkazy SQL pro aktualizace s jednou tabulkou. Potom se všechny další příkazy SQL, které nenastavíte, vygeneruje OleDbCommandBuilder.

Při každém nastavení DataAdapter vlastnosti se OleDbCommandBuilder zaregistruje jako naslouchací proces pro RowUpdating události. Najednou můžete k sobě přidružit jenom jeden OleDbDataAdapter objekt nebo OleDbCommandBuilder objekt.

Pokud chcete generovat příkazy INSERT, UPDATE nebo DELETE, OleDbCommandBuilder použije 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 volat metodu RefreshSchema pro aktualizaci metadat.

Používá OleDbCommandBuilder také Connectionvlastnosti , CommandTimeouta, na Transaction které SelectCommandodkazuje . Uživatel by měl volat RefreshSchema , pokud jsou některé z těchto vlastností změněny nebo pokud SelectCommand je nahrazena samotná. V opačném případě si InsertCommandvlastnosti , UpdateCommanda DeleteCommand zachovají své předchozí hodnoty.

Pokud zavoláte Dispose, OleDbCommandBuilder dojde k zrušení přidružení od a vygenerované příkazy se už nebudou OleDbDataAdapterpoužívat.

Konstruktory

OleDbCommandBuilder()

Inicializuje novou instanci OleDbCommandBuilder třídy.

OleDbCommandBuilder(OleDbDataAdapter)

Inicializuje novou instanci OleDbCommandBuilder třídy s přidruženým OleDbDataAdapter objektem.

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.

(Zděděno od DbCommandBuilder)
CatalogSeparator

Získá nebo nastaví řetězec použitý jako oddělovač katalogu pro instanci DbCommandBuilder třídy.

(Zděděno od DbCommandBuilder)
ConflictOption

Určuje, která ConflictOption má být použita nástrojem DbCommandBuilder.

(Zděděno od DbCommandBuilder)
Container

Získá objekt IContainer , který obsahuje Component.

(Zděděno od Component)
DataAdapter

Získá nebo nastaví OleDbDataAdapter objekt, pro který jsou automaticky generovány příkazy SQL.

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 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 vyhrazené tokeny.

QuotePrefix

Získá nebo nastaví počáteční znak nebo znaky 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 vyhrazené tokeny.

(Zděděno od DbCommandBuilder)
QuoteSuffix

Získá nebo nastaví koncový znak nebo znaky 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 vyhrazené tokeny.

QuoteSuffix

Získá nebo nastaví koncový znak nebo znaky 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 vyhrazené tokeny.

(Zděděno od DbCommandBuilder)
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.

(Zděděno od DbCommandBuilder)
SetAllValues

Určuje, jestli jsou zahrnuty všechny hodnoty sloupců v příkazu update, nebo pouze hodnoty změněné.

(Zděděno od DbCommandBuilder)
Site

Získá nebo nastaví ISite hodnotu Component.

(Zděděno od Component)

Metody

ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)

Umožňuje implementaci DbCommandBuilder zprostředkovatele třídy zpracovat další vlastnosti parametru.

(Zděděno od DbCommandBuilder)
CreateObjRef(Type)

Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy používaného ke komunikaci se vzdáleným objektem.

(Zděděno od MarshalByRefObject)
DeriveParameters(OleDbCommand)

Načte informace o parametrech z uložené procedury zadané v objektu OleDbCommand a naplní kolekci Parameters zadaného OleDbCommand objektu.

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 nástrojem a volitelně uvolní spravované prostředky.

(Zděděno od DbCommandBuilder)
Dispose(Boolean)

Uvolní nespravované prostředky používané Component nástrojem a volitelně uvolní spravované prostředky.

(Zděděno od Component)
Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
GetDeleteCommand()

Získá automaticky vygenerovaný OleDbCommand objekt potřebný k odstranění ve zdroji dat.

GetDeleteCommand(Boolean)

Získá automaticky vygenerovaný OleDbCommand objekt potřebný k odstranění ve zdroji dat.

GetHashCode()

Slouží jako výchozí hashovací funkce.

(Zděděno od Object)
GetInsertCommand()

Získá automaticky vygenerovaný OleDbCommand objekt potřebný k vložení do zdroje dat.

GetInsertCommand(Boolean)

Získá automaticky vygenerovaný OleDbCommand objekt potřebný k vložení do zdroje dat.

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žijte při vytváření vlastního tvůrce příkazů.

(Zděděno od DbCommandBuilder)
GetParameterName(String)

Vrátí úplný název parametru vzhledem k částečnému názvu parametru.

(Zděděno od DbCommandBuilder)
GetParameterPlaceholder(Int32)

Vrátí zástupný symbol parametru v přidruženém příkazu SQL.

(Zděděno od DbCommandBuilder)
GetSchemaTable(DbCommand)

Vrátí tabulku schématu pro DbCommandBuilder.

(Zděděno od DbCommandBuilder)
GetService(Type)

Vrátí objekt, který představuje službu poskytovanou objektem Component nebo .Container

(Zděděno od Component)
GetType()

Získá aktuální Type instanci.

(Zděděno od Object)
GetUpdateCommand()

Získá automaticky vygenerovaný OleDbCommand objekt potřebný k provádění aktualizací ve zdroji dat.

GetUpdateCommand(Boolean)

Získá automaticky vygenerovaný OleDbCommand objekt potřebný k provádění aktualizací ve zdroji dat, volitelně pomocí sloupců pro názvy parametrů.

InitializeCommand(DbCommand)

CommandTimeoutObnoví vlastnosti , Transaction, CommandTypea UpdateRowSource na DbCommand.

(Zděděno od DbCommandBuilder)
InitializeLifetimeService()
Zastaralé.

Získá objekt služby životnosti, 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)

Vzhledem k nekótovanému identifikátoru ve správném případě katalogu vrátí správnou uvozovanou formu tohoto identifikátoru. To zahrnuje správné úniky všech vložených uvozovek v identifikátoru.

QuoteIdentifier(String, OleDbConnection)

Vzhledem k nekótovanému identifikátoru ve správném případě katalogu vrátí správnou uvozovanou formu tohoto identifikátoru. To zahrnuje správné úniky všech vložených uvozovek v identifikátoru.

RefreshSchema()

Vymaže příkazy přidružené k tomuto OleDbCommandBuilderpříkazu .

RefreshSchema()

Vymaže příkazy přidružené k tomuto DbCommandBuilderpříkazu .

(Zděděno od DbCommandBuilder)
RowUpdatingHandler(RowUpdatingEventArgs)

Přidá obslužnou rutinu RowUpdating události pro událost.

(Zděděno od DbCommandBuilder)
SetRowUpdatingHandler(DbDataAdapter)

Zaregistruje DbCommandBuilder pro zpracování RowUpdating události pro DbDataAdapter.

(Zděděno od DbCommandBuilder)
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)

Při uvozovaném identifikátoru vrátí správný nekótovaný tvar tohoto identifikátoru. To zahrnuje správné zrušení úniku všech vložených uvozovek v identifikátoru.

UnquoteIdentifier(String, OleDbConnection)

Při uvozovaném identifikátoru vrátí správný nekótovaný tvar tohoto identifikátoru. To zahrnuje správné zrušení úniku všech vložených uvozovek v identifikátoru.

událost

Disposed

Nastane, když je komponenta odstraněna voláním Dispose() metody.

(Zděděno od Component)

Platí pro

Viz také