如何在 C# 中使用 IronXL 設定儲存格邊框與對齊方式
透過 IronXL 在 C# Excel 檔案中設定儲存格邊框與文字對齊方式,無需依賴 Microsoft Interop,即可直接將邊框類型(如 MediumDashed)及對齊屬性(如 HorizontalAlignment.Center)套用至工作表儲存格。
在 Excel 中,儲存格邊框是指可套用至單一儲存格或儲存格群組的線條或邊框;而文字對齊則指文字在儲存格內的垂直與水平定位方式。 IronXL 提供一套用於處理 Excel 儲存格樣式的完整 API,讓您能夠精確地透過程式控制這些視覺元素。
快速入門:單行呼叫即可設定儲存格邊框與文字居中對齊
請在兩行內,為其中一側套用邊框樣式,並將文字水平居中對齊。 無需 Interop 開銷,即可快速上手。
-
using NuGet 套件管理員安裝 https://www.nuget.org/packages/IronXL.Excel
PM > Install-Package IronXL.Excel -
請複製並執行此程式碼片段。
workSheet["B2"].Style.LeftBorder.Type = IronXl.Styles.BorderType.MediumDashed; workSheet["B2"].Style.HorizontalAlignment = IronXl.Styles.HorizontalAlignment.Center; -
部署至您的生產環境進行測試
立即透過免費試用,在您的專案中開始使用 IronXL
簡化工作流程(5 個步驟)
- 下載 C# 函式庫以設定背景圖案與顏色
- 開啟現有或建立新的 Excel 試算表
- 將邊框的 Type 屬性設定為 BorderType 中可用的邊框類型之一
- 使用 HorizontalAlignment 和 VerticalAlignment 屬性進行水平或垂直對齊
- 從可用類型或十六進位色碼中設定邊框顏色
立即開始使用 IronXL
如何在基本範例中設定儲存格邊框與文字對齊方式?
透過使用 BottomBorder 及 LeftBorder 屬性新增邊框,自訂選取的儲存格、欄位、列或範圍的外觀。 請從 [BorderType] 枚舉中選擇各種可用風格。 探索所有可用的邊框類型,找到最完美的搭配。
IronXl.Styles.BorderType HorizontalAlignment VerticalAlignment IronXl.Styles.HorizontalAlignment IronXl.Styles.VerticalAlignment
為精確對齊文字,請調整 Style 中的 [HorizontalAlignment] 和 [VerticalAlignment] 屬性,以達到所需的版面配置。 請使用 [HorizontalAlignment] 和 [VerticalAlignment] 枚舉來設定所需的對齊方式。 探索所有可用的對齊類型,完美呈現您的資料。 此方法在製作需要格式一致性的Professional試算表時特別有用。
在套用邊框與對齊方式之前,請確保已正確載入您的 Excel 工作簿。 以下是一個完整範例,展示基本的邊框與對齊設定:
:path=/static-assets/excel/content-code-examples/how-to/border-alignment-set-border-alignment.cs
using IronXL;
using IronXL.Styles;
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;
workSheet["B2"].Value = "B2";
// Set cell border
workSheet["B2"].Style.LeftBorder.Type = BorderType.MediumDashed;
workSheet["B2"].Style.RightBorder.Type = BorderType.MediumDashed;
// Set text alignment
workSheet["B2"].Style.HorizontalAlignment = HorizontalAlignment.Center;
workBook.SaveAs("setBorderAndAlignment.xlsx");
Imports IronXL
Imports IronXL.Styles
Private workBook As WorkBook = WorkBook.Create()
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
Private workSheet("B2").Value = "B2"
' Set cell border
Private workSheet("B2").Style.LeftBorder.Type = BorderType.MediumDashed
Private workSheet("B2").Style.RightBorder.Type = BorderType.MediumDashed
' Set text alignment
Private workSheet("B2").Style.HorizontalAlignment = HorizontalAlignment.Center
workBook.SaveAs("setBorderAndAlignment.xlsx")
有哪些進階邊框與對齊選項可用?
如何自訂邊框顏色?
預設邊框顏色為黑色,但您可以自訂為 Color 類別中任何可用的顏色,或使用十六進位色碼。 若要設定邊框顏色,請使用 [Color] 屬性並指定所需顏色或十六進位色碼。 此外,[Color] 屬性可讓您取得邊框的顏色。 這種靈活性類似於您可以為儲存格設定背景顏色。
邊框顏色的自訂功能可與其他儲存格格式設定功能無縫整合。 結合條件格式設定功能,您可以建立動態視覺提示,協助使用者快速辨識試算表中的重要資料模式。
:path=/static-assets/excel/content-code-examples/how-to/border-alignment-set-border-color.cs
using IronXL;
using IronXL.Styles;
using IronSoftware.Drawing;
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;
workSheet["B2"].Style.LeftBorder.Type = BorderType.Thick;
workSheet["B2"].Style.RightBorder.Type = BorderType.Thick;
// Set cell border color
workSheet["B2"].Style.LeftBorder.SetColor(Color.Aquamarine);
workSheet["B2"].Style.RightBorder.SetColor("#FF7F50");
workBook.SaveAs("setBorderColor.xlsx");
Imports IronXL
Imports IronXL.Styles
Imports IronSoftware.Drawing
Private workBook As WorkBook = WorkBook.Create()
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
Private workSheet("B2").Style.LeftBorder.Type = BorderType.Thick
Private workSheet("B2").Style.RightBorder.Type = BorderType.Thick
' Set cell border color
workSheet("B2").Style.LeftBorder.SetColor(Color.Aquamarine)
workSheet("B2").Style.RightBorder.SetColor("#FF7F50")
workBook.SaveAs("setBorderColor.xlsx")
我可以套用哪些邊框位置與樣式?
總計有六種邊框位置,每種位置皆提供多種樣式或類型。這些位置包括頂部、右側、底部、左側,以及向前、向後和雙向移動的對角線。 這套全面的選項讓您能夠建立複雜的視覺佈局,效果類似於合併儲存格時所能達成的效果,但具備更大的靈活性。
處理對角線邊框時,請理解其與儲存格內容及對齊設定的互動方式。 對角線邊框在 Excel 報表中用於建立標題區塊或視覺分隔線時,特別實用。
:path=/static-assets/excel/content-code-examples/how-to/border-alignment-set-border-line.cs
using IronXL;
using IronXL.Styles;
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;
workSheet["B2"].StringValue = "Top";
workSheet["B4"].StringValue = "Forward";
// Set top border line
workSheet["B2"].Style.TopBorder.Type = BorderType.Thick;
// Set diagonal border line
workSheet["B4"].Style.DiagonalBorder.Type = BorderType.Thick;
// Set diagonal border direction
workSheet["B4"].Style.DiagonalBorderDirection = DiagonalBorderDirection.Forward;
workBook.SaveAs("borderLines.xlsx");
Imports IronXL
Imports IronXL.Styles
Private workBook As WorkBook = WorkBook.Create()
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
Private workSheet("B2").StringValue = "Top"
Private workSheet("B4").StringValue = "Forward"
' Set top border line
Private workSheet("B2").Style.TopBorder.Type = BorderType.Thick
' Set diagonal border line
Private workSheet("B4").Style.DiagonalBorder.Type = BorderType.Thick
' Set diagonal border direction
Private workSheet("B4").Style.DiagonalBorderDirection = DiagonalBorderDirection.Forward
workBook.SaveAs("borderLines.xlsx")
對於較複雜的邊框情境,建議建立一個可重複使用的函式,用以在多個儲存格或範圍中套用一致的邊框樣式:
void ApplyUniformBorder(WorkSheet sheet, string range, BorderType borderType, Color borderColor)
{
var cells = sheet[range];
// Apply borders to all sides
cells.Style.TopBorder.Type = borderType;
cells.Style.RightBorder.Type = borderType;
cells.Style.BottomBorder.Type = borderType;
cells.Style.LeftBorder.Type = borderType;
// Apply color to all borders
cells.Style.TopBorder.SetColor(borderColor);
cells.Style.RightBorder.SetColor(borderColor);
cells.Style.BottomBorder.SetColor(borderColor);
cells.Style.LeftBorder.SetColor(borderColor);
}
// Usage example
ApplyUniformBorder(workSheet, "A1:D4", BorderType.Thin, Color.Black);
void ApplyUniformBorder(WorkSheet sheet, string range, BorderType borderType, Color borderColor)
{
var cells = sheet[range];
// Apply borders to all sides
cells.Style.TopBorder.Type = borderType;
cells.Style.RightBorder.Type = borderType;
cells.Style.BottomBorder.Type = borderType;
cells.Style.LeftBorder.Type = borderType;
// Apply color to all borders
cells.Style.TopBorder.SetColor(borderColor);
cells.Style.RightBorder.SetColor(borderColor);
cells.Style.BottomBorder.SetColor(borderColor);
cells.Style.LeftBorder.SetColor(borderColor);
}
// Usage example
ApplyUniformBorder(workSheet, "A1:D4", BorderType.Thin, Color.Black);
Option Strict On
Sub ApplyUniformBorder(sheet As WorkSheet, range As String, borderType As BorderType, borderColor As Color)
Dim cells = sheet(range)
' Apply borders to all sides
cells.Style.TopBorder.Type = borderType
cells.Style.RightBorder.Type = borderType
cells.Style.BottomBorder.Type = borderType
cells.Style.LeftBorder.Type = borderType
' Apply color to all borders
cells.Style.TopBorder.SetColor(borderColor)
cells.Style.RightBorder.SetColor(borderColor)
cells.Style.BottomBorder.SetColor(borderColor)
cells.Style.LeftBorder.SetColor(borderColor)
End Sub
' Usage example
ApplyUniformBorder(workSheet, "A1:D4", BorderType.Thin, Color.Black)
邊界線
邊框圖案
支援哪些文字對齊選項?
IronXL 的文字對齊功能可全面控制內容在儲存格內的定位方式。 此功能在將資料匯出至不同格式時尤為重要,此時維持視覺一致性至關重要。 對齊系統會與字型樣式等其他格式設定功能配合使用,以建立外觀專業的試算表。
Color Color
HorizontalAlignment 枚舉
General:一般對齊(水平對齊)。 文字資料應左對齊。 數字、日期和時間均應右對齊。 布林型別會居中顯示。 變更對齊方式不會影響資料類型。 此為未設定特定對齊方式時的預設對齊方式。Left:即使在由右至左模式下,仍保持左對齊的水平對齊方式。 將內容對齊至儲存格的左邊緣。 若指定了縮排量,儲存格的內容將從左側向右縮排指定數量的字元空格。Center:水平居中對齊。 文字在儲存格中居中對齊。 此格式通常用於標題和副標題。Right:右對齊的水平對齊方式。 儲存格內容會對齊於儲存格的右邊緣,即使在由右至左模式下亦然。 這通常用於數值資料的呈現。Fill:儲存格值會填滿整個寬度。 若右側相鄰儲存格亦採用相同的填充對齊方式,這些儲存格也會被填滿。 其他規範:- 僅可追加完整數值,不可追加部分數值。
- 欄位寬度不會自動調整以"最佳貼合"已填入的數值。
- 若追加該值的內容會超出儲存格左右邊界,則不會被加入。
- 填入的是儲存格的顯示值,而非底層的原始數值。
Justify:兩端對齊(左右對齊)的水平排版。 將"文字換行"功能套用至儲存格,並確保每行文字的第一个字與儲存格左邊緣對齊,最後一個字與右邊緣對齊(最後一行除外)。 這對於包含段落的文字密集型儲存格特別有用。CenterSelection:將最左側儲存格的內容水平居中對齊,使其在多個儲存格中居中顯示。 其視覺效果類似於合併儲存格,但實際上並未進行合併。 使用此選項有助於避免因合併儲存格而可能引發的潛在問題。Distributed:儲存格內每行文字中的每個"WORD"均均勻分布於儲存格寬度,左右邊界均對齊。 若需套用縮排值,儲存格的左右兩側均會以該縮排值進行填充。
VerticalAlignment 枚舉
None:預設對齊方式,通常會呈現底部對齊的行為。Top:將內容對齊至儲存格頂端。 適用於內容高度不一的儲存格。Center:將儲存格內的內容垂直居中。 這能營造出平衡的視覺效果,尤其在搭配水平居中對齊時更是如此。Bottom:將內容對齊至儲存格底部。 這是大多數試算表應用程式的標準行為。Justify:將文字行均勻分佈於儲存格的高度範圍內,並使上下邊距與邊緣對齊。 其運作方式類似於水平對齊,透過換行及調整行間距,使文字填滿整行高度。Distributed:將每行文字中的每個"WORD"均勻分佈於儲存格的高度範圍內,並在水平文字方向上使上下邊距與邊緣對齊。 在垂直文字方向下,其行為與水平均等對齊完全相同,會將文字行從上至下均勻分布。
處理對齊設定時,請考量其與其他儲存格屬性的互動方式。 例如,當您自動調整行與列的大小時,對齊設定將影響內容在自動調整大小的儲存格中的排列方式。 同樣地,在處理公式時,適當的對齊方式能讓您的試算表計算結果更易於閱讀且更顯Professional。
常見問題
如何在不使用 Microsoft Office 的情況下,透過 C# 為 Excel 儲存格添加邊框?
您可以使用 IronXL 的 Style API 為 Excel 儲存格添加邊框。只需存取儲存格的 Style 屬性,並透過 LeftBorder.Type、RightBorder.Type、TopBorder.Type 和 BottomBorder.Type 等屬性設定邊框類型(例如 MediumDashed)。IronXL 可獨立運作,無需依賴 Microsoft Office 或 Interop。
在 C# 中,Excel 儲存格有哪些邊框樣式可用?
IronXL 透過 IronXl.Styles.BorderType 枚舉提供多種邊框樣式,包括 MediumDashed、Thin、Thick、Double 等選項。您可以將這些樣式套用至儲存格的任何邊緣(頂部、右側、底部、左側),以建立外觀 Professional 的試算表。
如何透過程式碼將文字置於 Excel 儲存格中央?
若要使用 IronXL 將文字置於 Excel 儲存格中央,請將 Style.HorizontalAlignment 屬性設定為 IronXl.Styles.HorizontalAlignment.Center。您亦可透過 VerticalAlignment 屬性控制垂直對齊,以實現完整的文字定位控制。
我可以一次對多個儲存格套用邊框和對齊方式嗎?
是的,IronXL 允許您對整個範圍、欄位或列套用邊框與對齊方式。只需選取目標範圍,並套用「樣式」屬性即可同時格式化多個儲存格,使批量格式化操作更為高效。
如何在 C# 中設定 Excel 儲存格的邊框顏色?
IronXL 允許您使用預定義的顏色類型或自訂的十六進位色碼來設定邊框顏色。透過 Style 物件存取邊框顏色屬性,即可自訂儲存格邊框的外觀。
要為文字添加邊框並居中對齊,需要多少最少的程式碼?
透過 IronXL,您只需兩行程式碼即可添加邊框並將文字居中:workSheet["B2"].Style.LeftBorder.Type = IronXl.Styles.BorderType.MediumDashed; 以及 workSheet["B2"].Style.HorizontalAlignment = IronXl.Styles.HorizontalAlignment.Center; 這能提供快速格式化功能,且無需承受 Interop 的額外負擔。

