OleDbCommandBuilder 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 går inte att ärva den här klassen.
public ref class OleDbCommandBuilder sealed : System::Data::Common::DbCommandBuilderpublic ref class OleDbCommandBuilder sealed : System::ComponentModel::Componentpublic sealed class OleDbCommandBuilder : System.Data.Common.DbCommandBuilderpublic sealed class OleDbCommandBuilder : System.ComponentModel.Componenttype OleDbCommandBuilder = class
inherit DbCommandBuildertype OleDbCommandBuilder = class
inherit ComponentPublic NotInheritable Class OleDbCommandBuilder
Inherits DbCommandBuilderPublic NotInheritable Class OleDbCommandBuilder
Inherits Component- Arv
- Arv
Exempel
I följande exempel används OleDbCommand, tillsammans OleDbDataAdapter och OleDbConnection, för att välja rader från en datakälla. Exemplet skickas en initierad DataSet, en reťazec pripojenia, en frågesträng som är en SQL SELECT-instruktion och en sträng som är namnet på datakälltabellen. Exemplet skapar sedan en 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
Kommentarer
Genererar OleDbDataAdapter 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 OleDbCommandBuilder objekt för att automatiskt generera SQL-instruktioner för uppdateringar med en tabell om du anger SelectCommand egenskapen för OleDbDataAdapter. Sedan genereras eventuella ytterligare SQL-instruktioner som du inte anger av OleDbCommandBuilder.
Registrerar OleDbCommandBuilder sig som lyssnare för RowUpdating händelser när du anger DataAdapter egenskapen. Du kan bara associera ett OleDbDataAdapter objekt eller OleDbCommandBuilder ett objekt med varandra samtidigt.
För att generera INSERT-, UPDATE- eller DELETE-instruktioner OleDbCommandBuilder använder SelectCommand egenskapen för att hämta en obligatorisk uppsättning metadata automatiskt. Om du ändrar SelectCommand när metadata hämtas, till exempel efter den första uppdateringen, bör du anropa RefreshSchema metoden för att uppdatera metadata.
Använder OleDbCommandBuilderConnectionockså egenskaperna , CommandTimeoutoch som Transaction refereras av SelectCommand. Användaren bör anropa RefreshSchema om en eller flera av dessa egenskaper ändras eller om den SelectCommand ersätts. Annars InsertCommandbehåller egenskaperna , UpdateCommandoch DeleteCommand sina tidigare värden.
Om du anropar DisposeOleDbCommandBuilder kopplas de från , OleDbDataAdapteroch de genererade kommandona används inte längre.
Konstruktorer
| Name | Description |
|---|---|
| OleDbCommandBuilder() |
Initierar en ny instans av OleDbCommandBuilder klassen. |
| OleDbCommandBuilder(OleDbDataAdapter) |
Initierar en ny instans av OleDbCommandBuilder klassen med det associerade OleDbDataAdapter objektet. |
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. (Ärvd från DbCommandBuilder) |
| CatalogSeparator |
Hämtar eller anger en sträng som används som katalogavgränsare för en instans av DbCommandBuilder klassen. (Ärvd från DbCommandBuilder) |
| ConflictOption |
Anger vilket som ConflictOption ska användas av DbCommandBuilder. (Ärvd från DbCommandBuilder) |
| Container |
Hämtar som IContainer innehåller Component. (Ärvd från Component) |
| DataAdapter |
Hämtar eller anger ett OleDbDataAdapter objekt som SQL-uttryck genereras automatiskt för. |
| 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. |
| 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. (Ärvd från DbCommandBuilder) |
| 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. |
| 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. (Ärvd från DbCommandBuilder) |
| SchemaSeparator |
Hämtar eller anger det tecken som ska användas för avgränsaren mellan schemaidentifieraren och andra identifierare. (Ärvd från DbCommandBuilder) |
| SetAllValues |
Anger om alla kolumnvärden i en uppdateringsinstruktor inkluderas eller bara ändras. (Ärvd från DbCommandBuilder) |
| 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. (Ärvd från DbCommandBuilder) |
| 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) |
| DeriveParameters(OleDbCommand) |
Hämtar parameterinformation från den lagrade proceduren som anges i OleDbCommand och fyller i Parameters samlingen av det angivna OleDbCommand objektet. |
| 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. (Ärvd från DbCommandBuilder) |
| Dispose(Boolean) |
Släpper de ohanterade resurser som används av Component och släpper eventuellt de hanterade resurserna. (Ärvd från Component) |
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| GetDeleteCommand() |
Hämtar det automatiskt genererade OleDbCommand objekt som krävs för att utföra borttagningar i datakällan. |
| GetDeleteCommand(Boolean) |
Hämtar det automatiskt genererade OleDbCommand objekt som krävs för att utföra borttagningar i datakällan. |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetInsertCommand() |
Hämtar det automatiskt genererade OleDbCommand objekt som krävs för att utföra infogningar i datakällan. |
| GetInsertCommand(Boolean) |
Hämtar det automatiskt genererade OleDbCommand objekt som krävs för att utföra infogningar i datakällan. |
| 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. (Ärvd från DbCommandBuilder) |
| GetParameterPlaceholder(Int32) |
Returnerar platshållaren för parametern i den associerade SQL-instruktionen. (Ärvd från DbCommandBuilder) |
| GetSchemaTable(DbCommand) |
Returnerar schematabellen DbCommandBuilderför . (Ärvd från DbCommandBuilder) |
| 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 OleDbCommand objekt som krävs för att utföra uppdateringar i datakällan. |
| GetUpdateCommand(Boolean) |
Hämtar det automatiskt genererade OleDbCommand 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. (Ärvd från DbCommandBuilder) |
| 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, OleDbConnection) |
Givet en ociterad identifierare i rätt katalogfall returnerar rätt angiven form av identifieraren. Detta inkluderar att alla inbäddade citattecken i identifieraren raderas korrekt. |
| QuoteIdentifier(String) |
Givet en ociterad identifierare i rätt katalogfall returnerar rätt angiven form av identifieraren. Detta inkluderar att alla inbäddade citattecken i identifieraren raderas korrekt. |
| RefreshSchema() |
Rensar de kommandon som är associerade med den här OleDbCommandBuilder. |
| RefreshSchema() |
Rensar de kommandon som är associerade med den här DbCommandBuilder. (Ärvd från DbCommandBuilder) |
| RowUpdatingHandler(RowUpdatingEventArgs) |
Lägger till en händelsehanterare för RowUpdating händelsen. (Ärvd från DbCommandBuilder) |
| SetRowUpdatingHandler(DbDataAdapter) |
DbCommandBuilder Registrerar för att hantera RowUpdating händelsen för en DbDataAdapter. (Ärvd från DbCommandBuilder) |
| 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, OleDbConnection) |
Med en citerad identifierare returnerar rätt ociterad form av identifieraren. Detta inkluderar korrekt avundning av inbäddade citattecken i identifieraren. |
| UnquoteIdentifier(String) |
Med en citerad identifierare returnerar rätt ociterad form av identifieraren. Detta inkluderar 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) |
