OleDbCommandBuilder Třída

Definice

Obor názvů:

System.Data.OleDb

Sestavení:

System.Data.OleDb.dll

Balíček:

System.Data.OleDb v11.0.0-preview.2.26159.112

Zdroj:

OleDbCommandBuilder.cs

Automaticky vygeneruje příkazy s jednou tabulkou, které slouží k odsouhlasení změn provedených v DataSet přidružené databázi. Tuto třídu nelze zdě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á OleDbCommandOleDbDataAdapter k výběru řádků ze zdroje dat řádky spolu a OleDbConnection. Příklad se předá inicializovanému DataSetpřipojovacímu řetězci, řetězci 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

Negeneruje OleDbDataAdapter 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 OleDbCommandBuilder objekt, který automaticky vygeneruje příkazy SQL pro aktualizace s jednou tabulkou, pokud nastavíte SelectCommand vlastnost OleDbDataAdapter. Pak všechny další příkazy SQL, které nenastavíte, jsou generovány OleDbCommandBuilder.

Zaregistruje OleDbCommandBuilder 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 OleDbDataAdapter objekt OleDbCommandBuilder najednou.

Chcete-li vygenerovat příkazy INSERT, UPDATE nebo DELETE, OleDbCommandBuilder 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.

Také OleDbCommandBuilder používá Connection, CommandTimeouta Transaction vlastnosti odkazované .SelectCommand Uživatel by měl volat RefreshSchema , pokud se změní jedna nebo více těchto vlastností, nebo pokud SelectCommand se sám nahradí. InsertCommand UpdateCommandV opačném případě , a DeleteCommand vlastnosti zachovat jejich předchozí hodnoty.

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

Konstruktory

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

Vlastnosti

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

Metody

Name	Description
DeriveParameters(OleDbCommand)	Načte informace o parametrech z uložené procedury zadané v OleDbCommand kolekci zadaného objektu a naplní Parameters kolekci zadaného OleDbCommand objektu.
GetDeleteCommand()	Získá automaticky vygenerovaný objekt vyžadovaný OleDbCommand k odstranění ve zdroji dat.
GetDeleteCommand(Boolean)	Získá automaticky vygenerovaný objekt vyžadovaný OleDbCommand k odstranění ve zdroji dat.
GetInsertCommand()	Získá automaticky vygenerovaný OleDbCommand objekt potřebný k provedení vložení ve zdroji dat.
GetInsertCommand(Boolean)	Získá automaticky vygenerovaný OleDbCommand objekt potřebný k provedení vložení ve zdroji dat.
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ů.
QuoteIdentifier(String, OleDbConnection)	Vzhledem k necitovanému identifikátoru ve správném případě katalogu vrátí správnou uvozovou formu tohoto identifikátoru. To zahrnuje správné zapouzdření všech vložených uvozovek v identifikátoru.
QuoteIdentifier(String)	Vzhledem k necitovanému identifikátoru ve správném případě katalogu vrátí správnou uvozovou formu tohoto identifikátoru. To zahrnuje správné zapouzdření všech vložených uvozovek v identifikátoru.
UnquoteIdentifier(String, OleDbConnection)	Vzhledem k uvozovanému identifikátoru vrátí správnou necitovanou formu tohoto identifikátoru. To zahrnuje správné zrušení zapouzdření všech vložených uvozovek v identifikátoru.
UnquoteIdentifier(String)	Vzhledem k uvozovanému identifikátoru vrátí správnou necitovanou formu tohoto identifikátoru. To zahrnuje správné zrušení zapouzdření všech vložených uvozovek v identifikátoru.

Viz také

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