OdbcCommandBuilder Třída

Definice

Obor názvů:

System.Data.Odbc

Sestavení:

System.Data.Odbc.dll

Balíček:

System.Data.Odbc v8.0.0

Zdroj:

OdbcCommandBuilder.cs

Automaticky vygeneruje příkazy s jednou tabulkou, které se používají k odsouhlasení změn provedených v tabulce DataSet s přidruženým zdrojem dat. Tato třída se nemůže dě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

V následujícím příkladu se k výběru řádků ze zdroje dat používá OdbcCommandspolečně s OdbcDataAdapter a OdbcConnection. 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ří .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 u DataSet přidruženého 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. Pak vygeneruje OdbcCommandBuilder všechny další příkazy SQL, které nenastavíte.

Vztah mezi objektem a odpovídajícím OdbcCommandBuilder objektem 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í RowUpdating proces, který vytvoří výstup událostí, které ovlivňují DataSet.

Chcete-li generovat příkazy INSERT, UPDATE nebo DELETE, OdbcCommandBuilder 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á aliasové názvy sloupců, výsledné příkazy INSERT, UPDATE a DELETE mohou být nepřesné nebo mohou být neúspěšné. Pokud podkladový ovladač ODBC nemůže poskytnout odpovídající název základního sloupce pro název sloupce aliasu (pomocí SQL_DESC_BASE_COLUMN_NAME hodnoty SQLColAttribute), může být název aliasu použit 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 by vygenerované příkazy INSERT, UPDATE a DELETE způsobily chyby.

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

Pokud zavoláte Dispose, dojde k OdbcCommandBuilder odpojení od a vygenerované příkazy se už nebudou OdbcDataAdapterpoužívat.

Konstruktory

OdbcCommandBuilder()	Inicializuje novou instanci OdbcCommandBuilder třídy .
OdbcCommandBuilder(OdbcDataAdapter)	Inicializuje novou instanci OdbcCommandBuilder třídy s přidruženým OdbcDataAdapter 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 parametr má použít DbCommandBuilder. (Zděděno od DbCommandBuilder)
Container	Získá objekt IContainer , který obsahuje Component. (Zděděno od Component)
DataAdapter	Získá nebo nastaví OdbcDataAdapter objekt, pro který tento OdbcCommandBuilder objekt vygeneruje 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, které se mají 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 rezervované tokeny. (Zděděno od DbCommandBuilder)
QuoteSuffix	Získá nebo nastaví koncový znak nebo znaky, které se mají 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 rezervované 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 zahrnuté všechny hodnoty sloupců v příkazu update, nebo jenom hodnoty změněné. (Zděděno od DbCommandBuilder)
Site	Získá nebo nastaví ISite z 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 sloužící ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
DeriveParameters(OdbcCommand)	Načte informace o parametru z uložené procedury zadané v OdbcCommand a naplní kolekci Parameters zadaného OdbcCommand 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é nástrojem DbCommandBuilder 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 generovaný OdbcCommand objekt potřebný k provedení odstranění ve zdroji dat.
GetDeleteCommand(Boolean)	Získá automaticky generovaný OdbcCommand objekt potřebný k provedení odstranění ve zdroji dat.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetInsertCommand()	Získá automaticky generovaný OdbcCommand objekt potřebný k provedení vložení do zdroje dat.
GetInsertCommand(Boolean)	Získá automaticky generovaný OdbcCommand objekt potřebný k provedení vložení do zdroje dat.
GetLifetimeService()	Načte aktuální životnost objektu služby, 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žívá se 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 pro parametr v přidruženém příkazu SQL. (Zděděno od DbCommandBuilder)
GetSchemaTable(DbCommand)	Vrátí tabulku schématu DbCommandBuilderpro . (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()	Type Získá z aktuální instance. (Zděděno od Object)
GetUpdateCommand()	Získá automaticky generovaný OdbcCommand objekt potřebný k provedení aktualizací ve zdroji dat.
GetUpdateCommand(Boolean)	Získá automaticky generovaný OdbcCommand objekt potřebný k provedení aktualizací ve zdroji dat.
InitializeCommand(DbCommand)	CommandTimeoutObnoví vlastnosti , Transaction, CommandTypea UpdateRowSource na objektu DbCommand. (Zděděno od DbCommandBuilder)
InitializeLifetimeService()	Získá životnost objektu služby, 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)	Při použití identifikátoru bez uvozování ve správném případě katalogu vrátí správný tvar tohoto identifikátoru v uvozovaném uvozování. To zahrnuje správné uvozovky v identifikátoru.
QuoteIdentifier(String, OdbcConnection)	Při použití identifikátoru bez uvozování ve správném případě katalogu vrátí správný tvar tohoto identifikátoru v uvozovaném uvozování. To zahrnuje správné uvozovky v identifikátoru.
RefreshSchema()	Vymaže příkazy přidružené k tomuto DbCommandBuilder. (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 , Componentpokud existuje. Tato metoda by neměla být přepsána. (Zděděno od Component)
UnquoteIdentifier(String)	Při použití identifikátoru v uvozovkách vrátí správnou formu tohoto identifikátoru bez uvozovek, včetně správného zrušení uvozovek v identifikátoru.
UnquoteIdentifier(String, OdbcConnection)	Při použití identifikátoru v uvozovkách vrátí správnou formu tohoto identifikátoru bez uvozovek, včetně správného zrušení uvozovek v identifikátoru.

Událost

Disposed

Vyvolá se, když je komponenta uvolněna voláním Dispose() metody . (Zděděno od Component)

Viz také

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