Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

DbCommandBuilder-Klasse

 

Veröffentlicht: Oktober 2016

Generiert automatisch die einzelne Tabelle Befehle zum Abstimmen von Änderungen an einer DataSet mit der zugehörigen Datenbank. Dies ist eine abstrakte Klasse, die nur geerbt werden kann.

Namespace:   System.Data.Common
Assembly:  System.Data (in System.Data.dll)

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Data.Common.DbCommandBuilder
        System.Data.Odbc.OdbcCommandBuilder
        System.Data.OleDb.OleDbCommandBuilder
        System.Data.OracleClient.OracleCommandBuilder
        System.Data.SqlClient.SqlCommandBuilder

public abstract class DbCommandBuilder : Component

NameBeschreibung
System_CAPS_protmethodDbCommandBuilder()

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

NameBeschreibung
System_CAPS_protpropertyCanRaiseEvents

Ruft einen Wert, der angibt, ob die Komponente ein Ereignis auslösen kann.(Geerbt von „Component“.)

System_CAPS_pubpropertyCatalogLocation

Ruft ab oder legt die CatalogLocation für eine Instanz von der DbCommandBuilder Klasse.

System_CAPS_pubpropertyCatalogSeparator

Legt fest oder ruft eine Zeichenfolge ab, die als Katalogtrennzeichen für den für eine Instanz von der DbCommandBuilder Klasse.

System_CAPS_pubpropertyConflictOption

Gibt an, welche ConflictOption von verwendet werden soll die DbCommandBuilder.

System_CAPS_pubpropertyContainer

Ruft die IContainer enthält die Component.(Geerbt von „Component“.)

System_CAPS_pubpropertyDataAdapter

Ruft ab oder legt einen DbDataAdapter Objekt für die Transact-SQL-Anweisungen werden automatisch generiert.

System_CAPS_protpropertyDesignMode

Ruft einen Wert, der angibt, ob die Component befindet sich derzeit im Entwurfsmodus befindet.(Geerbt von „Component“.)

System_CAPS_protpropertyEvents

Ruft die Liste der Ereignishandler, die mit dieser verknüpft sind Component.(Geerbt von „Component“.)

System_CAPS_pubpropertyQuotePrefix

Ruft ab oder legt das erste Zeichen oder Zeichen verwendet werden, wenn Sie Datenbankobjekte (z. B. Tabellen oder Spalten) angeben, deren Namen Zeichen wie Leerzeichen oder reservierte Token enthalten.

System_CAPS_pubpropertyQuoteSuffix

Ruft ab oder legt die oder Endzeichen beim Datenbankobjekte (z. B. Tabellen oder Spalten) angeben, deren Namen Zeichen wie Leerzeichen oder reservierte Token enthalten.

System_CAPS_pubpropertySchemaSeparator

Ruft ab oder legt fest, die Zeichen für das Trennzeichen zwischen dem Schemabezeichner und anderen Bezeichnern verwendet werden.

System_CAPS_pubpropertySetAllValues

Gibt an, ob alle Spaltenwerte in einer Update-Anweisung enthaltenen oder nur die geänderten Werte.

System_CAPS_pubpropertySite

Ruft ab oder legt die ISite von der Component.(Geerbt von „Component“.)

NameBeschreibung
System_CAPS_protmethodApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)

Die anbieterimplementierung ermöglicht die DbCommandBuilder Klasse, um zusätzliche Parametereigenschaften zu behandeln.

System_CAPS_pubmethodCreateObjRef(Type)

Erstellt ein Objekt, das alle relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt verwendet die enthält.(Geerbt von „MarshalByRefObject“.)

System_CAPS_pubmethodDispose()

Gibt alle vom Component verwendeten Ressourcen frei.(Geerbt von „Component“.)

System_CAPS_protmethodDispose(Boolean)

Gibt die von DbCommandBuilder verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.(Überschreibt Component.Dispose(Boolean).)

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_protmethodFinalize()

Gibt nicht verwaltete Ressourcen frei und führt andere Bereinigungsvorgänge durch, bevor die Component durch die Garbage Collection wieder zugänglich gemacht wird.(Geerbt von „Component“.)

System_CAPS_pubmethodGetDeleteCommand()

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

System_CAPS_pubmethodGetDeleteCommand(Boolean)

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

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_pubmethodGetInsertCommand()

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

System_CAPS_pubmethodGetInsertCommand(Boolean)

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

System_CAPS_pubmethodGetLifetimeService()

Ruft das Dienstobjekt für aktuellen Lebensdauer, das steuert, die lebensdauerrichtlinie für diese Instanz ab.(Geerbt von „MarshalByRefObject“.)

System_CAPS_protmethodGetParameterName(Int32)

Gibt den Namen des angegebenen Parameters in das Format des @p#. Verwenden Sie beim Erstellen eines benutzerdefinierten Befehls-Generators.

System_CAPS_protmethodGetParameterName(String)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Gibt den vollständigen Parameternamen, erhält der partielle Parameternamen angegeben.

System_CAPS_protmethodGetParameterPlaceholder(Int32)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Den Platzhalter für den Parameter zurückgegeben in der zugeordneten SQL-Anweisung.

System_CAPS_protmethodGetSchemaTable(DbCommand)

Gibt die Schematabelle für den DbCommandBuilder.

System_CAPS_protmethodGetService(Type)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.(Geerbt von „Component“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodGetUpdateCommand()

Ruft das automatisch generierte DbCommand Objekt, das zum Durchführen von Aktualisierungen in der Datenquelle erforderlich.

System_CAPS_pubmethodGetUpdateCommand(Boolean)

Ruft das automatisch generierte DbCommand Objekt zum Ausführen von Updates in der Datenquelle, die optional Spalten für Parameternamen verwenden.

System_CAPS_protmethodInitializeCommand(DbCommand)

Setzt die CommandTimeout, Transaction, CommandType, und UpdateRowSource Eigenschaften für die DbCommand.

System_CAPS_pubmethodInitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.(Geerbt von „MarshalByRefObject“.)

System_CAPS_protmethodMemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von „Object“.)

System_CAPS_protmethodMemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject Objekt.(Geerbt von „MarshalByRefObject“.)

System_CAPS_pubmethodQuoteIdentifier(String)

Bei einem Bezeichner ohne Anführungszeichen in der richtigen zurückgegeben die richtige Form des Bezeichners ordnungsgemäßen Escapezeichen für eingebetteten Anführungszeichen im Bezeichner.

System_CAPS_pubmethodRefreshSchema()

Löscht die Befehle, die zugeordneten DbCommandBuilder.

System_CAPS_protmethodRowUpdatingHandler(RowUpdatingEventArgs)

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

System_CAPS_protmethodSetRowUpdatingHandler(DbDataAdapter)

Registriert die DbCommandBuilder behandelt das RowUpdating -Ereignis für eine DbDataAdapter.

System_CAPS_pubmethodToString()

Gibt eine String mit dem Namen der Component, sofern vorhanden. Diese Methode darf nicht überschrieben werden.(Geerbt von „Component“.)

System_CAPS_pubmethodUnquoteIdentifier(String)

Ein Bezeichner in Anführungszeichen gibt die richtigen Form des Bezeichners ordnungsgemäß ohne Escapezeichen eingebetteten Anführungszeichen im Bezeichner zurück.

NameBeschreibung
System_CAPS_pubeventDisposed

Tritt auf, wenn die Komponente, durch einen Aufruf freigegeben wird der Dispose Methode.(Geerbt von „Component“.)

Die DbCommandBuilder Klasse wird bereitgestellt, der Einfachheit halber Anbieterwriter, die ihre eigenen Befehls-Generatoren erstellen. Durch Erben von dieser Klasse können Entwickler anbieterspezifisches Verhalten in ihrem eigenen Code implementieren.

Die DbDataAdapter wird nicht automatisch generiert die SQL-Anweisungen zum Abstimmen von Änderungen an einer DataSet mit der zugeordneten Datenquelle. Können jedoch ein DbCommandBuilder -Objekt zum automatischen Generieren von SQL-Anweisungen für einzelne Tabellen zu aktualisieren, wenn Sie festlegen der SelectCommand Eigenschaft der DbDataAdapter. Anschließend werden alle zusätzlichen SQL-Anweisungen, die Sie nicht festlegen, generiert, indem die DbCommandBuilder.

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

INSERT-, Update- oder DELETE-Anweisungen generieren der DbCommandBuilder verwendet die SelectCommand Eigenschaft, um einen bestimmten Satz von Metadaten automatisch abzurufen. Wenn Sie ändern die SelectCommand nach dem Abrufen der Metadaten (z. B. nach der ersten Aktualisierung) sollten Sie rufen die RefreshSchema Methode, um die Metadaten zu aktualisieren.

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

Die DbCommandBuilder verwendet auch die Connection, CommandTimeout, und Transaction Eigenschaften verwiesen wird, indem Sie die SelectCommand. Der Benutzer muss Aufrufen RefreshSchema wenn eine dieser Eigenschaften geändert oder die SelectCommand selbst ersetzt wird. Andernfalls die InsertCommand, UpdateCommand, und DeleteCommand Eigenschaften ihre vorherigen Werte beibehalten.

Wenn Sie aufrufen Dispose, die DbCommandBuilder aufgehoben ist der DbDataAdapter, und die generierten Befehle werden nicht mehr verwendet.

.NET Framework
Verfügbar seit 2.0

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: