Sie sind hier: Startseite
 Liste aller Codebeispiele

Schreiben einer Protokolldatei

Ein Beispiel zum Einsatz der Klasse System.IO.FileStream, StreamWriter aus der .NET-Klassenbibliothek.

Autor: Dr. Holger Schwichtenberg

Beschreibung

Die Verwendung von Streams (Datenströmen) ist ein zentrales Konzept in .NET. Ein Stream ist eine beliebige Byte-Folge in einem beliebigen Medium, z.B. eine Textdatei, eine Binärdatei, ein Datenstrom im Netzwerk oder auch eine Byte-Folge im Speicher. Es gibt für Streams in der FCL eine abstrakte Basisklasse System.IO.Stream, von der zahlreiche Klassen in verschiedenen Namespaces erben. Es gibt zahlreiche Attribute und Methoden in FCL-Klassen, die mit Streams arbeiten.

Auf einen Stream greift man mit Hilfe anderer Klassen zu: StreamReader und StreamWriter für Streams mit ASCII-Zeichen und BinaryReader und BinaryWriter für Streams mit beliebigen Byte-Folgen. StreamReader und StreamWriter sind Unterklassen der Klassen TextReader bzw. TextWriter. BinaryReader und BinaryWriter sind dagegen direkt von System.Object abgeleitet.

Während ein FileInfo-Objekt das Äußere einer Datei darstellt, ist ein FileStream-Objekt der Inhalt einer Datei.

Das grundsätzliche Vorgehen beim Schreiben in eine Datei ist:
  • Erzeugen eines FileStream-Objekts unter Angabe der Parameter FileMode und FileAccess
  • Erzeugen eines StreamWriter-Objekts auf Basis des FileStream-Objekts
  • Setzen des Zeigers auf Anfang oder Ende des Streams
  • Danach können Inhalte mit Write() und WriteLine() geschrieben werden.
  • Aufruf von Close() im StreamWriter-Objekt
  • Aufruf von Close() im FileStream-Objekt

Ohne Aufruf von Close() im StreamWriter wird nichts in die Datei geschrieben. Close() darf für den FileStream erst nach dem Schließen des StreamWriter-Objekts aufgerufen werden.

Für FileAccess und FileMode gibt es Enumerationen in System.IO.
Symbolische Konstante Wenn Datei vorhanden Wenn Datei nicht vorhanden
Append Anhängen Wird erzeugt
Create Wird überschrieben Wird erzeugt
CreateNew Fehler Wird erzeugt
Open Öffnen Fehler
OpenOrCreate Öffnen Wird erzeugt
Truncate Öffnen + Löschen Fehler

Symbolische Konstante Lesen Schreiben
Read Ja Nein
ReadWrite Ja Ja
Write Nein Ja

Beispiel
Die folgende Routine hängt eine Protokollierungsinformation an eine Textdatei an.

Programmcodebeispiele Visual Basic .NET (VB.NET)

' ============================
' .NET-Code-Beispiel in Visual Basic .NET
' Schreiben einer Protokolldatei
' (C) Holger@Schwichtenberg.de
' ============================
Public Sub datei_schreiben()
Const DATEINAME As String = _
"d:\buch\dateisystem\protokoll.txt"

' --- Datei öffnen
Dim fs As FileStream = New FileStream( _
DATEINAME, FileMode.OpenOrCreate, _
FileAccess.Write)

' --- Stream öffnen
Dim w As StreamWriter = New StreamWriter(fs)
' --- Anfügen am Ende
w.BaseStream.Seek(0, SeekOrigin.End)
' --- Zeilen schreiben
w.WriteLine("Start des Programms: " & now)
' --- Einzelne Zeichen schreiben
Dim a As Integer
For a = 1 To 26
w.Write(chr(96 + a))
Next
w.WriteLine()
' --- Zeilen schreiben
w.WriteLine("Ende des Programms: " & now)
' --- Writer und Stream schließen
w.Close()
fs.Close()
End Sub

Programmcodebeispiele CSharp (C#)

using System;
using System.IO;

namespace FCLBuch._SystemIO {

public class Samples_Dateiinhalte {

// Schreiben einer Protokolldatei
public void Datei_Schreiben() {

string dateiName = @"..\_daten\dateisystem\protokoll.txt";
// Datei öffnen
FileStream fs = new FileStream(dateiName, FileMode.OpenOrCreate, FileAccess.Write);
// Stream öffnen
StreamWriter w = new StreamWriter(fs);
// Anfügen am Ende
w.BaseStream.Seek(0, SeekOrigin.End);
// Zeilen Schreiben
w.WriteLine("Start des Programms: " + DateTime.Now.ToString());
// Einzelne Zeichen schreiben

for ( int i=0; i<26; i++ )
w.Write((char)(97 + i));

w.WriteLine();
// Zeilen Schreiben
w.WriteLine("Ende des Programms: " + DateTime.Now.ToString());
// Writer und Stream schließen
w.Close();
fs.Close();

}
}
}

 

Querverweise

 Definition '.NET Framework Class Library'  Verfügbarkeit der Klasse 'System.IO.FileStream, StreamWriter'  Übersicht über den FCL-Namensraum 'System.IO'  .NET & Visual Studio Community Portal

Buchtipp

Buchcover Windows PowerShell 5.1 und PowerShell Core 6.1 - Das Praxishandbuch (3. Auflage 12/2018) Kindle Windows PowerShell 5.1 und PowerShell Core 6.1 - Das Praxishandbuch (3. Auflage 12/2018) Kindle
Autoren: Dr. Holger Schwichtenberg
erschienen 2018, 1000 Seiten, 42,99 €
ISBN: 978-3-446-45923-6
Bestellung: Amazon.de oder im Buchhandel über ISBN 978-3-446-45923-6

Beratung & Support:

Schulungen zu diesem Thema:

 Task Parallel Library (TPL) - Parallelprogrammierung/Multi-Threading in .NET mit C# oder Visual Basic
 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#/Visual Basic .NET)
 Visual Basic 6.0 (VB6.0)
 Objektorientierte Entwurfsmuster (Design Pattern) mit .NET (C#, Visual Basic .NET, C++/CLI)
 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
 Parallelprogrammierung mit .NET (Multi-Threading/Multi-Tasking) - mit C#/Visual Basic und/oder C++
 C# für Umsteiger von Visual Basic .NET
 Objektorientierte Programmierung (OOP) mit C#, Java, C++, Visual Basic.NET o.ä.
 Visual Basic .NET für Umsteiger von VBA/VB 4/5/6
 Visual Basic 2005 (Visual Basic 8.0)
 C# für Umsteiger von klassischem Visual Basic/COM
 Das Component Object Model - für Script- und Visual Basic-Entwickler
 .NET Micro Framework - Embedded-Entwicklung mit .NET/C# oder C++
 .NET-Akademie: .NET-/.NET Core-/C#-Basisseminar: Softwarearchitektur, Techniken, Pattern, Best Practices (2-Tages-Agenda des öffentlichen Seminars)
 Anfrage für eine individuelle Schulung zum Thema Visual Basic;C#  Gesamter Schulungsthemenkatalog

Bücher zu diesem Thema:

 Datenbankprogrammierung mit .NET 4.0. Mit Visual Studio 2010 und SQL Server 2008 R2
 .NET 3.5
 Microsoft ASP.NET 4.0 mit C# 2010
 Webanwendungen mit ASP.NET 3.5 und AJAX Crashkurs
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.1: Datenbankprogrammierung mit .NET/.NET Core und C# (gedruckte Ausgabe)
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.1.1 und 2.0-Preview2: Datenbankprogrammierung mit .NET/.NET Core und C# (gedruckte Ausgabe und Kindle)
 Moderne Datenzugriffslösungen mit Entity Framework Core 2.0/2.1 (Buchversion 5.x, Kindle | PDF)
 Windows 8 Apps entwickeln mit C# und XAML - Crashkurs
 Microsoft Visual C# 2010
 Microsoft SQL Server 2008 R2 - Das Entwicklerbuch
 ASP.NET 4.0 mit Visual C# 2010
 ASP.NET 4.0
 Windows PowerShell - Konzepte, Praxiseinsatz, Erweiterungen
 Microsoft .NET 2.0 Crashkurs - Final Edition
 Essential PowerShell
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.1 und 2.0-Preview2 (Buchversion 1.4)
 Datenbankprogrammierung mit .NET 4.5. Mit Visual Studio 2012 und SQL Server 2012
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.1 (PDF)
 Office 2010 Programmierung mit VSTO und .NET 4.0: Word, Excel und Outlook erweitern und anpassen
 Modern Data Access with Entity Framework Core: Database Programming Using .NET, .NET Core, UWP, and Xamarin with C#
 Microsoft ASP.NET 2.0 mit Visual Basic 2005 - Das Entwicklerbuch
 .NET 3.5 Crashkurs
 Windows Scripting Lernen, 6. Auflage
 Microsoft .NET 4.5 Update - Crashkurs (EBOOK - PDF)
 Visual Basic 2010: Grundlagen, ADO.NET, Windows Presentation Foundation
 Windows Scripting (5. Auflage)
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.1.2 und 2.0-Preview2: Datenbankprogrammierung mit .NET/.NET Core und C# (PDF)
 Microsoft ASP.NET 2.0 mit C# 2005 - Das Entwicklerbuch
 Effizienter Datenzugriff mit Entity Framework Core: Datenbankprogrammierung mit C# für .NET Framework, .NET Core und Xamarin
 Microsoft ASP.NET 3.5 mit Visual C# 2008 - Das Entwicklerbuch
 Einblicke in C# 6.0 (shortcuts 181) Kindle Edition
 .NET 4.0 Crashkurs
 Docker und die Containerwelt - Einstieg und Expertentipps rund um Docker-Container (shortcut)
 Microsoft .NET 4.5 Update - Crashkurs
 Moderne Webanwendungen für .NET-Entwickler: Server-Anwendungen, Web APIs, SPAs & HTML-Cross-Platform-Anwendungen mit ASP.NET, ASP.NET Core, JavaScript/TypeScript und Angular
 C# 7.2 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin (PDF)
 Windows Scripting Lernen, 2. Auflage
 Moderne Datenzugriffslösungen mit Entity Framework 6 (gedruckte Ausgabe)
 C# 7.3 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.x und 2.0: Datenbankprogrammierung mit .NET/.NET Core und C# (gedruckte Ausgabe oder Kindle)
 Visual Basic 2010
 Microsoft ASP.NET 4.5 mit C# 2012 - Entwicklerbuch
 Microsoft ASP.NET 3.5 mit Visual Basic 2008 - Das Entwicklerbuch
 Moderne Datenzugriffslösungen mit Entity Framework Core 2.0 (Buchversion 4.x): Datenbankprogrammierung mit .NET/.NET Core und C# (gedruckte Ausgabe oder Kindle)
 Moderne Datenzugriffslösungen mit Entity Framework Core 2.0 (Buchversion 4.x): Datenbankprogrammierung mit .NET/.NET Core und C# (EBOOK - PDF)
 Moderne Datenzugriffslösungen mit Entity Framework 6 (EBOOK - PDF, MOBI, EPUB)
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.x und 2.0: Datenbankprogrammierung mit .NET/.NET Core und C# (EBOOK - PDF)
 Windows Scripting Lernen 5. Auflage
 Alle unsere aktuellen Fachbücher