OdbcCommandBuilder Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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 ref class OdbcCommandBuilder sealed : System::ComponentModel::Component
public sealed class OdbcCommandBuilder : System.Data.Common.DbCommandBuilder
public sealed class OdbcCommandBuilder : System.ComponentModel.Component
type OdbcCommandBuilder = class
inherit DbCommandBuilder
type OdbcCommandBuilder = class
inherit Component
Public NotInheritable Class OdbcCommandBuilder
Inherits DbCommandBuilder
Public NotInheritable Class OdbcCommandBuilder
Inherits Component
- Dědičnost
- Dědičnost
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 použít při práci s databázovými objekty (například tabulky nebo sloupce), jejichž názvy obsahují znaky, jako jsou mezery nebo rezervované tokeny. |
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 práci s databázovými objekty (například tabulky nebo sloupce), jejichž názvy obsahují znaky, jako jsou mezery nebo rezervované tokeny. |
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) |
Dispose(Boolean) |
Uvolní nespravované prostředky používané nástrojem Component 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 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() |
Zastaralé.
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 |
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() |
Zastaralé.
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 OdbcCommandBuilder. |
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) |