(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

DbCommandBuilder-Klasse

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.

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

public abstract class DbCommandBuilder : Component

Der DbCommandBuilder-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Geschützte MethodeUnterstützt von XNA FrameworkDbCommandBuilderInitialisiert eine neue Instanz einer Klasse, die von der DbCommandBuilder-Klasse erbt.
Zum Seitenanfang

  NameBeschreibung
Geschützte EigenschaftCanRaiseEventsRuft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Von Component geerbt.)
Öffentliche EigenschaftUnterstützt von XNA FrameworkCatalogLocationLegt die CatalogLocation für eine Instanz der DbCommandBuilder-Klasse fest oder ruft diese ab.
Öffentliche EigenschaftUnterstützt von XNA FrameworkCatalogSeparatorLegt eine Zeichenfolge als Katalogtrennzeichen für eine Instanz der DbCommandBuilder-Klasse fest oder ruft diese ab.
Öffentliche EigenschaftUnterstützt von XNA FrameworkConflictOptionGibt an, welche ConflictOption vom DbCommandBuilder verwendet werden muss.
Öffentliche EigenschaftContainerRuft den IContainer ab, der die Component enthält. (Von Component geerbt.)
Öffentliche EigenschaftUnterstützt von XNA FrameworkDataAdapterRuft ein DbDataAdapter-Objekt ab, für das automatisch Transact-SQL-Anweisungen generiert werden, oder legt dieses fest.
Geschützte EigenschaftDesignModeRuft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet. (Von Component geerbt.)
Geschützte EigenschaftUnterstützt von XNA FrameworkEventsRuft die Liste der Ereignishandler ab, die dieser Component angefügt sind. (Von Component geerbt.)
Öffentliche EigenschaftUnterstützt von XNA FrameworkQuotePrefixRuft 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.
Öffentliche EigenschaftUnterstützt von XNA FrameworkQuoteSuffixRuft 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.
Öffentliche EigenschaftUnterstützt von XNA FrameworkSchemaSeparatorRuft das als Trennzeichen zwischen dem Schemabezeichner und anderen Bezeichnern zu verwendende Zeichen ab oder legt dieses fest.
Öffentliche EigenschaftUnterstützt von XNA FrameworkSetAllValuesGibt an, ob alle Spaltenwerte oder nur die geänderten in einer Aktualisierungsanweisung eingeschlossen sind.
Öffentliche EigenschaftUnterstützt von XNA FrameworkSiteRuft die ISite der Component ab oder legt diese fest. (Von Component geerbt.)
Zum Seitenanfang

  NameBeschreibung
Geschützte MethodeUnterstützt von XNA FrameworkApplyParameterInfoErmöglicht es der Anbieterimplementierung der DbCommandBuilder-Klasse, zusätzliche Parametereigenschaften zu behandeln.
Öffentliche MethodeCreateObjRefErstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Von MarshalByRefObject geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkDispose() Gibt alle von Component verwendeten Ressourcen frei. (Von Component geerbt.)
Geschützte MethodeUnterstützt von XNA FrameworkDispose(Boolean)Gibt die von DbCommandBuilder verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Überschreibt Component.Dispose(Boolean).)
Öffentliche MethodeUnterstützt von XNA FrameworkEquals(Object)Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
Geschützte MethodeUnterstützt von XNA FrameworkFinalize Gibt nicht verwaltete Ressourcen frei und führt andere Bereinigungsvorgänge durch, bevor die Component durch den Garbage Collector entfernt wird. (Von Component geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkGetDeleteCommand()Ruft das automatisch generierte DbCommand-Objekt ab, das zum Ausführen von Löschvorgängen in der Datenquelle erforderlich ist.
Öffentliche MethodeUnterstützt von XNA FrameworkGetDeleteCommand(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.
Öffentliche MethodeUnterstützt von XNA FrameworkGetHashCodeFungiert als die Standardhashfunktion. (Von Object geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkGetInsertCommand()Ruft das automatisch generierte DbCommand-Objekt ab, das zum Ausführen von Einfügevorgängen in der Datenquelle erforderlich ist.
Öffentliche MethodeUnterstützt von XNA FrameworkGetInsertCommand(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.
Öffentliche MethodeGetLifetimeServiceRuft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Von MarshalByRefObject geerbt.)
Geschützte MethodeUnterstützt von XNA FrameworkGetParameterName(Int32)Gibt den Namen des angegebenen Parameters im Format @ p# zurück. Verwenden Sie diesen zum Erstellen eines benutzerdefinierten Befehls-Generators.
Geschützte MethodeUnterstützt von XNA FrameworkGetParameterName(String)Infrastruktur. Gibt den vollständigen Parameternamen zurück, wenn der partielle Parameternamen angegeben ist.
Geschützte MethodeUnterstützt von XNA FrameworkGetParameterPlaceholderInfrastruktur. Gibt den Platzhalter für den Parameter in der zugeordneten SQL-Anweisung zurück.
Geschützte MethodeUnterstützt von XNA FrameworkGetSchemaTableGibt die Schematabelle für den DbCommandBuilder zurück.
Geschützte MethodeGetServiceGibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt. (Von Component geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkGetUpdateCommand()Ruft das automatisch generierte DbCommand-Objekt ab, das zum Ausführen von Aktualisierungen in der Datenquelle erforderlich ist.
Öffentliche MethodeUnterstützt von XNA FrameworkGetUpdateCommand(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.
Geschützte MethodeUnterstützt von XNA FrameworkInitializeCommandLegt die Eigenschaften CommandTimeout, Transaction, CommandType und UpdateRowSource für DbCommand erneut fest.
Öffentliche MethodeInitializeLifetimeServiceRuft ein Lebensdauerdienstobjekt ab, mit dem die Lebensdauerrichtlinien für diese Instanz gesteuert werden können. (Von MarshalByRefObject geerbt.)
Geschützte MethodeUnterstützt von XNA FrameworkMemberwiseClone()Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Geschützte MethodeMemberwiseClone(Boolean)Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Von MarshalByRefObject geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkQuoteIdentifierBei 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.
Öffentliche MethodeUnterstützt von XNA FrameworkRefreshSchemaLöscht die diesem DbCommandBuilder zugeordneten Befehle.
Geschützte MethodeUnterstützt von XNA FrameworkRowUpdatingHandlerFügt einen Ereignishandler für das RowUpdating-Ereignis hinzu.
Geschützte MethodeUnterstützt von XNA FrameworkSetRowUpdatingHandlerRegistriert den DbCommandBuilder zum Behandeln des RowUpdating-Ereignisses für einen DbDataAdapter.
Öffentliche MethodeUnterstützt von XNA FrameworkToString Gibt einen String zurück, der den Namen dieser Componente enthält, sofern vorhanden. Diese Methode sollte nicht überschrieben werden. (Von Component geerbt.)

In XNA Framework 3.0 wird dieser Member von Object geerbt..ToString().
Öffentliche MethodeUnterstützt von XNA FrameworkUnquoteIdentifierBei 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.
Zum Seitenanfang

  NameBeschreibung
Öffentliches EreignisUnterstützt von XNA FrameworkDisposed Wird ausgelöst, wenn die Komponente durch einen Aufruf der Dispose-Methode freigegeben wird. (Von Component geerbt.)
Zum Seitenanfang

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

DbDataAdapter generiert nicht automatisch die SQL-Anweisungen, die für den Abgleich von Änderungen an einem DataSet mit der zugeordneten Datenquelle erforderlich sind. Sie können jedoch ein DbCommandBuilder-Objekt erstellen, um SQL-Anweisungen für das Aktualisieren einzelner Tabellen automatisch zu generieren, indem Sie die SelectCommand-Eigenschaft von DbDataAdapter festlegen. Anschließend werden alle zusätzlichen, von Ihnen nicht festgelegten SQL-Anweisungen vom DbCommandBuilder generiert.

Der DbCommandBuilder registriert sich selbst als ein Listener für RowUpdating-Ereignisse, wenn Sie die DataAdapter-Eigenschaft festlegen. Einem DbDataAdapter-Objekt kann immer nur ein DbCommandBuilder-Objekt gleichzeitig zugeordnet werden und umgekehrt.

Zum Generieren der Anweisungen INSERT, UPDATE und DELETE verwendet der DbCommandBuilder die SelectCommand-Eigenschaft, um einen erforderlichen Satz von Metadaten automatisch abzurufen. Wenn Sie SelectCommand nach dem Abrufen der Metadaten ändern (z. B. nach der ersten Aktualisierung), müssen Sie die RefreshSchema-Methode aufrufen, um die Metadaten zu aktualisieren.

SelectCommand muss also mindestens einen Primärschlüssel oder eine eindeutige Spalte zurückgeben. Wenn dies nicht der Fall ist, wird eine InvalidOperationException-Ausnahme generiert, aber nicht die Befehle.

Der DbCommandBuilder verwendet auch die Eigenschaften Connection, CommandTimeout und Transaction, auf die durch SelectCommand verwiesen wird. Der Benutzer muss RefreshSchema aufrufen, wenn eine dieser Eigenschaften geändert oder SelectCommand selbst ersetzt wird. Andernfalls behalten die Eigenschaften InsertCommand, UpdateCommand und DeleteCommand ihre vorherigen Werte bei.

Wenn Sie die Dispose-Methode aufrufen, wird die Zuordnung der DbCommandBuilder-Klasse zur DbDataAdapter-Klasse aufgehoben, und die generierten Befehle werden nicht mehr verwendet.

.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Es werden nicht alle Versionen sämtlicher Plattformen von .NET Framework unterstützt.. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft