Galileo Computing < openbook > Galileo Computing - Professionelle Bücher. Auch für Einsteiger.
Professionelle Bücher. Auch für Einsteiger.

Inhaltsverzeichnis
Vorwort zur 5. Auflage
1 Allgemeine Einführung in .NET
2 Grundlagen der Sprache C#
3 Klassendesign
4 Vererbung, Polymorphie und Interfaces
5 Delegates und Ereignisse
6 Weitere .NET-Datentypen
7 Weitere Möglichkeiten von C#
8 Auflistungsklassen (Collections)
9 Fehlerbehandlung und Debugging
10 LINQ to Objects
11 Multithreading und die Task Parallel Library (TPL)
12 Arbeiten mit Dateien und Streams
13 Binäre Serialisierung
14 Einige wichtige .NET-Klassen
15 Projektmanagement und Visual Studio 2010
16 XML
17 WPF – Die Grundlagen
18 WPF-Containerelemente
19 WPF-Steuerelemente
20 Konzepte der WPF
21 Datenbindung
22 2D-Grafik
23 ADO.NET – verbindungsorientierte Objekte
24 ADO.NET – Das Command-Objekt
25 ADO.NET – Der SqlDataAdapter
26 ADO.NET – Daten im lokalen Speicher
27 ADO.NET – Aktualisieren der Datenbank
28 Stark typisierte DataSets
29 LINQ to SQL
30 Weitergabe von Anwendungen
Stichwort

Buch bestellen
Ihre Meinung?

Spacer
<< zurück
Visual C# 2010 von Andreas Kühnel
Das umfassende Handbuch
Buch: Visual C# 2010

Visual C# 2010
geb., mit DVD
1295 S., 49,90 Euro
Rheinwerk Computing
ISBN 978-3-8362-1552-7
Pfeil 25 ADO.NET – Der SqlDataAdapter
Pfeil 25.1 Was ist ein »DataAdapter«?
Pfeil 25.2 Konstruktoren der Klasse »DataAdapter«
Pfeil 25.3 Mit dem »SqlDataAdapter« arbeiten
Pfeil 25.3.1 Die Eigenschaft »SelectCommand«
Pfeil 25.3.2 Lokalen Datenspeicher mit »Fill« füllen
Pfeil 25.3.3 Öffnen und Schließen von Verbindungen
Pfeil 25.3.4 Doppelter Aufruf der »Fill«-Methode
Pfeil 25.3.5 Mehrere »DataAdapter«-Objekte aufrufen
Pfeil 25.3.6 Spalten- und der Tabellenbezeichner einer »DataTable«
Pfeil 25.3.7 Paging mit der »Fill«-Methode
Pfeil 25.4 Tabellenzuordnung mit der Klasse »TableMappings«
Pfeil 25.4.1 Spaltenzuordnungen in einem »DataSet«
Pfeil 25.4.2 Spaltenzuordnungen einer »DataTable«
Pfeil 25.4.3 Die Eigenschaft »MissingMappingAction« des »DataAdapter«
Pfeil 25.5 Das Ereignis »FillError« des »SqlDataAdapter«


Galileo Computing - Zum Seitenanfang

25.4 Tabellenzuordnung mit der Klasse »TableMappings« Zur nächsten ÜberschriftZur vorigen Überschrift

Um ein DataSet mit mehreren Tabellen zu füllen, können Sie eine Batch-Abfrage absetzen:


string strSQL = "SELECT * FROM Products;" +
                "SELECT * FROM Suppliers;" +
                "SELECT * FROM Categories";
SqlDataAdapter da = new SqlDataAdapter(strSQL, con);
DataSet ds = new DataSet();
da.Fill(ds);

Das DataSet beherbergt nun drei Tabellen. In jeder sind alle Datensätze der entsprechenden Originaltabellen Products, Suppliers und Categories enthalten. Allerdings stehen wir vor folgender Frage: Wie können wir eine bestimmte Tabelle im DataSet ansprechen, wenn darin mehrere Tabellen enthalten sind?

Ein DataSet verwaltet alle in ihm enthaltenen Tabellen in einer Auflistung vom Typ DataTableCollection. Die Referenz auf diese Auflistung liefert die Eigenschaft Tables des DataSet-Objekts.

Jetzt sollte man auch noch wissen, dass ein DataTable-Objekt seinen Tabellennamen über die Eigenschaft TableName preisgibt. Mit diesen Kenntnissen können wir jetzt die Namen der Tabellen im DataSet abfragen:


foreach(DataTable table in ds.Tables)
  Console.WriteLine(table.TableName);

Die Ausgabe wird nicht – wie vielleicht zu vermuten wäre – Products, Suppliers und Categories lauten, sondern, wie schon vorher behauptet:


Table
Table1
Table2

Die Zuordnung von Table zu Products, Table1 zu Suppliers und Table2 zu Categories ist aber in den meisten Fällen nicht wünschenswert. Besser geeignet wären sprechende Bezeichner, die zudem zur Verbesserung der Lesbarkeit des Codes beitragen. Der SqlDataAdapter bietet daher einen Mechanismus, um den Tabellen im Abfrageergebnis einen anderen Namen zuzuordnen: die Eigenschaft TableMappings, die die Referenz auf ein DataTableMappingCollection-Objekt liefert.


public DataTableMappingCollection TableMappings{get;}

In der Auflistung DataTableMappingCollection werden Objekte vom Typ DataTableMapping verwaltet. Jedes dieser Objekte ordnet einer Tabelle im DataSet einen Tabellennamen zu.

Am einfachsten ist es, mit der Add-Methode die Auflistung zu füllen. Dazu wird dem ersten Parameter die Zeichenfolge übergeben, unter der die Tabelle per Vorgabe in das DataSet gefüllt wird. Dem zweiten Parameter teilt man den gewünschten Tabellennamen mit.


public DataTableMapping Add(string, string)

Das folgende Codefragment zeigt, wie Sie die DataTableMappingCollection des DataAdapter-Objekts füllen können. Dabei wird davon ausgegangen, dass die oben angeführte Batch-Abfrage abgesetzt wird. Die Zuordnung muss vor dem Füllen des DataSets mit Fill erfolgen, ansonsten bleibt sie wirkungslos.


da.TableMappings.Add("Table", "Artikel");
da.TableMappings.Add("Table1", "Lieferanten");
da.TableMappings.Add("Table2", "Kategorien");
DataSet ds = new DataSet();
da.Fill(ds);
...

Add ruft implizit den DataTableMapping-Konstruktor auf. Sie können das natürlich auch selbst in die Hand nehmen, müssen dann aber jeder Tabelle über die Eigenschaft SourceTable sagen, welchen Standardnamen sie im DataSet hat, und ihr über DataSetTable mitteilen, welcher Bezeichner der Tabelle neu zugeordnet werden soll. Das folgende Beispiel zeigt, wie der Code dazu aussieht:


DataTableMapping dtm1 = new DataTableMapping();
dtm1.SourceTable = "Table";
dtm1.DataSetTable = "Artikel";
da.TableMappings.Add((object)dtm1);
 
DataTableMapping dtm2 = new DataTableMapping();
dtm2.SourceTable = "Table1";
dtm2.DataSetTable = "Lieferanten";
da.TableMappings.Add((object)dtm2);
 
DataTableMapping dtm3 = new DataTableMapping();
dtm3.SourceTable = "Table2";
dtm3.DataSetTable = "Kategorien";
da.TableMappings.Add((object)dtm3);
DataSet ds = new DataSet();
da.Fill(ds);
...

Die Klasse DataTableMapping gehört zum Namespace System.Data.Common, der vorher mit using bekannt gegeben werden sollte. Sie erkennen, dass diese Art der Zuordnung mehr Programmieraufwand bedeutet.


Galileo Computing - Zum Seitenanfang

25.4.1 Spaltenzuordnungen in einem »DataSet« Zur nächsten ÜberschriftZur vorigen Überschrift

Jeder Spalte der SELECT-Abfrage wird eine Spalte in der DataTable zugeordnet. Als Spaltenbezeichner verwendet ADO.NET dabei den Spaltennamen der Originaltabelle in der Datenbank. Wenn Sie die Datenquelle mit


SELECT ProductName, UnitPrice FROM Products

abfragen, lauten die Spalten in der DataTable ebenfalls ProductName und UnitPrice. Wünschen Sie andere Spaltenbezeichner, können Sie im SELECT-Statement für die einzelnen Spalten ein Alias angeben, zum Beispiel:


SELECT ProductName AS Artikelname, UnitPrice As Einzelpreis FROM Products

Nun würden in der DataTable die Spaltenbezeichner Artikelname und Einzelpreis lauten.

Sie können aber auch alternativ einen anderen Mechanismus einsetzen. Ein DataTableMapping-Objekt hat eine eigene Auflistung, mit der den obligatorischen Spaltenbezeichnern neue zugeordnet werden können. Diese Auflistung ist vom Typ DataColumnMappingCollection und enthält DataColumnMapping-Objekte. Jedes DataColumnMapping-Objekt beschreibt für sich eine Neuzuordnung eines Spaltenbezeichners in einer DataTable. Die vielleicht ein wenig komplex anmutenden Zusammenhänge zwischen DataAdapter, DataTableMapping und DataColumnMapping sind in Abbildung 25.1 anschaulich dargestellt.

Abbildung 25.1 Hierarchie der Zuordnungsklassen

Die Referenz auf die DataColumnMappingCollection stellt die Eigenschaft ColumnMappings der Klasse DataTableMapping bereit:


public DataColumnMappingCollection ColumnMappings {get;}

Um eine Neuzuordnung festzulegen, bietet sich auch hier der Weg über die Add-Methode des DataColumnMappingCollection-Objekts an.


public DataColumnMapping Add(string, string);

Analog zur Add-Methode der DataTableMappingCollection wird dem ersten Parameter der ursprüngliche Spaltenbezeichner und dem zweiten Parameter der gewünschte Spaltenbezeichner übergeben.

Das folgende Codefragment zeigt den kompletten Code, der notwendig ist, um neben dem Tabellennamen auch die Spaltenbezeichner einer Abfrage neu festzulegen. Zum Schluss werden die Spaltenneuzuordnungen zur Bestätigung an der Konsole ausgegeben. Der Code im Schleifenkopf zur Ausgabe der Spaltenbezeichner dürfte ohne weitere Erläuterungen verständlich sein.


string strCon = @"...";
SqlConnection con = new SqlConnection(strCon);
string strSQL = "SELECT ProductName, UnitPrice FROM Products";
SqlDataAdapter da = new SqlDataAdapter(strSQL, con);
// Neuzuordnung des Tabellennamens
DataTableMapping dtm = da.TableMappings.Add("Table", "Autoren");
// Neuzuordnung der Tabellenbezeichner
dtm.ColumnMappings.Add("ProductName", "Artikelname");
dtm.ColumnMappings.Add("UnitPrice", "Einzelpreis");
DataSet ds = new DataSet();
da.Fill(ds); 
// Konsolenausgabe der Spaltenbezeichner
foreach(DataColumn column in ds.Tables[0].Columns)
   Console.WriteLine(column.ColumnName);


Galileo Computing - Zum Seitenanfang

25.4.2 Spaltenzuordnungen einer »DataTable« Zur nächsten ÜberschriftZur vorigen Überschrift

Wenn Sie der Fill-Methode anstelle eines DataSet- ein DataTable-Objekt übergeben, müssen Sie ein wenig anders vorgehen, um die Spalten mit eigenen Bezeichnern im lokalen Datenspeicher anzusprechen. Dazu erzeugen Sie wieder ein DataTableMapping-Objekt, dem Sie die gewünschten Spaltenbezeichner zuordnen. Bei der Instanziierung von DataTable rufen Sie allerdings den parametrisierten Konstruktor auf, dem der im DataTableMappping zugeordnete Tabellenname übergeben wird.


...
DataTableMapping dtm = da.TableMappings.Add("Table", "Products");
// Neuzuordnung der Spaltenbezeichner
dtm.ColumnMappings.Add("ProductName", "Artikelname");
dtm.ColumnMappings.Add("UnitPrice", "Einzelpreis");
DataTable tbl = new DataTable("Artikel");
da.Fill(tbl);
...


Galileo Computing - Zum Seitenanfang

25.4.3 Die Eigenschaft »MissingMappingAction« des »DataAdapter« topZur vorigen Überschrift

Die Neuzuordnung der Tabellen- und Spaltenbezeichner ist eine Option, die vor dem Aufruf der Methode Fill wahrgenommen werden kann. Der DataAdapter prüft vor dem Füllen des DataSets, ob die Zuordnungsauflistungen gefüllt sind. Dabei interessiert er sich besonders für die Spaltenzuordnungen.

Für jede Spalte des Abfrageergebnisses überprüft der DataAdapter, ob dafür eine Zuordnung in der DataColumnMappingCollection angegeben ist. Existiert eine solche nicht, überprüft er im nächsten Schritt seine MissingMappingAction-Eigenschaft. Hier findet er die Antwort darauf, wie er mit einer fehlenden Spaltenangabe umzugehen hat. Wie Sie bisher erfahren haben, werden Spalten, die nicht im DataColumnMapping-Objekt angegeben sind, mit dem Namen, den sie in der Originaltabelle haben, in die entsprechende DataTable eingetragen. Der DataAdapter kann aber auch angewiesen werden, alle Spalten, die nicht in der Zuordnungstabelle enthalten sind, zu ignorieren. Eine dritte Möglichkeit wäre es, eine Ausnahme auszulösen, wenn keine Zuordnung angegeben ist.

MissingMappingAction ist vom Typ der gleichnamigen Enumeration MissingMappingAction. Die drei Member der Enumeration lauten Error, Ignore und Passthrough. Letzteres ist die Standardeinstellung.


Tabelle 25.1 Mitglieder der Enumeration »MissingMappingAction«

Member Beschreibung
Error

Fehlt eine Spaltenzuordnung, wird eine Ausnahme ausgelöst.

Ignore

Fehlt eine Spaltenzuordnung, wird die Spalte in der DataTable ignoriert.

Passthrough

Fehlt eine Spaltenzuordnung, wird die Spalte unter ihrem ursprünglichen Namen der DataTable hinzugefügt.




Ihr Kommentar

Wie hat Ihnen das <openbook> gefallen? Wir freuen uns immer über Ihre freundlichen und kritischen Rückmeldungen. >> Zum Feedback-Formular
<< zurück
  Zum Katalog
Zum Katalog: Visual C# 2010

Visual C# 2010
Jetzt bestellen


 Ihre Meinung?
Wie hat Ihnen das <openbook> gefallen?
Ihre Meinung

 Buchempfehlungen
Zum Katalog: Professionell entwickeln mit Visual C# 2012






 Professionell
 entwickeln mit
 Visual C# 2012


Zum Katalog: Windows Presentation Foundation






 Windows Presentation
 Foundation


Zum Katalog: Schrödinger programmiert C++






 Schrödinger
 programmiert C++


Zum Katalog: C++ Handbuch






 C++ Handbuch


Zum Katalog: C/C++






 C/C++


 Shopping
Versandkostenfrei bestellen in Deutschland und Österreich
InfoInfo




Copyright © Rheinwerk Verlag GmbH 2010
Für Ihren privaten Gebrauch dürfen Sie die Online-Version natürlich ausdrucken. Ansonsten unterliegt das <openbook> denselben Bestimmungen, wie die gebundene Ausgabe: Das Werk einschließlich aller seiner Teile ist urheberrechtlich geschützt. Alle Rechte vorbehalten einschließlich der Vervielfältigung, Übersetzung, Mikroverfilmung sowie Einspeicherung und Verarbeitung in elektronischen Systemen.


Nutzungsbestimmungen | Datenschutz | Impressum

Rheinwerk Verlag GmbH, Rheinwerkallee 4, 53227 Bonn, Tel.: 0228.42150.0, Fax 0228.42150.77, service@rheinwerk-verlag.de

Cookie-Einstellungen ändern