OdbcCommandBuilder Třída

Definice

Obor názvů:

System.Data.Odbc

Sestavení:

System.Data.Odbc.dll

Balíček:

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

Zdroj:

OdbcCommandBuilder.cs

Automaticky vygeneruje příkazy s jednou tabulkou, které slouží k odsouhlasení změn provedených DataSet u přidruženého zdroje dat. Tuto třídu nelze zdědit.

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

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

type OdbcCommandBuilder = class
    inherit DbCommandBuilder

Public NotInheritable Class OdbcCommandBuilder
Inherits DbCommandBuilder

Dědičnost

Object

MarshalByRefObject

Component

DbCommandBuilder

OdbcCommandBuilder

Příklady

Následující příklad používá OdbcCommandspolečně s OdbcDataAdapter a OdbcConnectionk výběru řádků ze zdroje dat. 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ří .OdbcCommandBuilder

public static DataSet SelectOdbcSrvRows(string connectionString,
    string queryString, string tableName)
{
    DataSet dataSet = new DataSet();
    using (OdbcConnection connection = new OdbcConnection(connectionString))
    {
        OdbcDataAdapter adapter = new OdbcDataAdapter();
        adapter.SelectCommand =
            new OdbcCommand(queryString, connection);
        OdbcCommandBuilder builder =
            new OdbcCommandBuilder(adapter);

        connection.Open();

        adapter.Fill(dataSet, tableName);

        //code to modify data in DataSet here

        //Without the OdbcCommandBuilder this line would fail
        adapter.Update(dataSet, tableName);
    }
    return dataSet;
}

Public Function SelectOdbcSrvRows( _
    ByVal connectionString As String, ByVal queryString As String, _
    ByVal tableName As String) As DataSet

    Dim dataSet As New DataSet()

    Using connection As New OdbcConnection(connectionString)
        Dim adapter As New OdbcDataAdapter()
        adapter.SelectCommand = _
            New OdbcCommand(queryString, connection)
        Dim builder As New OdbcCommandBuilder(adapter)

        connection.Open()

        adapter.Fill(dataSet, tableName)

        ' Code to modify data in DataSet here 

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

    Return dataSet
End Function

Poznámky

Negeneruje OdbcDataAdapter automaticky příkazy SQL potřebné k odsouhlasení změn provedených ve DataSet zdroji dat přidruženém ke zdroji dat. Můžete však vytvořit OdbcCommandBuilder objekt, který generuje příkazy SQL pro aktualizace s jednou tabulkou nastavením SelectCommand vlastnosti OdbcDataAdapter. Potom OdbcCommandBuilder vygeneruje všechny další příkazy SQL, které nenastavíte.

Vztah mezi a jeho odpovídajícím OdbcCommandBuilder vztahem OdbcDataAdapter je vždy 1:1. Chcete-li vytvořit tuto korespondenci, nastavíte OdbcDataAdapter vlastnost objektu OdbcCommandBuilder . To způsobí OdbcCommandBuilder , že se zaregistruje jako naslouchací proces, který vytvoří výstup událostí RowUpdating , které ovlivňují DataSet.

K vygenerování OdbcCommandBuilder příkazů INSERT, UPDATE nebo DELETE používá SelectCommand vlastnost k načtení požadované sady metadat. Pokud změníte hodnotu SelectCommand po načtení metadat, například po první aktualizaci, měli byste volat metodu RefreshSchema pro aktualizaci metadat.

Poznámka:

Pokud příkaz SELECT přiřazený k SelectCommand vlastnosti používá aliasované názvy sloupců, výsledné příkazy INSERT, UPDATE a DELETE mohou být nepřesné nebo selžou. Pokud základní ovladač ODBC nemůže zadat odpovídající název základního sloupce pro název sloupce aliasu (pomocí SQL_DESC_BASE_COLUMN_NAME hodnoty SQLColAttribute), název aliasu lze použít ve vygenerovaných příkazech INSERT, UPDATE a DELETE. Například ovladač Microsoft ODBC pro Oracle vrátí název aliasu jako název základního sloupce. Proto vygenerované příkazy INSERT, UPDATE a DELETE způsobí chyby.

Také OdbcCommandBuilder 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 se změní hodnota SelectCommand samotné vlastnosti. InsertCommand UpdateCommandV opačném případě , a DeleteCommand vlastnosti zachovat jejich předchozí hodnoty.

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

Konstruktory

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

Vlastnosti

Name	Description
DataAdapter	Získá nebo nastaví OdbcDataAdapter objekt, pro který tento OdbcCommandBuilder objekt vygeneruje příkazy SQL.

Metody

Name	Description
DeriveParameters(OdbcCommand)	Načte informace o parametrech z uložené procedury zadané v OdbcCommand kolekci zadaného objektu a naplní Parameters kolekci zadaného OdbcCommand objektu.
GetDeleteCommand()	Získá automaticky vygenerovaný objekt vyžadovaný OdbcCommand k odstranění ve zdroji dat.
GetDeleteCommand(Boolean)	Získá automaticky vygenerovaný objekt vyžadovaný OdbcCommand k odstranění ve zdroji dat.
GetInsertCommand()	Získá automaticky vygenerovaný OdbcCommand objekt potřebný k provedení vložení ve zdroji dat.
GetInsertCommand(Boolean)	Získá automaticky vygenerovaný OdbcCommand objekt potřebný k provedení vložení ve zdroji dat.
GetUpdateCommand()	Získá automaticky vygenerovaný OdbcCommand objekt potřebný k provádění aktualizací ve zdroji dat.
GetUpdateCommand(Boolean)	Získá automaticky vygenerovaný OdbcCommand objekt potřebný k provádění aktualizací ve zdroji dat.
QuoteIdentifier(String, OdbcConnection)	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, OdbcConnection)	Vzhledem k identifikátoru v uvozovkách vrátí správnou necitovanou formu tohoto identifikátoru, včetně správné zrušení zapouzdření všech vložených uvozovek v identifikátoru.
UnquoteIdentifier(String)	Vzhledem k identifikátoru v uvozovkách vrátí správnou necitovanou formu tohoto identifikátoru, včetně správné zrušení zapouzdření všech vložených uvozovek v identifikátoru.

Viz také

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