Code-Beispiel

Umwandlung einer DataTable in CSV-Form

Ein Beispiel zum Einsatz der Klasse System.Data.OleDb.DataTable aus der .NET-Klassenbibliothek.

Autor: Dr. Holger Schwichtenberg

Beschreibung

Ein DataTable-Objekt repräsentiert genau eine Tabelle mit n Spalten und m Zeilen. Ein DataTable-Objekt ist aber nicht der direkte Nachfolger eines RecordSet-Objekts. Zwar repräsentiert DataTable eine Tabelle, jedoch benötigt ein DataTable zwingend die Hilfe anderer Klassen (DataSet, OleDbDataAdapter), um Daten aus einer Datenquelle einlesen bzw. ändern zu können. Ein DataTable-Objekt kann aber auch ohne Datenquelle dynamisch im Hauptspeicher erzeugt werden.

Bewegung durch die Datensätze
Die Arbeit mit einem DataTable-Objekt ist wesentlich objektorientierter als die Arbeit mit einem RecordSet-Objekt aus dem klassischen ADO.

Ein RecordSet-Objekt ist einerseits eine ganze Tabelle, aber andererseits zu einem bestimmten Zeitpunkt immer nur genau ein Datensatz – ähnlich wie beim DataReader. In einem RecordSet gibt es eine Objektmenge zum Durchlaufen der Spalten (Fields-Collection); die Iteration über die Zeilen erfolgt aber nicht objektorientiert, sondern mit MoveNext() und Prüfung auf das Tabellenende (EOS).
Eine DataTable in ADO.NET verweist dagegen im Attribut Rows auf eine Collection vom Typ DataRowCollection, mit der die Zeilen der Tabelle (mit For Each) durchlaufen werden können.

' --- Schleife über alle Datensätze
For Each DR In DT.Rows
Next

Eine einzelne Zeile besitzt keinen Namen, kann aber über einen numerischen Index direkt angesprochen werden. Der Index beginnt bei 0 (Zeile 1) und läuft dementsprechend bis ZEILENANZAHL-1.

' --- Zugriff auf die 3. Zeile
DR = DT.Rows.Item(2)

Die Anzahl der Datensätze in einer Tabelle kann über das Attribut Count ermittelt werden.

Anzahl = DT.Rows.Count

Spaltennamen
Zur Ermittlung der Spaltennamen gibt es im DataTable-Objekt eine Collection Columns vom Typ DataColumnCollection mit einzelnen DataColumn-Objekten.

' --- Ermittlung einer CDV-Liste der Spaltennamen
For Each DC In DT.Columns
zeile += IIf(zeile <> "", ";", "").ToString
zeile += DC.ColumnName
Next

Die Collection DataColumns entspricht der Fields-Collection aus dem klassischen ADO.

Tabelleninhalte
Der Zugriff auf die Inhalte erfolgt über das DataRow-Objekt. Dieses Objekt liefert über das indizierte Attribut Item() den Inhalt einer bestimmten Spalte.

DataRow.item("SpaltenName")

Genau wie im klassischen ADO kann dieser Ausdruck in zwei Formen verkürzt werden:

DataRow!SpaltenName
DataRow("SpaltenName")

Außerdem ist nicht nur der Zugriff über den Spaltennamen, sondern auch über einen numerischen Index (Spalte 1 hat den Index 0) möglich.

DataRow.item(INDEX)
DataRow(INDEX)

Datentyp-Herausforderungen
Wenn Sie die Option Strict in VB.NET verwenden, dann werden Sie aus der klassischen ADO-Programmierung mit VB6 bisher nicht bekannte Datentypprobleme bekommen, weil der Rückgabetyp von DataRow.Item() allgemein als System.Object definiert ist.

Zum Beispiel führt

say(DR("Name") & " kostet " & DR("Preis"))

zum Fehler

Option Strict disallows operands of Type Object for operator '&'

und die Befehlsfolge

Dim Alterpreis As Double
Alterpreis = DR("Preis")

führt zum Fehler

Option Strict disallows implicit conversions from System.Object to System.Double.

Der Grund dafür ist, dass die Items()-Collection der DataRow-Klasse eine Menge von Objekten des allgemeinen Typs System.Object ist, damit diese alle möglichen Werte aufnehmen kann (Object ist das, was in früheren Visual Basic-Versionen der Datentyp Variant war). Die Option Strict verbietet aber, dass ein Variant automatisch in einen anderen Typ konvertiert wird.
Wenn man Option Strict nicht abschalten will, müssen die obigen Beispiele mit expliziten Datentypkonvertierungen programmiert werden:

say(DR("Name").tostring & _
" kostet " & CStr(DR("Preis")))

und

Dim Alterpreis As Double
Alterpreis = CDbl(DR("Preis")).

Für die Ausführung der Konvertierung gibt es unterschiedliche Möglichkeiten:
  • die spracheigenen Typkonvertierungsfunktionen, z.B. CStr(), CInt(), CLng() etc. in VB.NET
  • die Methode toString() in System.Object
  • die Methoden der Klasse System.Convert

Hilfsroutinen zur Ausgabe
Die folgende Routine packt alle Spalten und Zeilen einer Tabelle zusammen in einen CSV-String.

Programmcodebeispiele Visual Basic .NET (VB.NET)

' ### Wandelt eine Tabelle in CSV-Daten um
Function tabletocsv(ByVal DT As DataTable) As String
Dim zeile As String = ""
Dim DR As DataRow
Dim DC As DataColumn

' --- Spaltenüberschriften
For Each DC In DT.Columns
zeile += IIf(zeile <> "", ";", "").ToString
zeile += DC.ColumnName
Next
tabletocsv += zeile & chr(13)

' --- Ausgabe aller Zeilen
For Each DR In DT.Rows
Zeile = ""
' Schleife über alle Spalten
For Each DC In DT.Columns
zeile += IIf(zeile <> "", ";", "").ToString
zeile += DR.item(DC.ColumnName).ToString

Next
tabletocsv += zeile & chr(13)
Next

End Function

Programmcodebeispiele CSharp (C#)

using System;
using System.Data;
using System.Data.OleDb;

using FCL_Buch;

namespace FCLBuch._SystemData {

public class ADONET_HelperMethods {

public static string TableToCsv( DataTable dt ) {

// Wandelt eine Tabelle in CSV-Daten um
string zeile = String.Empty;
string result = String.Empty;

// Spaltenüberschriften
foreach ( DataColumn dc in dt.Columns ) {
zeile = zeile.Equals( String.Empty ) ? zeile + "" : zeile + ";";
zeile += dc.ColumnName;
}

result += zeile + "\r\n";

// Ausgabe aller Zeilen
foreach ( DataRow dr in dt.Rows ) {
zeile = "";
// Schleife über alle Spalten
foreach ( DataColumn dc in dt.Columns ) {
zeile = zeile.Equals( String.Empty ) ? zeile + "" : zeile + ";";
zeile += dr[dc.ColumnName].ToString();
}
result += zeile + "\r\n";
}
return result;
}
}
}

 

Querverweise

 Liste aller Codebeispiele  Definition '.NET Framework Class Library'  Verfügbarkeit der Klasse 'System.Data.OleDb.DataTable'  Übersicht über den FCL-Namensraum 'System.Data.OleDb'  .NET & Visual Studio Community Portal

Buchtipp

Buchcover PowerShell 7 und Windows PowerShell 5 – das Praxishandbuch (5. Auflage Oktober 2022 (9. Auflage Gesamtreihe)) PowerShell 7 und Windows PowerShell 5 – das Praxishandbuch
Autoren: Dr. Holger Schwichtenberg
erschienen 10/2022, 1426 Seiten
ISBN: 3446472967

Beratung & Support

Schulungen zu diesem Thema

 Visual Basic .NET - Aufbauwissen
 Grundlagen der objektorientierten Programmierung anhand von C# oder Visual Basic .NET
 Unit Testing / Testgetriebene Entwicklung / Test Driven Development (TDD) von .NET-Anwendungen (C# oder Visual Basic .NET)
 Visual Basic 6.0 (VB6.0)
 Objektorientierte Entwurfsmuster (Design-Pattern/Architektur-Pattern) mit .NET (C#, Visual Basic .NET)
 Visual Basic .NET - Basiswissen
 Windows Modern Apps/Windows Universal Apps entwickeln mit der Windows Runtime (WinRT), XAML und .NET/C#/Visual Basic
 Visual Basic Script (VBScript/VBS) - Sprachsyntax und Praxiseinsatz
 Word-Programmierung mit Visual Basic for Applications (VBA)
 Visual Studio Tools for Microsoft Office (VSTO) - Microsoft Office-Programmierung mit .NET und C# oder Visual Basic in Visual Studio
 Multi-Threading in .NET mit C#/Visual Basic .NET und/oder C++ und C++/CLI
 C# für Umsteiger von Visual Basic .NET
 Objektorientierte Programmierung (OOP) mit C#, Java, C++, Visual Basic.NET o.ä.
 Excel-Programmierung mit Visual Basic for Applications (VBA)
 Visual Basic .NET für Umsteiger von VBA/VB 4/5/6
 Visual Basic 2005 (Visual Basic 8.0)
 .NET und C# für Umsteiger von klassischem Visual Basic/COM
 Outlook-Programmierung mit Visual Basic for Applications (VBA)
 Das Component Object Model - für Script- und Visual Basic-Entwickler
 C#-Basiswissen (Grundlagen der Programmiersprache C#)
 .NET Akademie: Unit Testing und Test Driven Development (TDD) mit .NET/C# (3-Tages-Agenda des öffentlichen Seminars)
 Neuerungen in C# 7.0/7.1/7.2/7.3
 Task Parallel Library (TPL) - Parallelprogrammierung/Multi-Threading in .NET/C#
 Event Driven Design (mit .NET/C# oder Java)
 Neuerung in der CLR 2.0 und C# 2005
 Neuerungen in C# 6.0
 .NET Akademie: Blazor-Hands-On: Echte Single-Page-Web-Apps mit .NET und C# entwickeln (3-Tages-Agenda des öffentlichen Seminars)
 Neuerungen in C# 3.0 (Visual C# 2008)
 Refactoring von Programmcode in C, C++, C#, Java, Kotlin, JavaScript, TypeScript, Python, Go oder Rust
 Windows 8/Windows 8.1 für Entwickler: Programmierung mit der Windows Runtime (WinRT) - Erstellen von Windows Apps mit C#/XAML und/oder JavaScript/HTML
 Anfrage für eine individuelle Schulung zum Thema Visual Basic C#  Gesamter Schulungsthemenkatalog

Bücher zu diesem Thema

  Blazor 8.0: Moderne Webanwendungen und hybride Cross-Platform-Apps mit .NET 8.0, C# 12.0 und Visual Studio 2022
  C# 12.0 Crashkurs
  C# 11.0 Crashkurs
  C# 10.0 Crashkurs
  C# 9.0 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET 5.0, .NET Core und Xamarin
  ASP.NET Core Blazor 3.1/3.2: Blazor Server und Blazor Webassembly - Moderne Single-Page-Web-Applications mit .NET, C# und Visual Studio
  ASP.NET Core Blazor 3.0/3.1: Blazor Server und Blazor Webassembly - Moderne Single-Page-Web-Applications mit .NET, C# und Visual Studio
  C# 8.0 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin
  C# 7.3 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin
  Modern Data Access with Entity Framework Core: Database Programming Using .NET, .NET Core, UWP, and Xamarin with C#
  C# 7.2 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin
  Effizienter Datenzugriff mit Entity Framework Core: Datenbankprogrammierung mit C# für .NET Framework, .NET Core und Xamarin
  Windows Store Apps entwickeln mit C# und XAML - Crashkurs
  Microsoft ASP.NET 4.0 mit C# 2010 - Entwicklerbuch
  Microsoft Viusal C# 2010
  Visual Basic 2010: Grundlagen, ADO.NET, Windows Presentation Foundation
  ASP.NET 4.0 mit Visual C# 2010
  Visual Basic 2010
  Microsoft ASP.NET 3.5 mit Visual Basic 2008 - Entwicklerbuch
 Alle unsere aktuellen Fachbücher  E-Book-Abo für ab 99 Euro im Jahr