OdbcDataAdapter-Klasse
Stellt einen Satz von Datenbefehlen und eine Verbindung mit einer Datenquelle dar, die zum Füllen des DataSet und zum Aktualisieren der Datenquelle verwendet werden. Die Klasse kann nicht geerbt werden.
Namespace: System.Data.Odbc
Assembly: System.Data (in system.data.dll)
Syntax
'Declaration
Public NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements IDbDataAdapter, IDataAdapter, ICloneable
'Usage
Dim instance As OdbcDataAdapter
public sealed class OdbcDataAdapter : DbDataAdapter, IDbDataAdapter, IDataAdapter, ICloneable
public ref class OdbcDataAdapter sealed : public DbDataAdapter, IDbDataAdapter, IDataAdapter, ICloneable
public final class OdbcDataAdapter extends DbDataAdapter implements IDbDataAdapter, IDataAdapter,
ICloneable
public final class OdbcDataAdapter extends DbDataAdapter implements IDbDataAdapter, IDataAdapter,
ICloneable
Hinweise
Der OdbcDataAdapter bildet eine Verbindung zwischen einem DataSet und einer Datenquelle, über die Daten abgerufen und gespeichert werden. Der OdbcDataAdapter stellt diese Verbindung bereit, indem er mit Fill Daten aus der Datenquelle in das DataSet lädt und im DataSet vorgenommene Änderungen mit Update zurück an die Datenquelle sendet.
Wenn der OdbcDataAdapter ein DataSet füllt, erstellt er die für die zurückgegebenen Daten erforderlichen Tabellen und Spalten, sofern diese nicht bereits vorhanden sind. Primärschlüsselinformationen sind jedoch im implizit erstellten Schema nur enthalten, wenn die MissingSchemaAction-Eigenschaft auf AddWithKey festgelegt ist. Das Schema von DataSet kann, einschließlich Primärschlüsselinformationen, auch durch den OdbcDataAdapter erstellt werden, bevor es unter Verwendung von FillSchema mit Daten gefüllt wird. Weitere Informationen finden Sie unter Hinzufügen vorhandener Einschränkungen zu einem DataSet.
Hinweis
Beim Aufrufen der Fill-Methode für eine Datenquelle ohne Primärschlüsselspalte versucht der OdbcDataAdapter, die Spalte für die Unique-Einschränkung auf Primärschlüssel höher zu stufen. Bei diesem Vorgang markiert der OdbcDataAdapter die Unique-Einschränkung als Einschränkung, die keine NULL-Werte zulässt. Dieses Verhalten funktioniert, es sei denn, in der Spalte für die Unique-Einschränkung ist ein NULL-Wert enthalten. Wenn ein NULL-Wert vorhanden ist, schlägt die Fill-Methode mit einer Einschränkungsverletzung fehl. Lassen Sie in der Spalte für die Unique-Einschränkung keine NULL-Werte zu, um eine solche Situation zu vermeiden.
Hinweis
Aufgrund der Einschränkungen von systemeigenen ODBC-Treibern wird beim Aufruf von FillSchema immer nur eine DataTable zurückgegeben. Dies gilt selbst für die Ausführung von SQL-Batchanweisungen, bei denen mehrere DataTable-Objekte erwartet werden.
Der OdbcDataAdapter enthält außerdem die Eigenschaften SelectCommand, InsertCommand, DeleteCommand, UpdateCommand und TableMappings, um das Laden und Aktualisieren von Daten zu ermöglichen.
Beispiel
Im folgenden Beispiel werden OdbcCommand, OdbcDataAdapter und OdbcConnection zum Auswählen von Datensätzen und zum Auffüllen eines DataSet mit den ausgewählten Zeilen verwendet.
Public Function GetDataSetFromAdapter( _
ByVal dataSet As DataSet, ByVal connectionString As String, _
ByVal queryString As String) As DataSet
Using connection As New OdbcConnection(connectionString)
Dim adapter As New OdbcDataAdapter(queryString, connection)
' Open the connection and fill the DataSet.
Try
connection.Open()
adapter.Fill(dataSet)
Catch ex As Exception
Console.WriteLine(ex.Message)
End Try
' The connection is automatically closed when the
' code exits the Using block.
End Using
Return dataSet
End Function
public DataSet GetDataSetFromAdapter(
DataSet dataSet, string connectionString, string queryString)
{
using (OdbcConnection connection =
new OdbcConnection(connectionString))
{
OdbcDataAdapter adapter =
new OdbcDataAdapter(queryString, connection);
// Open the connection and fill the DataSet.
try
{
connection.Open();
adapter.Fill(dataSet);
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
// The connection is automatically closed when the
// code exits the using block.
}
return dataSet;
}
Vererbungshierarchie
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Data.Common.DataAdapter
System.Data.Common.DbDataAdapter
System.Data.Odbc.OdbcDataAdapter
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
OdbcDataAdapter-Member
System.Data.Odbc-Namespace