DbCommandBuilder 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. Dies ist eine abstrakte Klasse, die nur geerbt werden kann.
public ref class DbCommandBuilder abstract : System::ComponentModel::Componentpublic abstract class DbCommandBuilder : System.ComponentModel.Componenttype DbCommandBuilder = class
inherit ComponentPublic MustInherit Class DbCommandBuilder
Inherits Component- Vererbung
- Abgeleitet
Hinweise
Die DbCommandBuilder Klasse wird für den Komfort von Anbieterautoren bereitgestellt, die eigene Befehls-Generatoren erstellen. Durch die Vererbung von dieser Klasse können Entwickler anbieterspezifisches Verhalten in ihrem eigenen Code implementieren.
Die DbDataAdapter 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 DbCommandBuilder Objekt erstellen, um SQL-Anweisungen für Aktualisierungen mit einer einzelnen Tabelle automatisch zu generieren, wenn Sie die SelectCommand Eigenschaft der DbDataAdapter. Anschließend werden alle zusätzlichen SQL-Anweisungen, die Sie nicht festlegen, von der DbCommandBuilder.
Das DbCommandBuilder Register selbst wird als Listener für RowUpdating Ereignisse registriert, wenn Sie die DataAdapter Eigenschaft festlegen. Sie können jeweils nur ein objekt oder DbCommandBuilder ein DbDataAdapter Objekt miteinander verknüpfen.
Zum Generieren von INSERT-, UPDATE- oder DELETE-Anweisungen verwendet SelectCommand die DbCommandBuilder Eigenschaft, um automatisch einen erforderlichen Satz von Metadaten abzurufen. Wenn Sie die SelectCommand Metadaten ä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.
Dies DbCommandBuilder verwendet auch die Connectioneigenschaften, TransactionCommandTimeoutauf die durch die SelectCommand. Der Benutzer sollte aufrufen RefreshSchema , ob eine dieser Eigenschaften geändert wird oder wenn der SelectCommand benutzer selbst ersetzt wird. Andernfalls behalten die InsertCommandEigenschaften UpdateCommanddie DeleteCommand vorherigen Werte bei.
Wenn Sie aufrufen Dispose, wird die DbCommandBuilder Zuordnung des Befehls aufgehoben DbDataAdapter, und die generierten Befehle werden nicht mehr verwendet.
Konstruktoren
| Name | Beschreibung |
|---|---|
| DbCommandBuilder() |
Initialisiert eine neue Instanz einer Klasse, die von der DbCommandBuilder Klasse erbt. |
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. |
| CatalogSeparator |
Dient zum Abrufen oder Festlegen einer Zeichenfolge, die als Katalogtrennzeichen für eine Instanz der DbCommandBuilder Klasse verwendet wird. |
| ConflictOption |
Gibt an, welche ConflictOption von der DbCommandBuilder. |
| Container |
Ruft das, das IContainer die Component. (Geerbt von Component) |
| DataAdapter |
Dient zum Abrufen oder Festlegen eines DbDataAdapter Objekts, für das Transact-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. |
| 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. |
| SchemaSeparator |
Dient zum Abrufen oder Festlegen des Zeichens, das für das Trennzeichen zwischen dem Schemabezeichner und anderen Bezeichnern verwendet werden soll. |
| SetAllValues |
Gibt an, ob alle Spaltenwerte in einer Update-Anweisung enthalten oder nur geändert werden. |
| 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. |
| 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) |
| 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. |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetDeleteCommand() |
Ruft das automatisch generierte DbCommand Objekt ab, das zum Ausführen von Löschungen an der Datenquelle erforderlich ist. |
| GetDeleteCommand(Boolean) |
Ruft das automatisch generierte DbCommand Objekt ab, das zum Ausführen von Löschungen an der Datenquelle erforderlich ist, optional mithilfe von Spalten für Parameternamen. |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetInsertCommand() |
Ruft das automatisch generierte DbCommand Objekt ab, das zum Ausführen von Einfügungen an der Datenquelle erforderlich ist. |
| GetInsertCommand(Boolean) |
Ruft das automatisch generierte DbCommand Objekt ab, das zum Ausführen von Einfügungen an der Datenquelle erforderlich ist, optional mithilfe von Spalten für Parameternamen. |
| 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. |
| GetParameterPlaceholder(Int32) |
Gibt den Platzhalter für den Parameter in der zugeordneten SQL-Anweisung zurück. |
| GetSchemaTable(DbCommand) |
Gibt die Schematabelle für die 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 DbCommand Objekt ab, das zum Ausführen von Aktualisierungen an der Datenquelle erforderlich ist. |
| GetUpdateCommand(Boolean) |
Ruft das automatisch generierte DbCommand 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. |
| 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) |
Wenn im richtigen Katalogfall ein nicht anführungszeichenierter Bezeichner angegeben wird, wird die richtige Form dieses Bezeichners zurückgegeben, einschließlich der ordnungsgemäßen Kapselung eingebetteter Anführungszeichen im Bezeichner. |
| RefreshSchema() |
Löscht die befehle, die diesem DbCommandBuilderzugeordnet sind. |
| RowUpdatingHandler(RowUpdatingEventArgs) |
Fügt einen Ereignishandler für das RowUpdating -Ereignis hinzu. |
| SetRowUpdatingHandler(DbDataAdapter) |
Registriert das DbCommandBuilder Ereignis zum Behandeln des RowUpdating Ereignisses für ein DbDataAdapter. |
| 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) |
Wenn ein Bezeichner mit Anführungszeichen angegeben wird, wird die richtige nicht anführungszeichenlose Form dieses Bezeichners zurückgegeben, einschließlich der ordnungsgemäßen Entkapselung eingebetteter Anführungszeichen im Bezeichner. |
Ereignisse
| Name | Beschreibung |
|---|---|
| Disposed |
Tritt auf, wenn die Komponente durch einen Aufruf der Dispose() Methode verworfen wird. (Geerbt von Component) |
