OleDbCommandBuilder Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Generiert automatisch Einzeltabellenbefehle, die verwendet werden, um An einer DataSet mit der zugeordneten Datenbank vorgenommene Änderungen abzugleichen. Diese Klasse kann nicht vererbt werden.
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- Vererbung
- Vererbung
Beispiele
Im folgenden Beispiel werden die OleDbCommandZeilen aus einer Datenquelle zusammen mit OleDbDataAdapter und OleDbConnectionzum Auswählen von Zeilen aus einer Datenquelle verwendet. Das Beispiel wird an eine initialisierte DataSet, eine Verbindungszeichenfolge, eine Abfragezeichenfolge, die eine SQL SELECT-Anweisung ist, und eine Zeichenfolge übergeben, die den Namen der Datenquellentabelle darstellt. Anschließend wird ein 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
Hinweise
Die OleDbDataAdapter SQL-Anweisungen, die zum Abgleichen von Änderungen an einer DataSet mit der zugeordneten Datenquelle vorgenommenen Änderungen erforderlich sind, werden nicht automatisch generiert. Sie können jedoch ein OleDbCommandBuilder Objekt erstellen, um SQL-Anweisungen für Aktualisierungen mit einer einzelnen Tabelle automatisch zu generieren, wenn Sie die SelectCommand Eigenschaft der OleDbDataAdapter. Anschließend werden alle zusätzlichen SQL-Anweisungen, die Sie nicht festlegen, von der OleDbCommandBuilder.
Das OleDbCommandBuilder Register selbst wird als Listener für RowUpdating Ereignisse registriert, wenn Sie die DataAdapter Eigenschaft festlegen. Sie können jeweils nur ein objekt oder OleDbCommandBuilder ein OleDbDataAdapter Objekt miteinander verknüpfen.
Zum Generieren von INSERT-, UPDATE- oder DELETE-Anweisungen verwendet SelectCommand die OleDbCommandBuilder Eigenschaft, um automatisch einen erforderlichen Satz von Metadaten abzurufen. Wenn Sie die Nach dem Abrufen der SelectCommand Metadaten ändern, z. B. nach dem ersten Update, sollten Sie die RefreshSchema Methode aufrufen, um die Metadaten zu aktualisieren.
Dies OleDbCommandBuilder verwendet auch die Connectioneigenschaften, TransactionCommandTimeoutauf die durch die SelectCommand. Der Benutzer sollte aufrufen RefreshSchema , ob eine oder mehrere dieser Eigenschaften geändert werden, oder wenn der SelectCommand benutzer selbst ersetzt wird. Andernfalls behalten die InsertCommandEigenschaften UpdateCommanddie DeleteCommand vorherigen Werte bei.
Wenn Sie aufrufen Dispose, wird die OleDbCommandBuilder Zuordnung des Befehls aufgehoben OleDbDataAdapter, und die generierten Befehle werden nicht mehr verwendet.
Konstruktoren
| Name | Beschreibung |
|---|---|
| OleDbCommandBuilder() |
Initialisiert eine neue Instanz der OleDbCommandBuilder-Klasse. |
| OleDbCommandBuilder(OleDbDataAdapter) |
Initialisiert eine neue Instanz der OleDbCommandBuilder Klasse mit dem zugeordneten OleDbDataAdapter Objekt. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| CanRaiseEvents |
Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Geerbt von Component) |
| CatalogLocation |
Dient zum Abrufen oder Festlegen der CatalogLocation Für eine Instanz der DbCommandBuilder Klasse. (Geerbt von DbCommandBuilder) |
| CatalogSeparator |
Dient zum Abrufen oder Festlegen einer Zeichenfolge, die als Katalogtrennzeichen für eine Instanz der DbCommandBuilder Klasse verwendet wird. (Geerbt von DbCommandBuilder) |
| ConflictOption |
Gibt an, welche ConflictOption von der DbCommandBuilder. (Geerbt von DbCommandBuilder) |
| Container |
Ruft das, das IContainer die Component. (Geerbt von Component) |
| DataAdapter |
Dient zum Abrufen oder Festlegen eines OleDbDataAdapter Objekts, für das SQL-Anweisungen automatisch generiert werden. |
| DesignMode |
Ruft einen Wert ab, der angibt, ob sich der Component Entwurfsmodus derzeit befindet. (Geerbt von Component) |
| Events |
Ruft die Liste der Ereignishandler ab, die an diese Componentangefügt sind. (Geerbt von Component) |
| QuotePrefix |
Ruft ab oder legt das Anfangszeichen oder Zeichen fest, die beim Angeben von Datenbankobjekten (z. B. Tabellen oder Spalten) verwendet werden sollen, deren Namen Zeichen wie Leerzeichen oder reservierte Token enthalten. |
| QuotePrefix |
Ruft ab oder legt das Anfangszeichen oder Zeichen fest, die beim Angeben von Datenbankobjekten (z. B. Tabellen oder Spalten) verwendet werden sollen, deren Namen Zeichen wie Leerzeichen oder reservierte Token enthalten. (Geerbt von DbCommandBuilder) |
| QuoteSuffix |
Ruft ab oder legt das endende Zeichen oder Zeichen, das beim Angeben von Datenbankobjekten (z. B. Tabellen oder Spalten) verwendet werden soll, deren Namen Zeichen wie Leerzeichen oder reservierte Token enthalten. |
| QuoteSuffix |
Ruft ab oder legt das endende Zeichen oder Zeichen, das beim Angeben von Datenbankobjekten (z. B. Tabellen oder Spalten) verwendet werden soll, deren Namen Zeichen wie Leerzeichen oder reservierte Token enthalten. (Geerbt von DbCommandBuilder) |
| SchemaSeparator |
Dient zum Abrufen oder Festlegen des Zeichens, das für das Trennzeichen zwischen dem Schemabezeichner und anderen Bezeichnern verwendet werden soll. (Geerbt von DbCommandBuilder) |
| SetAllValues |
Gibt an, ob alle Spaltenwerte in einer Update-Anweisung enthalten oder nur geändert werden. (Geerbt von DbCommandBuilder) |
| Site |
Dient zum ISite Abrufen oder Festlegen des Werts des Component. (Geerbt von Component) |
Methoden
| Name | Beschreibung |
|---|---|
| ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean) |
Ermöglicht der Anbieterimplementierung der DbCommandBuilder Klasse, zusätzliche Parametereigenschaften zu verarbeiten. (Geerbt von DbCommandBuilder) |
| CreateObjRef(Type) |
Erstellt ein Objekt, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird. (Geerbt von MarshalByRefObject) |
| DeriveParameters(OleDbCommand) |
Ruft Parameterinformationen aus der gespeicherten Prozedur ab, die in der OleDbCommand angegebenen Prozedur angegeben ist, und füllt die Parameters Auflistung des angegebenen OleDbCommand Objekts auf. |
| Dispose() |
Veröffentlicht alle ressourcen, die von der Component. (Geerbt von Component) |
| Dispose(Boolean) |
Gibt die nicht verwalteten Ressourcen frei, die von den DbCommandBuilder verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von DbCommandBuilder) |
| Dispose(Boolean) |
Gibt die nicht verwalteten Ressourcen frei, die von den Component verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von Component) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetDeleteCommand() |
Ruft das automatisch generierte OleDbCommand Objekt ab, das zum Ausführen von Löschungen an der Datenquelle erforderlich ist. |
| GetDeleteCommand(Boolean) |
Ruft das automatisch generierte OleDbCommand Objekt ab, das zum Ausführen von Löschungen an der Datenquelle erforderlich ist. |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetInsertCommand() |
Ruft das automatisch generierte OleDbCommand Objekt ab, das zum Ausführen von Einfügungen an der Datenquelle erforderlich ist. |
| GetInsertCommand(Boolean) |
Ruft das automatisch generierte OleDbCommand Objekt ab, das zum Ausführen von Einfügungen an der Datenquelle erforderlich ist. |
| GetLifetimeService() |
Veraltet.
Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert. (Geerbt von MarshalByRefObject) |
| GetParameterName(Int32) |
Gibt den Namen des angegebenen Parameters im Format von |
| GetParameterName(String) |
Gibt den vollständigen Parameternamen zurück, wobei der Teilparametername angegeben ist. (Geerbt von DbCommandBuilder) |
| GetParameterPlaceholder(Int32) |
Gibt den Platzhalter für den Parameter in der zugeordneten SQL-Anweisung zurück. (Geerbt von DbCommandBuilder) |
| GetSchemaTable(DbCommand) |
Gibt die Schematabelle für die DbCommandBuilder. (Geerbt von DbCommandBuilder) |
| GetService(Type) |
Gibt ein Objekt zurück, das einen Dienst darstellt, der von der Component oder dem zugehörigen ContainerDienst bereitgestellt wird. (Geerbt von Component) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| GetUpdateCommand() |
Ruft das automatisch generierte OleDbCommand Objekt ab, das zum Ausführen von Aktualisierungen an der Datenquelle erforderlich ist. |
| GetUpdateCommand(Boolean) |
Ruft das automatisch generierte OleDbCommand Objekt ab, das zum Ausführen von Aktualisierungen an der Datenquelle erforderlich ist, optional mithilfe von Spalten für Parameternamen. |
| InitializeCommand(DbCommand) |
Setzt die CommandTimeoutEigenschaften TransactionCommandType, und UpdateRowSource Eigenschaften für die DbCommand. (Geerbt von DbCommandBuilder) |
| InitializeLifetimeService() |
Veraltet.
Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern. (Geerbt von MarshalByRefObject) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| MemberwiseClone(Boolean) |
Erstellt eine flache Kopie des aktuellen MarshalByRefObject Objekts. (Geerbt von MarshalByRefObject) |
| QuoteIdentifier(String, OleDbConnection) |
Wenn im richtigen Katalogfall ein nicht angibter Bezeichner angegeben wird, wird die richtige Form dieses Bezeichners zurückgegeben. Dazu gehört, dass alle eingebetteten Anführungszeichen im Bezeichner korrekt entfernt werden. |
| QuoteIdentifier(String) |
Wenn im richtigen Katalogfall ein nicht angibter Bezeichner angegeben wird, wird die richtige Form dieses Bezeichners zurückgegeben. Dazu gehört, dass alle eingebetteten Anführungszeichen im Bezeichner korrekt entfernt werden. |
| RefreshSchema() |
Löscht die befehle, die diesem OleDbCommandBuilderzugeordnet sind. |
| RefreshSchema() |
Löscht die befehle, die diesem DbCommandBuilderzugeordnet sind. (Geerbt von DbCommandBuilder) |
| RowUpdatingHandler(RowUpdatingEventArgs) |
Fügt einen Ereignishandler für das RowUpdating -Ereignis hinzu. (Geerbt von DbCommandBuilder) |
| SetRowUpdatingHandler(DbDataAdapter) |
Registriert das DbCommandBuilder Ereignis zum Behandeln des RowUpdating Ereignisses für ein DbDataAdapter. (Geerbt von DbCommandBuilder) |
| ToString() |
Gibt einen String mit dem Namen des Component, falls vorhanden, zurück. Diese Methode sollte nicht außer Kraft gesetzt werden. (Geerbt von Component) |
| UnquoteIdentifier(String, OleDbConnection) |
Gibt bei einem bezeichner mit Anmerkung die richtige nicht zitierte Form dieses Bezeichners zurück. Dazu gehört, dass alle eingebetteten Anführungszeichen im Bezeichner korrekt nicht entfernt werden. |
| UnquoteIdentifier(String) |
Gibt bei einem bezeichner mit Anmerkung die richtige nicht zitierte Form dieses Bezeichners zurück. Dazu gehört, dass alle eingebetteten Anführungszeichen im Bezeichner korrekt nicht entfernt werden. |
Ereignisse
| Name | Beschreibung |
|---|---|
| Disposed |
Tritt auf, wenn die Komponente durch einen Aufruf der Dispose() Methode verworfen wird. (Geerbt von Component) |
