Auffüllen eines "DataSets" durch einen "DataAdapter"

Das ADO.NET-DataSet ist eine speicherresidente Datendarstellung, das ein konsistentes relationales und von der Datenquelle unabhängiges Programmiermodell bereitstellt. Das DataSet stellt eine vollständige Datengruppe einschließlich Tabellen, Einschränkungen und Beziehungen zwischen Tabellen dar. Da das DataSet von der Datenquelle unabhängig ist, kann ein DataSet sowohl lokale Daten einer Anwendung als auch Daten aus mehreren Datenquellen enthalten. Die Interaktion mit vorhandenen Datenquellen wird über den DataAdaptergesteuert.

Die SelectCommand -Eigenschaft des DataAdapter ist ein Command -Objekt, das Daten aus der Datenquelle abruft. Die InsertCommand-Eigenschaft, die UpdateCommand-Eigenschaft und die DeleteCommand -Eigenschaft des DataAdapter sind Command -Objekte, die Updates an den Daten in der Datenquelle entsprechend den Modifikationen an den Daten im DataSetverwalten. Diese Eigenschaften werden in der Aktualisierung von Datenquellen mit DataAdapters ausführlicher behandelt.

Mithilfe der Fill -Methode des DataAdapter wird ein DataSet mit den Ergebnissen vom SelectCommand des DataAdapteraufgefüllt. Fill verwendet als Argumente ein aufzufüllendes DataSet sowie ein DataTable -Objekt bzw. den Namen der DataTable , die mit den Zeilen gefüllt werden soll, die vom SelectCommandzurückgegeben werden.

Die Fill -Methode verwendet das DataReader -Objekt implizit, um die Spaltennamen und Spaltentypen zurückzugeben, mit denen die Tabellen im DataSeterstellt werden, sowie die Daten zum Füllen der Tabellenzeilen im DataSet. Tabellen und Spalten werden nur erstellt, wenn sie noch nicht vorhanden sind. Andernfalls verwendet die Fill -Methode das vorhandene DataSet -Schema. Spaltentypen werden als .NET Framework-Typen gemäß den Tabellen unter Datentypzuordnungen in ADO.NET erstellt. Primärschlüssel werden nur erstellt, wenn diese in der Datenquelle vorhanden sind und DataAdapter.MissingSchemaAction auf MissingSchemaAction.AddWithKey festgelegt ist. Wenn die Fill -Methode ermittelt, dass ein Primärschlüssel für eine Tabelle vorhanden ist, werden Daten im DataSet mit den Daten aus der Datenquelle überschrieben. Dies gilt für Zeilen, deren Werte in der Primärschlüsselspalte mit denen der Zeile übereinstimmen, die von der Datenquelle zurückgegeben wurde. Wurde kein Primärschlüssel gefunden, so werden die Daten an die Tabellen im DataSetangehängt. Fill verwendet alle Zuordnungen, die vorhanden sein können, wenn DataSet aufgefüllt werden (siehe DataAdapter-DataTable- und DataColumn-Zuordnungen).

Im folgenden Codebeispiel wird eine Instanz eines SqlDataAdapter erstellt, die eine SqlConnection zur Microsoft SQL Server-Datenbank Northwind verwendet und eine DataTable in einem DataSet mit der Kundenliste füllt. Mit der SQL-Anweisung und den SqlConnection -Argumenten, die an den SqlDataAdapter -Konstruktor übergeben werden, wird die SelectCommand -Eigenschaft des SqlDataAdaptererstellt.

Beispiel

' Assumes that connection is a valid SqlConnection object.  
Dim queryString As String = _  
  "SELECT CustomerID, CompanyName FROM dbo.Customers"  
Dim adapter As SqlDataAdapter = New SqlDataAdapter( _  
  queryString, connection)  
  
Dim customers As DataSet = New DataSet  
adapter.Fill(customers, "Customers")  

// Assumes that connection is a valid SqlConnection object.  
string queryString =
  "SELECT CustomerID, CompanyName FROM dbo.Customers";  
SqlDataAdapter adapter = new SqlDataAdapter(queryString, connection);  
  
DataSet customers = new DataSet();  
adapter.Fill(customers, "Customers");  

Mehrere Ergebnissätze

Wenn der DataAdapter mehrere Resultsets ermittelt, werden mehrere Tabellen im DataSeterstellt. Diesen Tabellen werden standardmäßig Namen nach dem Schema TableN, beginnend mit "Table" für Table0, zugewiesen, die jeweils um eins erhöht werden. Wenn der Tabellenname als Argument an die Fill -Methode übergeben wird, erhalten die Tabellen standardmäßig Namen nach dem Schema TableNameN, beginnend mit "TableName" für TableName0, die jeweils um eins erhöht werden.

Auffüllen eines DataSets mit mehreren DataAdapter-Objekten

Eine DataAdapter-Klasse kann mit einer beliebigen Anzahl von DataSet-Objekten verwendet werden. Mit jedem DataAdapter -Objekt können ein oder mehrere DataTable -Objekte gefüllt und Updates in die zugehörige Datenquelle übernommen werden. DasDataRelation -Objekt und das Constraint -Objekt können dem DataSet lokal hinzugefügt werden. Dadurch haben Sie die Möglichkeit, Daten aus mehreren unähnlichen Datenquellen zu verbinden. Zum Beispiel kann ein DataSet Daten aus einer Microsoft SQL Server-Datenbank, einer IBM DB2-Datenbank, die über OLE DB bereitgestellt wird, und einer Datenquelle, die XML streamt, enthalten. Für die Kommunikation mit den einzelnen Datenquellen sind ein oder mehrere DataAdapter -Objekte zuständig.

Beispiel

Im folgenden Codebeispiel wird eine Liste von Kunden aus der Northwind-Datenbank auf Microsoft SQL Server gefüllt, und eine Liste von Bestellungen wird aus der Northwind-Datenbank bezogen, die in Microsoft Access 2000 gespeichert ist. Die gefüllten Tabellen werden mit einer DataRelationverbunden, und die Kundenliste wird anschließend mit Aufträgen für den jeweiligen Kunden angezeigt. Weitere Informationen zu DataRelation Objekten finden Sie unter Hinzufügen von DataRelations und Navigieren in DataRelations.

' Assumes that customerConnection is a valid SqlConnection object.  
' Assumes that orderConnection is a valid OleDbConnection object.  
Dim custAdapter As SqlDataAdapter = New SqlDataAdapter( _  
  "SELECT * FROM dbo.Customers", customerConnection)  
  
Dim ordAdapter As OleDbDataAdapter = New OleDbDataAdapter( _  
  "SELECT * FROM Orders", orderConnection)  
  
Dim customerOrders As DataSet = New DataSet()  
custAdapter.Fill(customerOrders, "Customers")  
ordAdapter.Fill(customerOrders, "Orders")  
  
Dim relation As DataRelation = _  
  customerOrders.Relations.Add("CustOrders", _  
  customerOrders.Tables("Customers").Columns("CustomerID"), _
  customerOrders.Tables("Orders").Columns("CustomerID"))  
  
Dim pRow, cRow As DataRow  
For Each pRow In customerOrders.Tables("Customers").Rows  
  Console.WriteLine(pRow("CustomerID").ToString())  
  
  For Each cRow In pRow.GetChildRows(relation)  
    Console.WriteLine(vbTab & cRow("OrderID").ToString())  
  Next  
Next  

// Assumes that customerConnection is a valid SqlConnection object.  
// Assumes that orderConnection is a valid OleDbConnection object.  
SqlDataAdapter custAdapter = new SqlDataAdapter(  
  "SELECT * FROM dbo.Customers", customerConnection);  
OleDbDataAdapter ordAdapter = new OleDbDataAdapter(  
  "SELECT * FROM Orders", orderConnection);  
  
DataSet customerOrders = new DataSet();  
  
custAdapter.Fill(customerOrders, "Customers");  
ordAdapter.Fill(customerOrders, "Orders");  
  
DataRelation relation = customerOrders.Relations.Add("CustOrders",  
  customerOrders.Tables["Customers"].Columns["CustomerID"],  
  customerOrders.Tables["Orders"].Columns["CustomerID"]);  
  
foreach (DataRow pRow in customerOrders.Tables["Customers"].Rows)  
{  
  Console.WriteLine(pRow["CustomerID"]);  
   foreach (DataRow cRow in pRow.GetChildRows(relation))  
    Console.WriteLine("\t" + cRow["OrderID"]);  
}  

SQL Server-Dezimaltyp

Standardmäßig werden die DataSet Daten mithilfe von .NET Framework-Datentypen gespeichert. Für die meisten Anwendungen sind diese sehr gut zur Darstellung der Informationen aus der Datenquelle geeignet. Diese Darstellung kann jedoch problematisch werden, wenn es sich bei dem Datentyp in der Datenquelle um den SQL Server-Datentyp „decimal“ oder um einen numerischen Datentyp handelt. Der .NET Framework-Datentyp decimal ermöglicht maximal 28 signifikante Ziffern, während der SQL Server-Datentyp decimal 38 signifikante Ziffern zulässt. Wenn der SqlDataAdapter während eines Fill -Vorgangs feststellt, dass die Präzision eines SQL Server-Felds mit dem Datentyp decimal mehr als 28 Zeichen beträgt, wird der DataTabledie aktuelle Zeile nicht hinzugefügt. Stattdessen tritt das FillError -Ereignis auf. Dadurch können Sie überprüfen, ob ein Präzisionsverlust eintritt, und Sie können entsprechend reagieren. Weitere Informationen zum FillError Ereignis finden Sie unter Behandeln von DataAdapter-Ereignissen. Den SQL Server-Wert decimal erhalten Sie auch, indem Sie ein SqlDataReader -Objekt verwenden und die GetSqlDecimal -Methode aufrufen.

ADO.NET 2.0 führte eine erweiterte Unterstützung für System.Data.SqlTypes in der DataSet ein. Weitere Informationen finden Sie unter SqlTypes and the DataSet.

OLE DB-Kapitel

Hierarchische Rowsets oder Kapitel (OLE DB-Typ DBTYPE_HCHAPTER, ADO-Typ adChapter) können verwendet werden, um den Inhalt eines DataSet zu füllen. Wenn das OleDbDataAdapter -Objekt während eines Fill -Vorgangs eine in Kapitel unterteilte Spalte ermittelt, wird für diese Spalte eine DataTable erstellt, die mit den Spalten und Zeilen aus dem Kapitel gefüllt wird. Die für die kapitelierte Spalte erstellte Tabelle wird sowohl mit dem übergeordneten Tabellennamen als auch mit dem Kapitelspaltennamen im Format "ParentTableNameChapteredColumnName" benannt. Wenn im DataSet bereits eine Tabelle vorhanden ist, deren Name dem Namen der in Kapitel unterteilten Spalte entspricht, wird die aktuelle Tabelle mit den Kapiteldaten gefüllt. Wenn in einer vorhandenen Tabelle keine Spalte vorhanden ist, die einer im Kapitel gefundenen Spalte entspricht, wird eine neue Spalte hinzugefügt.

Bevor die Tabellen im DataSet mit den Daten in den in Kapitel unterteilten Spalten gefüllt werden, wird eine Beziehung zwischen der übergeordneten und der untergeordneten Tabelle des hierarchischen Rowsets erstellt, indem sowohl der übergeordneten als auch der untergeordneten Tabelle eine Ganzzahlenspalte hinzugefügt wird. Für die übergeordnete Spalte wird die automatische Erhöhung festgelegt, und mit den hinzugefügten Spalten beider Tabellen wird eine DataRelation erstellt. Die hinzugefügte Beziehung wird mithilfe der übergeordneten Tabellen- und Kapitelspaltennamen im Format "ParentTableNameChapterColumnName" benannt.

Beachten Sie, dass die entsprechende Spalte nur im DataSetvorhanden ist. Nachfolgende Füllungen aus der Datenquelle können dazu führen, dass neue Zeilen an die Tabellen angefügt werden, anstatt dass Änderungen in vorhandenen Zeilen zusammengeführt werden.

Beachten Sie auch, dass bei Verwendung der DataAdapter.Fill -Überladung mit einer DataTablenur diese Tabelle gefüllt wird. Eine Ganzzahlenspalte mit automatischer Erhöhung wird der Tabelle ebenfalls hinzugefügt, es wird jedoch keine untergeordnete Tabelle erstellt oder gefüllt und keine Beziehung erstellt.

Im folgenden Beispiel wird der MSDataShape-Anbieter verwendet, um eine Kapitelspalte mit Bestellungen für jeden Kunden in einer Kundenliste zu generieren. Anschließend wird ein DataSet mit den Daten gefüllt.

Using connection As OleDbConnection = New OleDbConnection( _  
  "Provider=MSDataShape;Data Provider=SQLOLEDB;" & _  
  "Data Source=(local);Integrated " & _  
  "Security=SSPI;Initial Catalog=northwind")  
  
Dim adapter As OleDbDataAdapter = New OleDbDataAdapter( _  
  "SHAPE {SELECT CustomerID, CompanyName FROM Customers} " & _  
  "APPEND ({SELECT CustomerID, OrderID FROM Orders} AS Orders " & _  
  "RELATE CustomerID TO CustomerID)", connection)  
  
Dim customers As DataSet = New DataSet()  
  
adapter.Fill(customers, "Customers")  
End Using  

using (OleDbConnection connection = new OleDbConnection("Provider=MSDataShape;Data Provider=SQLOLEDB;" +  
  "Data Source=(local);Integrated Security=SSPI;Initial Catalog=northwind"))  
{  
OleDbDataAdapter adapter = new OleDbDataAdapter("SHAPE {SELECT CustomerID, CompanyName FROM Customers} " +  
  "APPEND ({SELECT CustomerID, OrderID FROM Orders} AS Orders " +  
  "RELATE CustomerID TO CustomerID)", connection);  
  
DataSet customers = new DataSet();  
adapter.Fill(customers, "Customers");  
}  

Wenn der Fill Vorgang abgeschlossen ist, enthält DataSet zwei Tabellen: Customers und CustomersOrders, wobei CustomersOrders die kapitelierte Spalte darstellt. Eine zusätzliche Spalte namens Orders wird der Tabelle Customers hinzugefügt, und eine weitere Spalte namens CustomersOrders wird der Tabelle CustomersOrders hinzugefügt. Die Orders Spalte in der Customers Tabelle wird auf automatische Inkrementierung festgelegt. Eine DataRelation, nämlich CustomersOrders, wird mithilfe der Spalten erstellt, die den Tabellen mit Customers als übergeordnete Tabelle hinzugefügt wurden. Die folgenden Tabellen zeigen einige Beispielergebnisse.

TableName: Customers

TableName: CustomersOrders

Siehe auch

• DataAdapters und DataReaders
• Datentypzuordnungen in ADO.NET
• Ändern von Daten mit einem DbDataAdapter
• Mehrere aktive Resultsets (MARS)
• Übersicht über ADO.NET