Mit IronXL Zellen in C# zusammenführen und trennen

Beispiel zum Zusammenführen von Zellen

Die Merge-Methode kann genutzt werden, um einen Zellbereich zusammenzuführen. Dieser Prozess kombiniert die Zellen, ohne bestehende Werte oder Daten zu löschen, obwohl nur der Wert der ersten Zelle im zusammengeführten Bereich angezeigt wird. Die Werte der zusammengeführten Zellen bleiben jedoch in IronXL zugänglich.

Das folgende Codebeispiel zeigt, wie ein Zellbereich durch Angabe ihrer Adressen zusammengeführt wird.

:path=/static-assets/excel/content-code-examples/how-to/csharp-excel-merge-cells-merge.cs

using IronXL;

WorkBook workBook = WorkBook.Load("sample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

var range = workSheet["B2:B5"];

// Merge cells B7 to E7
workSheet.Merge("B7:E7");

// Merge selected range
workSheet.Merge(range.RangeAddressAsString);

workBook.SaveAs("mergedCell.xlsx");

Imports IronXL

Private workBook As WorkBook = WorkBook.Load("sample.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

Private range = workSheet("B2:B5")

' Merge cells B7 to E7
workSheet.Merge("B7:E7")

' Merge selected range
workSheet.Merge(range.RangeAddressAsString)

workBook.SaveAs("mergedCell.xlsx")

Demonstration

Beispiel für das Abrufen zusammengeführter Bereiche

Das Abrufen von zusammengeführten Bereichen ist eine nützliche Funktion, um den angezeigten Wert in Software zur Tabellendarstellung wie Microsoft Excel zu identifizieren. Um eine Liste zusammengeführter Bereiche zu erhalten, können Sie die GetMergedRegions-Methode nutzen.

:path=/static-assets/excel/content-code-examples/how-to/csharp-excel-merge-cells-retrieve-merged-regions.cs

using IronXL;
using System.Collections.Generic;
using System;

WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Apply merge
workSheet.Merge("B4:C4");
workSheet.Merge("A1:A4");
workSheet.Merge("A6:D9");

// Retrieve merged regions
List<IronXL.Range> retrieveMergedRegions = workSheet.GetMergedRegions();

foreach (IronXL.Range mergedRegion in retrieveMergedRegions)
{
    Console.WriteLine(mergedRegion.RangeAddressAsString);
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Beispiel zum Aufheben von Zellzusammenführungen

Das Aufheben von zusammengeführten Bereichen kann auf zwei verschiedene Arten durchgeführt werden. Die erste und einfachste Methode besteht darin, die Zelladressen anzugeben, wie z. B. B3:B6, um die Zusammenführung aufzuheben.

Alternativ können Sie Zellen auch basierend auf dem Index des zusammengeführten Bereichs aufheben. Die zusammengeführten Bereiche sind in chronologischer Reihenfolge aufgelistet. Dazu können Sie zuerst die zusammengeführten Bereiche abrufen und den gewünschten Index an die Unmerge-Methode übergeben.

:path=/static-assets/excel/content-code-examples/how-to/csharp-excel-merge-cells-unmerge.cs

using IronXL;

WorkBook workBook = WorkBook.Load("mergedCell.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Unmerge the merged region of B7 to E7
workSheet.Unmerge("B7:E7");

workBook.SaveAs("unmergedCell.xlsx");

Imports IronXL

Private workBook As WorkBook = WorkBook.Load("mergedCell.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Unmerge the merged region of B7 to E7
workSheet.Unmerge("B7:E7")

workBook.SaveAs("unmergedCell.xlsx")

Demonstration