Wie man Zelldatenformate in C#35; mit IronXL einstellt

Wie kann ich Zelldatenformate in Excel einstellen?

Die FormatString-Eigenschaft kann sowohl über Zellen als auch über Bereiche erreicht werden. Daher ist es möglich, Datenformate für einzelne Zellen, Spalten, Zeilen und jeden ausgewählten Bereich festzulegen. Diese Flexibilität macht IronXL besonders leistungsfähig, wenn Sie mit Excel-Dateien in C# ohne Interop arbeiten müssen.

Die Datenformatierung ist für die klare Darstellung von Informationen in Tabellenkalkulationen unerlässlich. Ganz gleich, ob Sie Finanzberichte mit Währungswerten, wissenschaftliche Daten mit präzisen Dezimalstellen oder datumsbasierte Analysen erstellen, die richtige Formatierung gewährleistet, dass Ihre Daten sowohl lesbar als auch professionell sind. IronXL vereinfacht diesen Prozess, indem es über eine unkomplizierte API direkten Zugriff auf die Formatierungs-Engine von Excel bietet.

:path=/static-assets/excel/content-code-examples/how-to/set-cell-data-format.cs

using IronXL;
using IronXL.Formatting;
using System;
using System.Linq;

// Create a new workbook
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Set the data format to 12300.00%
workSheet["A1"].Value = 123;
workSheet["A1"].FormatString = BuiltinFormats.Percent2;

// Set the data format to 123.0000
workSheet["A2"].Value = 123;
workSheet["A2"].FormatString = "0.0000";

// Set data display format to range
DateTime dateValue = new DateTime(2020, 1, 1, 12, 12, 12);
workSheet["A3"].Value = dateValue;
workSheet["A4"].Value = new DateTime(2022, 3, 3, 10, 10, 10);
workSheet["A5"].Value = new DateTime(2021, 2, 2, 11, 11, 11);

IronXL.Range range = workSheet["A3:A5"];

// Set the data format to 1/1/2020 12:12:12
range.FormatString = "MM/dd/yy h:mm:ss";

workBook.SaveAs("dataFormats.xlsx");

Imports IronXL
Imports IronXL.Formatting
Imports System
Imports System.Linq

' Create a new workbook
Private workBook As WorkBook = WorkBook.Create()
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Set the data format to 12300.00%
Private workSheet("A1").Value = 123
Private workSheet("A1").FormatString = BuiltinFormats.Percent2

' Set the data format to 123.0000
Private workSheet("A2").Value = 123
Private workSheet("A2").FormatString = "0.0000"

' Set data display format to range
Private dateValue As New DateTime(2020, 1, 1, 12, 12, 12)
Private workSheet("A3").Value = dateValue
Private workSheet("A4").Value = New DateTime(2022, 3, 3, 10, 10, 10)
Private workSheet("A5").Value = New DateTime(2021, 2, 2, 11, 11, 11)

Private range As IronXL.Range = workSheet("A3:A5")

' Set the data format to 1/1/2020 12:12:12
range.FormatString = "MM/dd/yy h:mm:ss"

workBook.SaveAs("dataFormats.xlsx")

:path=/static-assets/excel/content-code-examples/how-to/write-excel-net-assign-stringvalue.cs

// Assign value as string
workSheet["A1"].StringValue = "4402-12";

' Assign value as string
workSheet("A1").StringValue = "4402-12"

Wie verwende ich integrierte Formate in IronXL?

Die IronXL-Bibliothek bietet eine Vielzahl vordefinierter Format-Strings, die über die Klasse IronXL.Formatting.BuiltinFormats für die Formatierung von Excel-Zellen erhältlich sind. Dies ermöglicht es Ihnen, anzupassen, wie Daten in Ihren Excel-Tabellen angezeigt werden. Diese integrierten Formate decken die gängigsten Geschäftsszenarien ab und sind mit allen Excel-Versionen kompatibel.

Bei der programmgesteuerten Erstellung von Tabellenkalkulationen ist eine einheitliche Formatierung von entscheidender Bedeutung für die Einhaltung professioneller Standards in Ihren Dokumenten. Die Klasse BuiltinFormats bietet über 30 vorkonfigurierte Formatierungsmuster, die den Standardformatierungsoptionen von Excel entsprechen.

:path=/static-assets/excel/content-code-examples/how-to/set-cell-data-format-builtin-formats.cs

using IronXL;
using IronXL.Formatting;

// Create a new workbook
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Use builtin formats
workSheet["A1"].Value = 123;
workSheet["A1"].FormatString = BuiltinFormats.Accounting0;

workBook.SaveAs("builtinDataFormats.xlsx");

Imports IronXL
Imports IronXL.Formatting

' Create a new workbook
Private workBook As WorkBook = WorkBook.Create()
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Use builtin formats
Private workSheet("A1").Value = 123
Private workSheet("A1").FormatString = BuiltinFormats.Accounting0

workBook.SaveAs("builtinDataFormats.xlsx")

Welche eingebauten Datenformate sind verfügbar?

Für den Duration-Typ werden Eingabewerte in Tagen dargestellt. Zum Beispiel: 1 Tag entspricht 24 Stunden und 1,05 Tage entsprechen 25 Stunden und 12 Minuten. Dies ist besonders nützlich, wenn mit Excel-Daten gearbeitet wird, die Zeiterfassung oder Projektmanagement beinhalten. Hier sind die verfügbaren Formattypen:

Was macht jeder Formattyp?

• Allgemein: Standardformat zur Anzeige von Zahlen ohne spezifische Formatierung.
• Duration1: Zeigt die Dauer in Minuten und Sekunden wie "mm:ss" an
• Duration2: Zeigt die Dauer in Stunden, Minuten und Sekunden wie "[h]:mm:ss"
• Duration3: Zeigt die Dauer in Minuten, Sekunden und Millisekunden wie "mm:ss.0"
• Buchhaltung0: Buchhaltungsformat ohne Dezimalstellen, Klammern für Negative wie "#,##0_);(#,##0)."
• Buchhaltung0Rot: Buchhaltungsformat ohne Dezimalstellen, rot für Negative wie "#,##0_);Red."
• Buchhaltung2: Buchhaltungsformat mit zwei Dezimalstellen, Klammern für Negative wie "#,##0.00;(#,##0.00)."
• Buchhaltung2Rot: Buchhaltungsformat mit zwei Dezimalstellen, rot für Negative wie "#,##0.00_);Red."
• Zeit1: 12-Stunden-Format mit AM/PM wie "h:mm AM/PM"
• Zeit2: 12-Stunden-Format mit Sekunden und AM/PM wie "h:mm:ss AM/PM."
• Zeit3: 24-Stunden-Format ohne Sekunden wie "h:mm"
• Time4: 24-Stunden-Format mit Sekunden wie "h:mm:ss"
• ShortDate: Kurzes Datumsformat wie "m/d/yy"
• ShortDateAndTime: Kurzes Datums- und Zeitformat wie "m/d/yy h:mm."
• LongDate1: Langes Datum mit Monat, Tag, Jahr wie "d-mmm-yy"
• LongDate2: Langes Datum mit Tag und abgekürztem Monat wie "d-mmm"
• LongDate3: Langes Datum mit abgekürztem Monat und Jahr wie "mmm-yy"
• Fraktion1: Bruchzahlen mit einer Ziffer wie "# ?/?"
• Fraction2: Bruchzahlen mit zwei Ziffern wie "# ??/??"
• Scientific1: Wissenschaftliche Notation mit einer Dezimalstelle wie "##0.0E+0"
• Scientific2: Wissenschaftliche Notation mit zwei Dezimalstellen wie "0.00E+00"
• Prozent: Prozentsatz ohne Dezimalstellen wie "0%"
• Perzent2: Prozentsatz mit zwei Dezimalstellen wie "0,00%"
• Währung0: Währung ohne Dezimalstellen, Klammern für Negative wie "$#,##0_);($#,##0)."
• Währung0Rot: Währung ohne Dezimalstellen, rot für Negative wie "$#,##0_);Red."
• Währung2: Währung mit zwei Dezimalstellen, Klammern für Negative wie "$#,##0.00;($#,##0.00)."
• Währung2Rot: Währung mit zwei Dezimalstellen, rot für Negative wie "$#,##0.00_);Red."
• Thousands0: Zahlen mit Tausendertrennzeichen, keine Dezimalstellen wie "#,##0"
• Tausender2: Zahlen mit Tausendertrennzeichen, zwei Dezimalstellen wie "#,##0.00."
• Zahl0: Zahlen ohne Nachkommastellen wie "0"
• Number2: Zahlen mit zwei Dezimalstellen wie "0.00"
• Text: Klartextformat wie "@"

Die Daten- und Zahlenformatierung in Excel steuert, wie Zahlen, Daten, Zeiten und andere Daten in den Zellen angezeigt werden, um die Lesbarkeit zu verbessern und die Datengenauigkeit zu gewährleisten. Mit Datenformaten können Sie Informationen in bestimmten Formaten wie Prozentsätzen oder Währungen präsentieren. Ebenso ermöglichen Zahlenformate die Anpassung von Dezimalstellen und Anzeigeoptionen.

Wie kann ich mehrere Formate auf verschiedene Bereiche anwenden?

In realen Anwendungen müssen Sie oft verschiedene Formate auf verschiedene Teile Ihrer Tabellenkalkulation anwenden. Dieses Beispiel demonstriert die Formatierung eines Finanzberichts mit mehreren Datentypen. Dieser Ansatz ist besonders nützlich beim Exportieren nach Excel in C# aus Datenbanken oder anderen Datenquellen:

/* :path=/static-assets/excel/content-code-examples/how-to/set-cell-data-format-financial-report.cs */
using IronXL;
using IronXL.Formatting;
using System;

// Create a financial report with multiple formats
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Headers
workSheet["A1"].Value = "Financial Report Q4 2023";
workSheet["A1"].Style.Font.Bold = true;

// Revenue section with currency formatting
workSheet["A3"].Value = "Revenue";
workSheet["B3"].Value = 2500000;
workSheet["B3"].FormatString = BuiltinFormats.Currency0;

// Growth percentage
workSheet["A4"].Value = "YoY Growth";
workSheet["B4"].Value = 0.157;
workSheet["B4"].FormatString = BuiltinFormats.Percent2;

// Date formatting
workSheet["A6"].Value = "Report Date";
workSheet["B6"].Value = DateTime.Now;
workSheet["B6"].FormatString = BuiltinFormats.LongDate1;

// Apply accounting format to expense columns
IronXL.Range expenseRange = workSheet["B8:B12"];
expenseRange.FormatString = BuiltinFormats.Accounting2Red;

// Save the formatted report
workBook.SaveAs("FinancialReport_Q4_2023.xlsx");

/* :path=/static-assets/excel/content-code-examples/how-to/set-cell-data-format-financial-report.cs */
using IronXL;
using IronXL.Formatting;
using System;

// Create a financial report with multiple formats
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Headers
workSheet["A1"].Value = "Financial Report Q4 2023";
workSheet["A1"].Style.Font.Bold = true;

// Revenue section with currency formatting
workSheet["A3"].Value = "Revenue";
workSheet["B3"].Value = 2500000;
workSheet["B3"].FormatString = BuiltinFormats.Currency0;

// Growth percentage
workSheet["A4"].Value = "YoY Growth";
workSheet["B4"].Value = 0.157;
workSheet["B4"].FormatString = BuiltinFormats.Percent2;

// Date formatting
workSheet["A6"].Value = "Report Date";
workSheet["B6"].Value = DateTime.Now;
workSheet["B6"].FormatString = BuiltinFormats.LongDate1;

// Apply accounting format to expense columns
IronXL.Range expenseRange = workSheet["B8:B12"];
expenseRange.FormatString = BuiltinFormats.Accounting2Red;

// Save the formatted report
workBook.SaveAs("FinancialReport_Q4_2023.xlsx");

IRON VB CONVERTER ERROR developers@ironsoftware.com

Dieses Beispiel zeigt, wie verschiedene Formattypen kombiniert werden, um professionelle Finanzdokumente zu erstellen. Für fortgeschrittenere Formatierungsoptionen, einschließlich bedingter Formatierung, können Sie diese Konzepte weiter ausbauen.

Bei der Arbeit mit großen Datensätzen oder der programmatischen Erstellung von Berichten ist eine einheitliche Formatierung von entscheidender Bedeutung. Das Formatierungssystem von IronXL lässt sich nahtlos in andere Funktionen wie Mathematische Funktionen und Bearbeiten von Formeln integrieren, so dass Sie vollständig automatisierte Berichtslösungen erstellen können.

Für Entwickler, die von Office Interop umsteigen oder eine bessere Leistung wünschen, bietet das Formatierungssystem von IronXL einen erheblichen Vorteil. Im Gegensatz zu herkömmlichen Ansätzen können Sie Tausende von Zellen ohne COM-Interop-Overhead effizient formatieren. Wenn Sie mehr über die besten Praktiken der Excel-Automatisierung erfahren möchten, lesen Sie unsere umfassende Excel-Dokumentation.