Formatierung von Zeichenketten: Anwendung von Format(): Codebeispiel für Visual Basic .NET (VB.NET) und CSharp (C#)

Code-Beispiel

Formatierung von Zeichenketten: Anwendung von Format()

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

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.

Programmcodebeispiel in 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

Weiteres Programmcodebeispiel in 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.