OdbcCommandBuilder-Klasse
Generiert automatisch Befehle für einzelne Tabellen, durch die an einem DataSet vorgenommene Änderungen mit der zugeordneten Datenquelle abgeglichen werden. Die Klasse kann nicht vererbt werden.
Namespace: System.Data.Odbc
Assembly: System.Data (in system.data.dll)
Syntax
'Declaration
Public NotInheritable Class OdbcCommandBuilder
Inherits DbCommandBuilder
'Usage
Dim instance As OdbcCommandBuilder
public sealed class OdbcCommandBuilder : DbCommandBuilder
public ref class OdbcCommandBuilder sealed : public DbCommandBuilder
public final class OdbcCommandBuilder extends DbCommandBuilder
public final class OdbcCommandBuilder extends DbCommandBuilder
Hinweise
OdbcDataAdapter generiert nicht automatisch die SQL-Anweisungen, die für den Abgleich von Änderungen an einem der Datenquelle zugeordneten DataSet erforderlich sind. Sie können jedoch ein OdbcCommandBuilder-Objekt erstellen, das SQL-Anweisungen für das Aktualisieren einzelner Tabellen generiert. Dazu legen Sie die SelectCommand-Eigenschaft von OdbcDataAdapter fest. Anschließend generiert der OdbcCommandBuilder zusätzliche, nicht vom Benutzer festgelegte SQL-Anweisungen.
Die Beziehung zwischen einem OdbcDataAdapter und seinem entsprechenden OdbcCommandBuilder ist stets eine 1:1-Beziehung. Legen Sie die OdbcDataAdapter-Eigenschaft des OdbcCommandBuilder-Objekts fest, um diese Zuordnung zu erstellen. Dadurch registriert der OdbcCommandBuilder sich selbst als Listener, und es werden RowUpdating-Ereignisse ausgegeben, die das DataSet betreffen.
Zum Generieren von INSERT-Anweisungen, UPDATE-Anweisungen und DELETE-Anweisungen verwendet OdbcCommandBuilder die SelectCommand-Eigenschaft, um einen erforderlichen Satz von Metadaten abzurufen. Wenn Sie den Wert von SelectCommand nach dem Abrufen der Metadaten ändern (z. B. nach der ersten Aktualisierung), müssen Sie anschließend die RefreshSchema-Methode aufrufen, um die Metadaten zu aktualisieren.
Hinweis
Wenn in der SELECT-Anweisung, die der SelectCommand-Eigenschaft zugewiesen ist, Aliasspaltennamen verwendet werden, können die sich ergebenden Anweisungen INSERT, UPDATE und DELETE ungenau oder fehlerhaft sein. Wenn der zugrunde liegende ODBC-Treiber nicht den entsprechenden Basisspaltennamen für den Aliasspaltennamen bereitstellen kann (anhand des SQL_DESC_BASE_COLUMN_NAME-Werts von SQLColAttribute), wird der Aliasname möglicherweise in den generierten INSERT-Anweisungen, UPDATE-Anweisungen und DELETE-Anweisungen verwendet. Beispielsweise gibt der Microsoft ODBC-Treiber für Oracle als Basisspaltennamen den Aliasnamen zurück. Deshalb würden die generierten Anweisungen INSERT, UPDATE und DELETE zu Fehlern führen.
Der OdbcCommandBuilder verwendet auch die Eigenschaften Connection, CommandTimeout und Transaction, auf die durch SelectCommand verwiesen wird. Die Benutzer müssen RefreshSchema aufrufen, wenn eine bzw. mehrere dieser Eigenschaften oder der Wert der SelectCommand-Eigenschaft selbst geändert werden. Andernfalls behalten die Eigenschaften InsertCommand, UpdateCommand und DeleteCommand ihre vorherigen Werte bei.
Wenn Sie Dispose aufrufen, wird die Zuordnung von OdbcCommandBuilder zu OdbcDataAdapter aufgehoben, und die generierten Befehle werden nicht mehr verwendet.
Beispiel
Im folgenden Beispiel wird OdbcCommand zusammen mit OdbcDataAdapter und OdbcConnection zum Auswählen von Zeilen aus einer Datenquelle verwendet. Im Beispiel werden ein initialisiertes DataSet, eine Verbindungszeichenfolge, eine SQL-SELECT-Anweisung als Abfragezeichenfolge sowie eine Zeichenfolge mit dem Namen der Datenquelltabelle übergeben. Anschließend wird im Beispiel ein OdbcCommandBuilder erstellt.
Public Function SelectOdbcSrvRows( _
ByVal connectionString As String, ByVal queryString As String, _
ByVal tableName As String) As DataSet
Dim dataSet As DataSet = New DataSet
Using connection As New OdbcConnection(connectionString)
Dim adapter As New OdbcDataAdapter()
adapter.SelectCommand = _
New OdbcCommand(queryString, connection)
Dim builder As OdbcCommandBuilder = _
New OdbcCommandBuilder(adapter)
connection.Open()
adapter.Fill(dataSet, tableName)
' Code to modify data in DataSet here
' Without the OdbcCommandBuilder this line would fail.
adapter.Update(dataSet, tableName)
End Using
Return dataSet
End Function
public static DataSet SelectOdbcSrvRows(string connectionString,
string queryString, string tableName)
{
DataSet dataSet = new DataSet();
using (OdbcConnection connection = new OdbcConnection(connectionString))
{
OdbcDataAdapter adapter = new OdbcDataAdapter();
adapter.SelectCommand =
new OdbcCommand(queryString, connection);
OdbcCommandBuilder builder =
new OdbcCommandBuilder(adapter);
connection.Open();
adapter.Fill(dataSet, tableName);
//code to modify data in DataSet here
//Without the OdbcCommandBuilder this line would fail
adapter.Update(dataSet, tableName);
}
return dataSet;
}
Vererbungshierarchie
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Data.Common.DbCommandBuilder
System.Data.Odbc.OdbcCommandBuilder
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1
Siehe auch
Referenz
OdbcCommandBuilder-Member
System.Data.Odbc-Namespace