Code-Beispiel

Formatierung von Zeichenketten: Anwendung von Format()

Ein Beispiel zum Einsatz der Klasse System.String aus der .NET-Klassenbibliothek.

Autor: Dr. Holger Schwichtenberg

Beschreibung

Die Methode Format() ermöglicht die Zusammensetzung eines Strings aus beliebigen Werten. Die Werte können dabei formatiert werden. Format() hat immer mindestens zwei Parameter: Der erste Parameter ist die Formatierungsvorschrift, der zweite ein zu formatierender Wert. Format() verwendet geschweifte Klammern als Platzhalter in der Formatierungsvorschrift. In {1:D} steht die erste Zahl für die laufende Nummer des Parameters und D für das anzuwendende Format. Die Zählung der Parameter beginnt bei 0. D steht für langes Datumsformat.
Die komplette Syntax für die Formatierungsvorschriften ist sehr umfangreich und findet leider keinen Platz in diesem Buch. Sie finden die Syntax unter dem Stichwort "Formatierung von Typen" in der .NET Framework SDK-Dokumentation.
Format() berücksichtigt bei der Ausgabe die aktuelle Ländereinstellung, wie das folgende Beispiel nach Veränderung von Thread.CurrentThread.CurrentCulture beweist. Länderspezifische Formatierungen sind aber auch möglich, ohne direkt den Thread zu verändern: Vor der Formatierungsvorschrift kann Format() auch ein CultureInfo-Objekt übergeben werden, das dann nur für diesen einen Befehl wirkt.

Programmcodebeispiele Visual Basic .NET (VB.NET)

' ============================
' .NET-Code-Beispiel in Visual Basic .NET
' Formatieren einer Zeichenkette
' ============================
Sub string_format()
Dim s1 As String
Dim s2 As String
Dim s3 As String
Dim i1 As Integer
Dim MyDateTime As DateTime

' --- aktuelles Datum ermitteln
MyDateTime = MyDateTime.Now
' --- Wert
i1 = 1974

' --- Formatierung bei aktueller Landeseinstellung:

s1 = "Unformatierte Ausgaben: " & vbNewLine
s1 = s1 & " Datum: " & MyDateTime & vbNewLine
s1 = s1 & " Zahl: " & i1 & vbNewLine
s1 = s1 & "Formatierte Ausgaben: " & vbNewLine
s1 = s1 & String.Format(" Datum: {0:D}" & vbNewLine & " Zahl als Währung: {1:C}", MyDateTime, i1)
s1 = s1 & vbNewLine & String.Format(" Zahl formatiert: {0:#,#}", i1)
out(s1 & vbNewLine)

' --- Formatierung bei anderer CultureInfo:

' CultureInfo für US-Englisch erzeugen
Dim ci As CultureInfo
ci = New CultureInfo("en-US")

s2 = "Unformatierte Ausgaben: " & vbNewLine
s2 = s2 & " Datum: " & MyDateTime & vbNewLine
s2 = s2 & " Zahl: " & i1 & vbNewLine

s2 = s2 & "Formatierte Ausgaben mit anderer CultureInfo: " & vbNewLine
s2 = s2 & String.Format(ci, " Datum: {0:D}" & vbNewLine & " Betrag: {1:C}", MyDateTime, i1)
s2 = s2 & vbNewLine & String.Format(ci, " Zahl formatiert: {0:#,#}", i1)
out(s2 & vbNewLine)

' Thread auf andere CultureInfo umstellen
Thread.CurrentThread.CurrentCulture = ci

s3 = "Unformatierte Ausgaben nach Umstellung der CultureInfo: " & vbNewLine
s3 = s3 & " Datum: " & MyDateTime & vbNewLine
s3 = s3 & " Zahl: " & i1 & vbNewLine

s3 = s3 & "Formatierte Ausgaben: " & vbNewLine
s3 = s3 & String.Format(" Datum: {0:D}" & vbNewLine & " Betrag: {1:C}", MyDateTime, i1)
s3 = s3 & vbNewLine & String.Format(" Zahl formatiert: {0:#,#}", i1)
out(s3 & vbNewLine)

' CultureInfo auf DE zurückstellen:
ci = New CultureInfo("de-DE")
Thread.CurrentThread.CurrentCulture = ci

End Sub

Programmcodebeispiele CSharp (C#)

using System;
using System.Globalization;
using System.Threading;

using FCL_Buch;

namespace FCLBuch.System {

public class Samples_String {
public void String_Format() {

// Formatieren einer Zeichenkette
// aktuelles Datum ermitteln
DateTime myDateTime = DateTime.Now;

// Wert
int i1 = 1974;

// Formatierung bei aktueller CultureInfo (Deutsch?):
string s1 = "Unformatierte Ausgaben: " + "\r\n";
s1 = s1 + " Datum: " + myDateTime.ToLongDateString() + "\r\n";
s1 = s1 + " Zahl: " + i1.ToString() + "\r\n";
s1 = s1 + "Formatierte Ausgaben: " + "\r\n";
s1 = s1 + String.Format("Datum: {0:D}" + "\r\n" + "Zahl als Währung: {1:C}", myDateTime, i1);
s1 = s1 + "\r\n" + String.Format(" Zahl formatiert: {0:#,#}", i1);
FclOutput.PrintOut( s1 + "\r\n" );

// Formatierung bei anderer CultureInfo:

// CultureInfo für US-Englisch erzeugen
CultureInfo ci = new CultureInfo( "en-us" );
string s2 = "Unformatierte Ausgaben: " + "\r\n";
s2 = s2 + " Datum: " + myDateTime.ToLongDateString() + "\r\n";
s2 = s2 + " Zahl: " + i1.ToString() + "\r\n";

s2 = s2 + "Formatierte Ausgaben mit anderer CultureInfo: " + "\r\n";
s2 = s2 + String.Format(ci, " Datum: {0:D}" + "\r\n" + " Betrag: {1:C}", myDateTime, i1 );
s2 = s2 + "\r\n" + String.Format(ci, " Zahl formatiert: {0:#,#}", i1 );
FclOutput.PrintOut(s2 + "\r\n" );

// Thread auf andere CultureInfo umstellen
Thread.CurrentThread.CurrentCulture = ci;

string s3 = "Unformatierte Ausgaben nach Umstellung der CultureInfo: " + "\r\n";
s3 = s3 + " Datum: " + myDateTime.ToLongDateString() + "\r\n";
s3 = s3 + " Zahl: " + i1 + "\r\n";

s3 = s3 + "Formatierte Ausgaben: " + "\r\n";
s3 = s3 + String.Format(" Datum: {0:D}" + "\r\n" + " Betrag: {1:C}", myDateTime, i1);
s3 = s3 + "\r\n" + String.Format(" Zahl formatiert: {0:#,#}", i1);
FclOutput.PrintOut(s3 + "\r\n");

// CultureInfo auf DE zurückstellen:
Thread.CurrentThread.CurrentCulture = new CultureInfo("de-DE");
}
}
}

Hinweise

Ausgaben werden in den Beispielen durch Hilfsroutinen wie out() und PrintOut() erzeugt. Diese sind hier nicht angegeben, da deren Implementierung von der jeweiligen Umgebung abhängt. Für Konsolenanwendungen können hier z.B. Console.WriteLine() einsetzen.


 

Querverweise

 Liste aller Codebeispiele  Definition '.NET Framework Class Library'  Verfügbarkeit der Klasse 'System.String'  Übersicht über den FCL-Namensraum 'System'  .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