In der heutigen datengetriebenen Welt bleibt Microsoft Excel ein unverzichtbares Werkzeug für Unternehmen und Fachleute gleichermaßen. Ob es darum geht, Zahlen zu berechnen, Berichte zu erstellen oder Daten zu visualisieren, die Vielseitigkeit von Excel ist unübertroffen. Wenn es jedoch darum geht, Excel-Dateien in C# programmatisch zu manipulieren, stehen Entwickler oft vor Herausforderungen. Hier kommt die IronXL-Bibliothek ins Spiel, die eine nahtlose Lösung für die Excel-Automatisierung in der C#-Umgebung bietet.

Die IronXL-Bibliothek von Iron Software bietet intuitive APIs für die nahtlose Verarbeitung von Excel-Dokumenten sowohl in C# .NET- als auch in VB.NET-Umgebungen. Mit IronXL ist es nicht erforderlich, Microsoft Office oder Excel-Interop-Komponenten zu installieren. Es ermöglicht Entwicklern, Excel-Tabellendateien mühelos zu lesen, zu bearbeiten und zu erstellen und bietet volle Unterstützung für verschiedene .NET-Frameworks einschließlich .NET 8, 7, 6, Core-Frameworks und Azure-Umgebungen.

In diesem Artikel erfahren wir, wie Sie die Spaltenbreite und -höhe in Excel mit C# und IronXL automatisch anpassen.

1. Erstellen Sie ein Visual Studio-Projekt, um Autofit-Zellen im Excel-Arbeitsblatt zu demonstrieren.
2. Installieren Sie die IronXL-Bibliothek im Projekt.
3. Passen Sie die Spaltenbreite mit der IronXL-Bibliothek automatisch an.
4. Passen Sie die Zeilenhöhe mit der IronXL-Bibliothek automatisch an.
5. Legen Sie die Spaltenbreite und Zeilenhöhe manuell mit der IronXL-Bibliothek fest.

IronXL

Die IronXL-Bibliothek ist eine vielseitige .NET-Bibliothek, die entwickelt wurde, um die Manipulation von Excel-Tabellen für C#-Entwickler zu vereinfachen. Mit einer schnellen und intuitiven API ermöglicht IronXL den Benutzern, Excel-Dateien mühelos zu zugreifen, zu modifizieren und zu generieren, ohne auf Office Interop angewiesen zu sein. Seine Kompatibilität erstreckt sich auf verschiedene .NET-Frameworks, einschließlich .NET Core und Azure, ohne spezielle Abhängigkeiten oder die Installation von Microsoft Office zu erfordern. Mit Unterstützung für mehrere .NET-Sprachen wie C#, VB.NET und F# deckt IronXL eine breite Palette von Entwicklungsszenarien ab, einschließlich Konsolen-, Web- und Desktop-Anwendungen. Darüber hinaus erstreckt sich die Kompatibilität von IronXL über verschiedene Plattformen, darunter Windows, Linux, macOS, Docker, Azure und AWS, was es zu einem unverzichtbaren Werkzeug für Entwickler macht, die eine effiziente Excel-Integration in verschiedenen Umgebungen suchen.

Wichtige Merkmale der IronXL-Bibliothek

1. Einfache Integration: IronXL lässt sich nahtlos in C#-Anwendungen integrieren und bietet eine einfache und intuitive API für die Excel-Automatisierung. Entwickler können schnell anfangen, ohne eine große Lernkurve zu bewältigen.
2. Excel-Dateien lesen und schreiben: Mit IronXL können Sie mühelos Daten aus vorhandenen Excel-Dateien lesen und Daten in neue oder bestehende Tabellen schreiben. Diese Fähigkeit ist wesentlich für Aufgaben wie Datenimport/-export und Berichtserstellung.
3. Formatierung und Gestaltung: Mit IronXL können Sie Excel-Zellen formatieren und gestalten, z. B. mit Schriftarten, Farben, Rahmen und vielem mehr. Dies stellt sicher, dass Ihre generierten Excel-Dateien ein professionelles und poliertes Aussehen beibehalten.
4. Formelunterstützung: Müssen Sie komplexe Berechnungen durchführen oder Formeln auf Excel-Daten anwenden? IronXL bietet Unterstützung für Excel-Formeln, die es Ihnen ermöglicht, Berechnungen und Datenmanipulationen zu automatisieren.
5. Automatische Zellenanpassung: Eine der praktischen Funktionen von IronXL ist die Möglichkeit, Zellen in Excel automatisch anzupassen. Dadurch wird sichergestellt, dass der Inhalt ohne Abschneiden sauber in jede Zelle passt.

Schritt 1: Erstellen Sie ein Visual Studio-Projekt, um die Autofit-Zellen im Excel-Arbeitsblatt zu demonstrieren.

Um loszulegen, erstellen wir ein Visual Studio-Projekt wie folgt. Wählen Sie die Konsolenanwendungsvorlage aus der Liste aus

Geben Sie Projektnamen und Speicherort an.

Wählen Sie die erforderliche .NET-Version aus der Dropdown-Liste aus und klicken Sie auf Erstellen

Schritt 2: Installieren Sie die IronXL-Bibliothek im Projekt.

Installieren Sie die IronXL-Bibliothek aus dem Visual Studio NuGet-Paketmanager

Das Paket kann auch über die NuGet-Befehlszeile installiert werden

dotnet add package IronXL.Excel --version 2024.3.20

Damit sind wir bereit, mit dem Codieren zu beginnen.

Schritt 3: Spaltenbreite mit IronXL automatisch anpassen

Die AutoSizeColumn Methode aus der IronXL-Bibliothek passt die Breite einer Spalte an ihren Inhalt an. Diese Methode berechnet die Textbreite basierend auf der im Zelltext verwendeten Schriftart. Wenn die genaue Schriftart nicht auf dem System verfügbar ist, versucht sie, dies mit einer Standardschriftart zu messen. Wenn keine Standardschriftart gefunden wird, wird versucht, eine verfügbare Schriftart zu verwenden. Wenn jedoch keine Schriftarten gefunden werden, wird eine Ausnahme ausgelöst. Sie verwendet einen nullbasierten Spaltenindex als Parameter. Er muss innerhalb der durch 0 und (Spaltenanzahl - 1) definierten Grenzen liegen. ArgumentException wird ausgelöst, wenn der bereitgestellte columnIndex außerhalb des gültigen Bereichs liegt. SixLabors.Fonts.FontException wird ausgelöst, wenn keine Schriftarten auf dem Rechner installiert sind.

Sehen wir uns nun an, wie wir dies verwenden können, um eine Excel-Datei zu ändern. Sie können eine Beispieldatei von hier herunterladen.

Eingabedatei

Hier kann man sehen, dass die Spaltenbreiten nicht richtig definiert sind und es daher sehr schwer zu lesen ist. Nun lassen Sie uns sehen, wie wir die IronXL-Bibliothek nutzen können, um Spaltenbreiten in einem Excel-Blatt automatisch anzupassen.

using IronXL;
// Load example spreadsheet
WorkBook workBook = WorkBook.Load("FinancialSample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;
var colCount = workSheet.Columns.Count();

for (int i = 0; i < colCount; i++)
{ 
    // Auto-fit column width for index i
    workSheet.AutoSizeColumn(i);
}

// Save the autofitted workbook as a new file
workBook.SaveAs("autoResize.xlsx"); // Result file

using IronXL;
// Load example spreadsheet
WorkBook workBook = WorkBook.Load("FinancialSample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;
var colCount = workSheet.Columns.Count();

for (int i = 0; i < colCount; i++)
{ 
    // Auto-fit column width for index i
    workSheet.AutoSizeColumn(i);
}

// Save the autofitted workbook as a new file
workBook.SaveAs("autoResize.xlsx"); // Result file

Imports IronXL
' Load example spreadsheet
Private workBook As WorkBook = WorkBook.Load("FinancialSample.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
Private colCount = workSheet.Columns.Count()

For i As Integer = 0 To colCount - 1
	' Auto-fit column width for index i
	workSheet.AutoSizeColumn(i)
Next i

' Save the autofitted workbook as a new file
workBook.SaveAs("autoResize.xlsx") ' Result file

Imports IronXL
' Load example spreadsheet
Private workBook As WorkBook = WorkBook.Load("FinancialSample.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
Private colCount = workSheet.Columns.Count()

For i As Integer = 0 To colCount - 1
	' Auto-fit column width for index i
	workSheet.AutoSizeColumn(i)
Next i

' Save the autofitted workbook as a new file
workBook.SaveAs("autoResize.xlsx") ' Result file

Codeerklärung

1. Zunächst laden wir die FinancialSample.xlsx mit der WorkBook.Load() Methode.
2. Dann erhalten wir die Anzahl der Spalten für Anpassungen.
3. Wir durchlaufen alle Spaltenindizes, um die Spaltenbreiten automatisch anzupassen.
4. Schließlich speichern wir die Ergebnisse in einer neuen Datei namens autoResize.xlsx.

Ausgabedatei

Unten können Sie sehen, dass alle Spalten automatisch angepasst und sichtbar sind.

Schritt 4: Zeilenhöhe mit IronXL automatisch anpassen

Die AutoSizeRow Methode passt die Höhe einer Zeile an ihren Inhalt an. Es ist wichtig zu beachten, dass diese Methode die Texthöhe basierend auf der im Zelltext verwendeten Schriftart berechnet. Wenn die genaue Schriftart nicht auf dem System verfügbar ist, versucht sie, dies mit einer Standardschriftart zu messen. Wenn keine Standardschriftart gefunden wird, wird versucht, eine verfügbare Schriftart zu verwenden. Wenn jedoch keine Schriftarten gefunden werden, wird eine Ausnahme ausgelöst. Sie verwendet einen nullbasierten Zeilenindex als Parameter. Er muss innerhalb der durch 0 und (Zeilenanzahl - 1) definierten Grenzen liegen. ArgumentException wird ausgelöst, wenn der bereitgestellte rowIndex außerhalb des gültigen Bereichs liegt. SixLabors.Fonts.FontException wird ausgelöst, wenn keine Schriftarten auf dem Rechner installiert sind.

Eingabe-Excel-Datei

Im untenstehenden Beispiel sehen Sie, dass einige der Zeilen nicht richtig dimensioniert sind, um die Daten angemessen zu erfassen. Sehen wir uns den C#-Code zur automatischen Anpassung der Excel-Zeilenhöhen an.

using IronXL;
// Load example spreadsheet
WorkBook workBook = WorkBook.Load("FinancialSample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;
var rowCount = workSheet.RowCount;

for (int i = 0; i < rowCount; i++)
{
    // Auto-fit row height for index i
    workSheet.AutoSizeRow(i);
}

// Save the autofitted workbook as a new file
workBook.SaveAs("autoResizeRows.xlsx"); // Result file

using IronXL;
// Load example spreadsheet
WorkBook workBook = WorkBook.Load("FinancialSample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;
var rowCount = workSheet.RowCount;

for (int i = 0; i < rowCount; i++)
{
    // Auto-fit row height for index i
    workSheet.AutoSizeRow(i);
}

// Save the autofitted workbook as a new file
workBook.SaveAs("autoResizeRows.xlsx"); // Result file

Imports IronXL
' Load example spreadsheet
Private workBook As WorkBook = WorkBook.Load("FinancialSample.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
Private rowCount = workSheet.RowCount

For i As Integer = 0 To rowCount - 1
	' Auto-fit row height for index i
	workSheet.AutoSizeRow(i)
Next i

' Save the autofitted workbook as a new file
workBook.SaveAs("autoResizeRows.xlsx") ' Result file

Imports IronXL
' Load example spreadsheet
Private workBook As WorkBook = WorkBook.Load("FinancialSample.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
Private rowCount = workSheet.RowCount

For i As Integer = 0 To rowCount - 1
	' Auto-fit row height for index i
	workSheet.AutoSizeRow(i)
Next i

' Save the autofitted workbook as a new file
workBook.SaveAs("autoResizeRows.xlsx") ' Result file

Codeerklärung

1. Zunächst laden wir die FinancialSample.xlsx mit der WorkBook.Load() Methode.
2. Wir holen uns die Gesamtzeilenanzahl.
3. Wir durchlaufen alle Zeilenindizes, um die Zeilenhöhen automatisch anzupassen.
4. Schließlich speichern wir die Ergebnisse in einer neuen Datei namens autoResizeRows.xlsx.

Ausgabedatei

Schritt 5: Stellen Sie die Spaltenbreite und Zeilenhöhe manuell mit IronXL ein

Zusätzlich zur automatischen Anpassung von Zeilen und Spalten bietet IronXL auch die Möglichkeit zum manuellen Einstellen der Breite und Höhe auf einen bestimmten Zeilenhöhenwert und einen spezifischen Spaltenbreitenwert.

Eingabe-Excel-Datei

using IronXL;
// Load example spreadsheet
WorkBook workBook = WorkBook.Load("FinancialSample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Manually set row height and column width
RangeRow row = workSheet.GetRow(0);
row.Height = 500; // Set height
RangeColumn col = workSheet.GetColumn(0);
col.Width = 5000; // Set width

// Save the workbook with specific values set
workBook.SaveAs("specificValue.xlsx");

using IronXL;
// Load example spreadsheet
WorkBook workBook = WorkBook.Load("FinancialSample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Manually set row height and column width
RangeRow row = workSheet.GetRow(0);
row.Height = 500; // Set height
RangeColumn col = workSheet.GetColumn(0);
col.Width = 5000; // Set width

// Save the workbook with specific values set
workBook.SaveAs("specificValue.xlsx");

Imports IronXL
' Load example spreadsheet
Private workBook As WorkBook = WorkBook.Load("FinancialSample.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Manually set row height and column width
Private row As RangeRow = workSheet.GetRow(0)
row.Height = 500 ' Set height
Dim col As RangeColumn = workSheet.GetColumn(0)
col.Width = 5000 ' Set width

' Save the workbook with specific values set
workBook.SaveAs("specificValue.xlsx")

Imports IronXL
' Load example spreadsheet
Private workBook As WorkBook = WorkBook.Load("FinancialSample.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Manually set row height and column width
Private row As RangeRow = workSheet.GetRow(0)
row.Height = 500 ' Set height
Dim col As RangeColumn = workSheet.GetColumn(0)
col.Width = 5000 ' Set width

' Save the workbook with specific values set
workBook.SaveAs("specificValue.xlsx")

Codeerklärung

1. Laden Sie die FinancialSample.xlsx mit der WorkBook.Load() Funktion.
2. Rufen Sie bestimmte Zeilen und Spalten ab, um deren Höhe und Breite manuell anzupassen.
3. Stellen Sie die gewünschte Höhe und Breite ein.
4. Speichern Sie die geänderte Datei unter dem Namen specificValue.xlsx.

Ausgabedatei

Lizenzierung

Erhalten Sie eine kostenlose Testversion, um alle Funktionen von IronXL 30 Tage lang kostenlos zu nutzen.

Die erhaltene Lizenz muss in der Datei appSettings.json platziert werden:

{
  "IronXL.License.LicenseKey": "myTrialKey"
}

{
  "IronXL.License.LicenseKey": "myTrialKey"
}

Abschluss

Mit Funktionen wie AutoSizeColumn und AutoSizeRow aus IronXL können Entwickler mühelos sicherstellen, dass Excel-Tabellen dynamisch auf den Inhalt reagieren, sei es importierte Daten, dynamische Berichte, nutzergenerierte Inhalte oder Ergebnisse der Datenanalyse.

Die Kompatibilität von IronXL mit verschiedenen .NET-Frameworks, einschließlich .NET Core und Azure, stellt sicher, dass Entwickler Excel-Automation in eine Vielzahl von Anwendungen integrieren können, ohne von Microsoft Office oder Excel Interop abhängig zu sein. Darüber hinaus macht die Unterstützung von IronXL für mehrere .NET-Sprachen und Plattformen es zu einer vielseitigen Wahl für Entwickler, die Excel-Manipulationsaufgaben in verschiedenen Umgebungen vereinfachen möchten.

Im Wesentlichen befähigt IronXL Entwickler, die Produktivität, Genauigkeit und Flexibilität in Excel-Automationsprojekten zu steigern, indem eine umfassende Suite von Funktionen angeboten wird, um den Anforderungen der modernen C#-Entwicklung gerecht zu werden. Ob es darum geht, Berichte zu erstellen, Daten zu analysieren oder Informationen zu präsentieren, bietet IronXL die notwendigen Werkzeuge, um in der Excel-Automation innerhalb des C#-Ecosystems zu glänzen.