OleDbCommandBuilder Třída

Definice

Obor názvů:

System.Data.OleDb

Sestavení:

System.Data.OleDb.dll

Balíček:

System.Data.OleDb v8.0.0

Zdroj:

OleDbCommandBuilder.cs

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í. Tato třída se nemůže dědit.

public ref class OleDbCommandBuilder sealed : System::Data::Common::DbCommandBuilder

public sealed class OleDbCommandBuilder : System.Data.Common.DbCommandBuilder

type OleDbCommandBuilder = class
    inherit DbCommandBuilder

Public NotInheritable Class OleDbCommandBuilder
Inherits DbCommandBuilder

Dědičnost

Object

MarshalByRefObject

Component

DbCommandBuilder

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. Všechny další příkazy SQL, které nenastavíte, se pak vygenerují pomocí 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 oddělí se 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. (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. (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)
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()	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 jejím Containerobjektem . (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()	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řípadu 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řípadu 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 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)

Viz také

• Generování příkazů s CommandBuilders