Generiert automatisch Befehle für einzelne Tabellen, mit denen Änderungen in einem System.Data.DataSet-Objekt mit der zugeordneten Datenbank abgeglichen werden

Syntax

Visual Basic
Public Class ULCommandBuilder
  Inherits DbCommandBuilder

C#
public class ULCommandBuilder: DbCommandBuilder

Bemerkungen

Das ULDataAdapter-Objekt generiert nicht automatisch die SQL-Anweisungen, die erforderlich sind, um Änderungen eines System.Data.DataSet-Objekts mit der zugeordneten Datenquelle abzugleichen. Sie können jedoch ein ULCommandBuilder-Objekt erstellen, um automatisch SQL-Anweisungen für Aktualisierungen einzelner Tabellen zu generieren, wenn Sie die SelectCommand-Eigenschaft des ULDataAdapter-Objekts festlegen. Danach werden etwaige SQL-Anweisungen, die Sie nicht definiert haben, vom ULCommandBuilder-Objekt generiert.

Erbt: System.ComponentModel.Component

Implementiert: System.IDisposable

Beispiel

Das folgende Beispiel verwendet das ULCommand-Objekt zusammen mit ULDataAdapter und ULConnection, um Zeilen aus einer Datenquelle auszuwählen. Das Beispiel wird einer Verbindungszeichenfolge übergeben, bei der es sich um eine Abfragenzeichenfolge mit einer SQL SELECT-Anweisung und eine Zeichenfolge mit dem Namen der Datenbanktabelle handelt. Das Beispiel erstellt dann ein ULCommandBuilder-Objekt.

' Visual Basic
Public Shared Function SelectULRows(ByVal connectionString As String, _
    ByVal queryString As String, ByVal tableName As String)

    Dim connection As ULConnection = New ULConnection(connectionString)
    Dim adapter As ULDataAdapter = New ULDataAdapter()

       adapter.SelectCommand = New ULCommand(queryString, connection)

       Dim builder As ULCommandBuilder = New ULCommandBuilder(adapter)

    connection.Open()

    Dim dataSet As DataSet = New DataSet()
    adapter.Fill(dataSet, tableName)

    'code to modify data in DataSet here

    'Without the ULCommandBuilder this line would fail
    adapter.Update(dataSet, tableName)

    Return dataSet

End Function

// C#
public static DataSet SelectULRows(string connectionString,
    string queryString, string tableName)
{
    using (ULConnection connection = new ULConnection(connectionString))
    {
        ULDataAdapter adapter = new ULDataAdapter();
        adapter.SelectCommand = new ULCommand(queryString, connection);
        ULCommandBuilder builder = new ULCommandBuilder(adapter);

        connection.Open();

        DataSet dataSet = new DataSet();
        adapter.Fill(dataSet, tableName);

           //code to modify data in DataSet here

        //Without the ULCommandBuilder this line would fail
        adapter.Update(dataSet, tableName);

        return dataSet;
    }
}

Siehe auch

• ULCommandBuilder-Mitglieder
•  DataSet
• ULDataAdapter-Klasse
•  Component
•  IDisposable
• ULCommand-Klasse
• ULConnection-Klasse