DbCommandBuilder Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Genererar automatiskt kommandon med en tabell som används för att stämma av ändringar som gjorts i en DataSet med den associerade databasen. Det här är en abstrakt klass som bara kan ärvas.
public ref class DbCommandBuilder abstract : System::ComponentModel::Componentpublic abstract class DbCommandBuilder : System.ComponentModel.Componenttype DbCommandBuilder = class
inherit ComponentPublic MustInherit Class DbCommandBuilder
Inherits Component- Arv
- Härledda
Kommentarer
Klassen DbCommandBuilder tillhandahålls för att underlätta för providerförfattare som skapar sina egna kommandobyggare. Genom att ärva från den här klassen kan utvecklare implementera providerspecifikt beteende i sin egen kod.
Genererar DbDataAdapter inte automatiskt de SQL-instruktioner som krävs för att stämma av ändringar som gjorts i en DataSet med den associerade datakällan. Du kan dock skapa ett DbCommandBuilder objekt för att automatiskt generera SQL-instruktioner för uppdateringar med en tabell om du anger SelectCommand egenskapen för DbDataAdapter. Sedan genereras eventuella ytterligare SQL-instruktioner som du inte anger av DbCommandBuilder.
Registrerar DbCommandBuilder sig som lyssnare för RowUpdating händelser när du anger DataAdapter egenskapen. Du kan bara associera ett DbDataAdapter objekt eller DbCommandBuilder ett objekt med varandra samtidigt.
För att generera INSERT-, UPDATE- eller DELETE-instruktioner DbCommandBuilder använder SelectCommand egenskapen för att hämta en obligatorisk uppsättning metadata automatiskt. Om du ändrar SelectCommand när metadata har hämtats (till exempel efter den första uppdateringen) bör du anropa RefreshSchema metoden för att uppdatera metadata.
SelectCommand Måste också returnera minst en primärnyckel eller unik kolumn. Om det inte finns något genereras ett InvalidOperationException undantag och kommandona genereras inte.
Använder DbCommandBuilderConnectionockså egenskaperna , CommandTimeoutoch som Transaction refereras av SelectCommand. Användaren bör anropa RefreshSchema om någon av dessa egenskaper ändras eller om den SelectCommand ersätts. Annars InsertCommandbehåller egenskaperna , UpdateCommandoch DeleteCommand sina tidigare värden.
Om du anropar DisposeDbCommandBuilder kopplas de från , DbDataAdapteroch de genererade kommandona används inte längre.
Konstruktorer
| Name | Description |
|---|---|
| DbCommandBuilder() |
Initierar en ny instans av en klass som ärver från DbCommandBuilder klassen. |
Egenskaper
| Name | Description |
|---|---|
| CanRaiseEvents |
Hämtar ett värde som anger om komponenten kan generera en händelse. (Ärvd från Component) |
| CatalogLocation |
Hämtar eller anger CatalogLocation för en instans av DbCommandBuilder klassen. |
| CatalogSeparator |
Hämtar eller anger en sträng som används som katalogavgränsare för en instans av DbCommandBuilder klassen. |
| ConflictOption |
Anger vilket som ConflictOption ska användas av DbCommandBuilder. |
| Container |
Hämtar som IContainer innehåller Component. (Ärvd från Component) |
| DataAdapter |
Hämtar eller anger ett DbDataAdapter objekt för vilket Transact-SQL-instruktioner genereras automatiskt. |
| DesignMode |
Hämtar ett värde som anger om det Component för närvarande är i designläge. (Ärvd från Component) |
| Events |
Hämtar listan över händelsehanterare som är kopplade till den här Component. (Ärvd från Component) |
| QuotePrefix |
Hämtar eller anger det inledande tecknet eller tecknen som ska användas när du anger databasobjekt (till exempel tabeller eller kolumner) vars namn innehåller tecken som blanksteg eller reserverade token. |
| QuoteSuffix |
Hämtar eller anger sluttecknet eller tecknen som ska användas när du anger databasobjekt (till exempel tabeller eller kolumner) vars namn innehåller tecken som blanksteg eller reserverade token. |
| SchemaSeparator |
Hämtar eller anger det tecken som ska användas för avgränsaren mellan schemaidentifieraren och andra identifierare. |
| SetAllValues |
Anger om alla kolumnvärden i en uppdateringsinstruktor inkluderas eller bara ändras. |
| Site |
Hämtar eller ställer in ISite i Component. (Ärvd från Component) |
Metoder
| Name | Description |
|---|---|
| ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean) |
Gör att providerimplementeringen DbCommandBuilder av klassen kan hantera ytterligare parameteregenskaper. |
| CreateObjRef(Type) |
Skapar ett objekt som innehåller all relevant information som krävs för att generera en proxy som används för att kommunicera med ett fjärrobjekt. (Ärvd från MarshalByRefObject) |
| Dispose() |
Släpper alla resurser som används av Component. (Ärvd från Component) |
| Dispose(Boolean) |
Släpper de ohanterade resurser som används av DbCommandBuilder och släpper eventuellt de hanterade resurserna. |
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| GetDeleteCommand() |
Hämtar det automatiskt genererade DbCommand objekt som krävs för att utföra borttagningar i datakällan. |
| GetDeleteCommand(Boolean) |
Hämtar det automatiskt genererade DbCommand objekt som krävs för att utföra borttagningar i datakällan, om du vill använda kolumner för parameternamn. |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetInsertCommand() |
Hämtar det automatiskt genererade DbCommand objekt som krävs för att utföra infogningar i datakällan. |
| GetInsertCommand(Boolean) |
Hämtar det automatiskt genererade DbCommand objekt som krävs för att utföra infogningar i datakällan, om du vill använda kolumner för parameternamn. |
| GetLifetimeService() |
Föråldrad.
Hämtar det aktuella livslängdstjänstobjektet som styr livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject) |
| GetParameterName(Int32) |
Returnerar namnet på den angivna parametern i formatet |
| GetParameterName(String) |
Returnerar det fullständiga parameternamnet med det partiella parameternamnet. |
| GetParameterPlaceholder(Int32) |
Returnerar platshållaren för parametern i den associerade SQL-instruktionen. |
| GetSchemaTable(DbCommand) |
Returnerar schematabellen DbCommandBuilderför . |
| GetService(Type) |
Returnerar ett objekt som representerar en tjänst som tillhandahålls av Component eller av dess Container. (Ärvd från Component) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| GetUpdateCommand() |
Hämtar det automatiskt genererade DbCommand objekt som krävs för att utföra uppdateringar i datakällan. |
| GetUpdateCommand(Boolean) |
Hämtar det automatiskt genererade DbCommand objekt som krävs för att utföra uppdateringar i datakällan, om du vill använda kolumner för parameternamn. |
| InitializeCommand(DbCommand) |
Återställer CommandTimeoutegenskaperna , Transaction, CommandTypeoch UpdateRowSource på DbCommand. |
| InitializeLifetimeService() |
Föråldrad.
Hämtar ett tjänstobjekt för livslängd för att styra livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| MemberwiseClone(Boolean) |
Skapar en ytlig kopia av det aktuella MarshalByRefObject objektet. (Ärvd från MarshalByRefObject) |
| QuoteIdentifier(String) |
Givet en ociterad identifierare i rätt katalogfall returnerar rätt angiven form av identifieraren, inklusive att alla inbäddade citattecken i identifieraren raderas korrekt. |
| RefreshSchema() |
Rensar de kommandon som är associerade med den här DbCommandBuilder. |
| RowUpdatingHandler(RowUpdatingEventArgs) |
Lägger till en händelsehanterare för RowUpdating händelsen. |
| SetRowUpdatingHandler(DbDataAdapter) |
DbCommandBuilder Registrerar för att hantera RowUpdating händelsen för en DbDataAdapter. |
| ToString() |
Returnerar ett String som innehåller namnet på Component, om det finns. Den här metoden bör inte åsidosättas. (Ärvd från Component) |
| UnquoteIdentifier(String) |
Givet en citerad identifierare returnerar rätt ociterad form av identifieraren, inklusive korrekt avundning av inbäddade citattecken i identifieraren. |
Händelser
| Name | Description |
|---|---|
| Disposed |
Inträffar när komponenten tas bort av ett anrop till Dispose() metoden. (Ärvd från Component) |
