## 25.4 Tabellenzuordnung mit der Klasse »TableMappings« 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. ### 25.4.1 Spaltenzuordnungen in einem »DataSet« 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. Hier klicken, um das Bild zu vergrößern 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);
### 25.4.2 Spaltenzuordnungen einer »DataTable« 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);
    ...
### 25.4.3 Die Eigenschaft »MissingMappingAction« des »DataAdapter« 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.