Freigeben über


DbCommandBuilder Klasse

Definition

Generiert automatisch Befehle für einzelne Tabellen, durch die an einem DataSet vorgenommene Änderungen mit der zugeordneten Datenbank abgeglichen werden. Dies ist eine abstrakte Klasse, die nur geerbt werden kann.

public ref class DbCommandBuilder abstract : System::ComponentModel::Component
public abstract class DbCommandBuilder : System.ComponentModel.Component
type DbCommandBuilder = class
    inherit Component
Public MustInherit Class DbCommandBuilder
Inherits Component
Vererbung
Abgeleitet

Hinweise

Die DbCommandBuilder -Klasse wird bereitgestellt, um anbieterautoren die Erstellung eigener Befehlsersteller zu vereinfachen. Durch Das Erben von dieser Klasse können Entwickler anbieterspezifisches Verhalten in ihrem eigenen Code implementieren.

Der DbDataAdapter generiert nicht automatisch die SQL-Anweisungen, die erforderlich sind, um an einem DataSet vorgenommene Änderungen mit der zugeordneten Datenquelle abzugleichen. Sie können jedoch ein DbCommandBuilder -Objekt zum automatischen Generieren von SQL-Anweisungen für Einzeltabellenupdates erstellen, wenn Sie die SelectCommand -Eigenschaft von DbDataAdapterfestlegen. Anschließend werden alle zusätzlichen SQL-Anweisungen, die Sie nicht festlegen, vom DbCommandBuildergeneriert.

Der DbCommandBuilder registriert sich selbst als Listener für RowUpdating Ereignisse, wenn Sie die DataAdapter -Eigenschaft festlegen. Sie können nur ein DbDataAdapter Objekt oder DbCommandBuilder ein Objekt gleichzeitig miteinander zuordnen.

Zum Generieren von INSERT-, UPDATE- oder DELETE-Anweisungen verwendet die DbCommandBuilderSelectCommand -Eigenschaft, um einen erforderlichen Satz von Metadaten automatisch abzurufen. Wenn Sie die SelectCommand ändern, nachdem die Metadaten abgerufen wurden (z. B. nach dem ersten Update), sollten Sie die RefreshSchema -Methode aufrufen, um die Metadaten zu aktualisieren.

Der SelectCommand muss außerdem mindestens einen Primärschlüssel oder eine eindeutige Spalte zurückgeben. Wenn keine vorhanden ist, wird eine InvalidOperationException Ausnahme generiert, und die Befehle werden nicht generiert.

Verwendet DbCommandBuilder auch die ConnectionEigenschaften , CommandTimeoutund , auf Transaction die SelectCommandvon verwiesen wird. Der Benutzer sollte aufrufen RefreshSchema , wenn eine dieser Eigenschaften geändert wird oder wenn die SelectCommand sich selbst ersetzt wird. Andernfalls behalten die InsertCommandEigenschaften , UpdateCommandund DeleteCommand ihre vorherigen Werte bei.

Wenn Sie aufrufen Dispose, wird die DbCommandBuilder Zuordnung zu DbDataAdapterdem getrennt, und die generierten Befehle werden nicht mehr verwendet.

Konstruktoren

DbCommandBuilder()

Initialisiert eine neue Instanz einer Klasse, die von der DbCommandBuilder-Klasse erbt.

Eigenschaften

CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.

(Geerbt von Component)
CatalogLocation

Ruft die CatalogLocation für eine Instanz der DbCommandBuilder-Klasse ab oder legt sie fest.

CatalogSeparator

Ruft eine Zeichenfolge als Katalogtrennzeichen für eine Instanz der DbCommandBuilder-Klasse ab oder legt sie fest.

ConflictOption

Gibt an, welche ConflictOption vom DbCommandBuilder verwendet werden muss.

Container

Ruft die IContainer ab, die in der Component enthalten ist.

(Geerbt von Component)
DataAdapter

Ruft ein DbDataAdapter-Objekt ab, für das automatisch Transact-SQL-Anweisungen generiert werden, oder legt dieses fest.

DesignMode

Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet.

(Geerbt von Component)
Events

Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind.

(Geerbt von Component)
QuotePrefix

Ruft das oder die Anfangszeichen ab, die beim Angeben von Datenbankobjekten (z. B. Tabellen oder Spalten) verwendet werden sollen, deren Namen Zeichen wie Leerzeichen oder reservierte Token enthalten, oder legt diese fest.

QuoteSuffix

Ruft das oder die Endzeichen ab, die beim Angeben von Datenbankobjekten (z. B. Tabellen oder Spalten) verwendet werden sollen, deren Namen Zeichen wie Leerzeichen oder reservierte Token enthalten, oder legt diese fest.

SchemaSeparator

Ruft das als Trennzeichen zwischen dem Schemabezeichner und anderen Bezeichnern zu verwendende Zeichen ab oder legt dieses fest.

SetAllValues

Gibt an, ob alle Spaltenwerte oder nur die geänderten in einer Aktualisierungsanweisung eingeschlossen sind.

Site

Ruft den ISite von Component ab oder legt ihn fest.

(Geerbt von Component)

Methoden

ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)

Ermöglicht es der Anbieterimplementierung der DbCommandBuilder-Klasse, zusätzliche Parametereigenschaften zu behandeln.

CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.

(Geerbt von MarshalByRefObject)
Dispose()

Gibt alle vom Component verwendeten Ressourcen frei.

(Geerbt von Component)
Dispose(Boolean)

Gibt die von DbCommandBuilder verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetDeleteCommand()

Ruft das automatisch generierte DbCommand-Objekt ab, das zum Ausführen von Löschvorgängen in der Datenquelle erforderlich ist.

GetDeleteCommand(Boolean)

Ruft das automatisch generierte DbCommand-Objekt ab, das zum Ausführen von Löschvorgängen in der Datenquelle erforderlich ist, wobei optional Spalten für Parameternamen verwendet werden.

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetInsertCommand()

Ruft das automatisch generierte DbCommand-Objekt ab, das zum Ausführen von Einfügevorgängen in der Datenquelle erforderlich ist.

GetInsertCommand(Boolean)

Ruft das automatisch generierte DbCommand-Objekt ab, das zum Ausführen von Einfügevorgängen in der Datenquelle erforderlich ist, wobei optional Spalten für Parameternamen verwendet werden.

GetLifetimeService()
Veraltet.

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.

(Geerbt von MarshalByRefObject)
GetParameterName(Int32)

Gibt den Namen des angegebenen Parameters im Format zurück @p#. Verwenden Sie diesen zum Erstellen eines benutzerdefinierten Befehls-Generators.

GetParameterName(String)

Gibt den vollständigen Parameternamen zurück, wenn der partielle Parameternamen angegeben ist.

GetParameterPlaceholder(Int32)

Gibt den Platzhalter für den Parameter in der zugeordneten SQL-Anweisung zurück.

GetSchemaTable(DbCommand)

Gibt die Schematabelle für den DbCommandBuilder zurück.

GetService(Type)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.

(Geerbt von Component)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
GetUpdateCommand()

Ruft das automatisch generierte DbCommand-Objekt ab, das zum Ausführen von Aktualisierungen in der Datenquelle erforderlich ist.

GetUpdateCommand(Boolean)

Ruft das automatisch generierte DbCommand-Objekt ab, das zum Ausführen von Aktualisierungen in der Datenquelle erforderlich ist, wobei optional Spalten für Parameternamen verwendet werden.

InitializeCommand(DbCommand)

Legt die Eigenschaften CommandTimeout, Transaction, CommandType und UpdateRowSource für DbCommand erneut fest.

InitializeLifetimeService()
Veraltet.

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.

(Geerbt von MarshalByRefObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.

(Geerbt von MarshalByRefObject)
QuoteIdentifier(String)

Bei einem Bezeichner ohne Anführungszeichen in der richtigen Katalogschreibweise wird die korrekte Form des jeweiligen Bezeichners mit Anführungszeichen zurückgegeben, einschließlich der ordnungsgemäßen Escapezeichen für ggf. vorhandene eingebettete Anführungszeichen im Bezeichner.

RefreshSchema()

Löscht die diesem DbCommandBuilder zugeordneten Befehle.

RowUpdatingHandler(RowUpdatingEventArgs)

Fügt einen Ereignishandler für das RowUpdating-Ereignis hinzu.

SetRowUpdatingHandler(DbDataAdapter)

Registriert den DbCommandBuilder zum Behandeln des RowUpdating-Ereignisses für einen DbDataAdapter.

ToString()

Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden). Diese Methode darf nicht überschrieben werden.

(Geerbt von Component)
UnquoteIdentifier(String)

Bei einem Bezeichner mit Anführungszeichen wird die richtige Form des Bezeichners ohne Anführungszeichen zurückgegeben. Dies schließt ein, dass Escapezeichen für eingebettete Anführungszeichen im Bezeichner ordnungsgemäß entfernt werden.

Ereignisse

Disposed

Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird.

(Geerbt von Component)

Gilt für:

Weitere Informationen