Code-Beispiel

Verwendung des CommandBuilders zur Generierung von SQL-DML-Befehlen

Ein Beispiel zum Einsatz der Klasse System.Data.OleDb.OleDbCommandBuilder aus der .NET-Klassenbibliothek.

Autor: Dr. Holger Schwichtenberg

Beschreibung

In vielen Fällen reichen die vom OleDbCommandBuilder automatisch generierten SQL-DML-Befehle (UPDATE, INSERT und DELETE). Der OleCommandBuilder erwartet als Ausgangsbasis für seine Dienste ein OleDbDataAdapter-Objekt. Den dort abgelegten SQL-Befehl verwendet er als Grundlage für die Generierung der SQL-DML-Befehle. Die OleDbCommandBuilder-Klasse bietet mit GetInsertCommand(), GetUpdateCommand() und GetDeleteCommand() Zugriff auf die generierten SQL-Befehle. Alle drei Methoden liefern ein OleDbCommand-Objekt zurück, das in dem Attribut CommandText den jeweiligen SQL-Befehl enthält.

Es ist nicht möglich, die generierten SQL-Befehle direkt über den Datenadapter zu ermitteln. Ein OleDbDataAdapter-Objekt besitzt zwar Attribute mit Namen InsertCommand, UpdateCommand und DeleteCommand. Diese Attribute sind aber nur für die manuelle Zuweisung von Befehlen zu gebrauchen. Beim Einsatz eines CommandBuilders enthalten sie alle Nothing.

Beispiel
Das folgende Beispiel gibt die von einem OleDbCommandBuilder-Objekt für die Tabelle "Bestellungen" generierten SQL-DML-Befehle aus.

Beschränkungen
Sehr ärgerlich ist, dass der OleDbCommandBuilder zwei Beschränkungen unterliegt:
  • Er kann nur SQL-DML-Befehle für einzelne Tabellen erzeugen. Er verweigert die Unterstützung, wenn mehrere Tabellen an dem SQL-Befehl beteiligt sind.
  • Der CommandBuilder verweigert auch seine Mithilfe, wenn in den Feldnamen Leerzeichen oder andere nicht-alphanumerische Zeichen vorkommen.

Wenn dem CommandBuilder ein DataAdapter mit einem SQL-Befehl wie "SELECT * FROM Produkte, Bestellungen where Produkte.ID = Bestellungen.PID" überreicht wird, tritt er in den Streik: "Dynamic SQL generation is not supported against multiple base tables."

Programmcodebeispiele Visual Basic .NET (VB.NET)

' ============================
' .NET-Code-Beispiel in Visual Basic .NET
' Verwendung des CommandBuilders zur Generierung von SQL-DML-Befehlen
' (C) Holger@Schwichtenberg.de
' ============================
Sub ADONET_CommandBuilder()

Const FAKTOR As Single = 1.1
Const SQL As String = _
"SELECT * FROM Bestellungen"

' --- Nicht erlaubter SQL-String
' Const SQL As String = _
' "SELECT * FROM Produkte,
' Bestellungen where Produkte.ID = Bestellungen.PID"


Dim DA As System.Data.OleDb.OleDbDataAdapter
Dim CB As System.Data.OleDb.OleDbCommandBuilder

outtitle("Test des OLEDBCommandBuilder")

' --- Tabelle einlesen
DA = New OleDbDataAdapter(SQL, CONNSTRING)
CB = New OleDbCommandBuilder(DA)

out("SELECT-Befehl: " & SQL)
out("INSERT-Befehl: " & _
CB.GetInsertCommand.CommandText())
out("DELETE-Befehl: " & _
CB.GetDeleteCommand.CommandText())
out("UPDATE-Befehl: " & _
CB.GetUpdateCommand.CommandText())

End Sub

Programmcodebeispiele CSharp (C#)

using System;
using System.Data;
using System.Data.OleDb;

using FCL_Buch;

namespace FCLBuch._SystemData {

public class SamplesADONETDataSet {
public void ADONET_CommandBuilder() {

// Verwendung des CommandBuilder zur Generierung von sql-DML-Befehlen
string sql = "SELECT * FROM Bestellungen";

// Nicht erlaubter sql-String
// string sql As String = "SELECT * FROM Produkte, Bestellungen where Produkte.ID = Bestellungen.PID";
FclOutput.PrintOutSubHeader("Test des OLEDBCommandBuilder");

// Tabelle einlesen
OleDbDataAdapter da = new OleDbDataAdapter( sql, ADONET_Globals.ConnectionString );
OleDbCommandBuilder cb = new OleDbCommandBuilder( da );

// Ausgabe aus dem CommandBuilder-Objekt
FclOutput.PrintOut( "SELECT-Befehl: " + sql );
FclOutput.PrintOut( "INSERT-Befehl: " + cb.GetInsertCommand().CommandText );
FclOutput.PrintOut("DELETE-Befehl: " + cb.GetDeleteCommand().CommandText );
FclOutput.PrintOut("UPDATE-Befehl: " + cb.GetUpdateCommand().CommandText );
}
}
}

Hinweise

Ausgaben werden in den Beispielen durch Hilfsroutinen wie out() und PrintOut() erzeugt. Diese sind hier nicht angegeben, da deren Implementierung von der jeweiligen Umgebung abhängt. Für Konsolenanwendungen können hier z.B. Console.WriteLine() einsetzen.


 

Querverweise

 Liste aller Codebeispiele  Definition '.NET Framework Class Library'  Verfügbarkeit der Klasse 'System.Data.OleDb.OleDbCommandBuilder'  Übersicht über den FCL-Namensraum 'System.Data.OleDb'  .NET & Visual Studio Community Portal

Buchtipp

Buchcover PowerShell 7 und Windows PowerShell 5 – das Praxishandbuch (5. Auflage Oktober 2022 (9. Auflage Gesamtreihe)) PowerShell 7 und Windows PowerShell 5 – das Praxishandbuch
Autoren: Dr. Holger Schwichtenberg
erschienen 10/2022, 1426 Seiten
ISBN: 3446472967

Beratung & Support

Schulungen zu diesem Thema

 Visual Basic .NET - Aufbauwissen
 Grundlagen der objektorientierten Programmierung anhand von C# oder Visual Basic .NET
 Unit Testing / Testgetriebene Entwicklung / Test Driven Development (TDD) von .NET-Anwendungen (C# oder Visual Basic .NET)
 Visual Basic 6.0 (VB6.0)
 Objektorientierte Entwurfsmuster (Design-Pattern/Architektur-Pattern) mit .NET (C#, Visual Basic .NET)
 Visual Basic .NET - Basiswissen
 Windows Modern Apps/Windows Universal Apps entwickeln mit der Windows Runtime (WinRT), XAML und .NET/C#/Visual Basic
 Visual Basic Script (VBScript/VBS) - Sprachsyntax und Praxiseinsatz
 Word-Programmierung mit Visual Basic for Applications (VBA)
 Visual Studio Tools for Microsoft Office (VSTO) - Microsoft Office-Programmierung mit .NET und C# oder Visual Basic in Visual Studio
 Multi-Threading in .NET mit C#/Visual Basic .NET und/oder C++ und C++/CLI
 C# für Umsteiger von Visual Basic .NET
 Objektorientierte Programmierung (OOP) mit C#, Java, C++, Visual Basic.NET o.ä.
 Excel-Programmierung mit Visual Basic for Applications (VBA)
 Visual Basic .NET für Umsteiger von VBA/VB 4/5/6
 Visual Basic 2005 (Visual Basic 8.0)
 .NET und C# für Umsteiger von klassischem Visual Basic/COM
 Outlook-Programmierung mit Visual Basic for Applications (VBA)
 Das Component Object Model - für Script- und Visual Basic-Entwickler
 C#-Basiswissen (Grundlagen der Programmiersprache C#)
 .NET Akademie: Unit Testing und Test Driven Development (TDD) mit .NET/C# (3-Tages-Agenda des öffentlichen Seminars)
 Neuerungen in C# 7.0/7.1/7.2/7.3
 Task Parallel Library (TPL) - Parallelprogrammierung/Multi-Threading in .NET/C#
 Event Driven Design (mit .NET/C# oder Java)
 Neuerung in der CLR 2.0 und C# 2005
 Neuerungen in C# 6.0
 .NET Akademie: Blazor-Hands-On: Echte Single-Page-Web-Apps mit .NET und C# entwickeln (3-Tages-Agenda des öffentlichen Seminars)
 Neuerungen in C# 3.0 (Visual C# 2008)
 Refactoring von Programmcode in C, C++, C#, Java, Kotlin, JavaScript, TypeScript, Python, Go oder Rust
 Windows 8/Windows 8.1 für Entwickler: Programmierung mit der Windows Runtime (WinRT) - Erstellen von Windows Apps mit C#/XAML und/oder JavaScript/HTML
 Anfrage für eine individuelle Schulung zum Thema Visual Basic C#  Gesamter Schulungsthemenkatalog

Bücher zu diesem Thema

  Blazor 8.0: Moderne Webanwendungen und hybride Cross-Platform-Apps mit .NET 8.0, C# 12.0 und Visual Studio 2022
  C# 12.0 Crashkurs
  C# 11.0 Crashkurs
  C# 10.0 Crashkurs
  C# 9.0 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET 5.0, .NET Core und Xamarin
  ASP.NET Core Blazor 3.1/3.2: Blazor Server und Blazor Webassembly - Moderne Single-Page-Web-Applications mit .NET, C# und Visual Studio
  ASP.NET Core Blazor 3.0/3.1: Blazor Server und Blazor Webassembly - Moderne Single-Page-Web-Applications mit .NET, C# und Visual Studio
  C# 8.0 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin
  C# 7.3 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin
  Modern Data Access with Entity Framework Core: Database Programming Using .NET, .NET Core, UWP, and Xamarin with C#
  C# 7.2 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin
  Effizienter Datenzugriff mit Entity Framework Core: Datenbankprogrammierung mit C# für .NET Framework, .NET Core und Xamarin
  Windows Store Apps entwickeln mit C# und XAML - Crashkurs
  Microsoft ASP.NET 4.0 mit C# 2010 - Entwicklerbuch
  Microsoft Viusal C# 2010
  Visual Basic 2010: Grundlagen, ADO.NET, Windows Presentation Foundation
  ASP.NET 4.0 mit Visual C# 2010
  Visual Basic 2010
  Microsoft ASP.NET 3.5 mit Visual Basic 2008 - Entwicklerbuch
 Alle unsere aktuellen Fachbücher  E-Book-Abo für ab 99 Euro im Jahr