如何使用IronXL在 C# 中設定單元格邊框和對齊方式:編輯Excel C
使用IronXL進行編輯Excel C#,在 C# Excel 檔案中設定儲存格邊框和文字對齊方式,直接將邊框類型(如 MediumDashed)和對齊屬性(如 HorizontalAlignment.Center)套用於工作表儲存格,而無需依賴 Microsoft Interop。
在 Excel 中,儲存格邊框是指可以套用於單一儲存格或儲存格群組的線條或邊框,而文字對齊是指儲存格內文字的垂直和水平位置。 IronXL提供了一個全面的 API,用於處理 Excel 單元格樣式,使您可以以程式設計方式精確控制這些視覺元素。
快速入門:一次通話即可設定單元格邊框和文字居中對齊
為文字的一側添加邊框樣式,並將文字水平置中排列在兩行中。 快速啟動並運行,無需互通開銷。
-
使用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 屬性新增邊框,自訂選定儲存格、列、行或區域的外觀。 從 IronXL.Styles.BorderType 枚舉中提供的各種樣式中進行選擇。 瀏覽所有可用的邊框類型,找到最合適的款式。
若要實現精確的文字對齊,請在樣式中調整 HorizontalAlignment 和 VerticalAlignment 屬性,以達到所需的佈局。 使用 IronXL.Styles.HorizontalAlignment 和 IronXL.Styles.VerticalAlignment 枚舉來設定所需的對齊方式。 探索所有可用的對齊方式,完美呈現您的數據。 這種方法在建立需要統一格式的專業電子表格時尤其有用。
在套用邊框和對齊方式之前,請確保已正確載入 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中的文字對齊功能可全面控制儲存格內內容的定位方式。 當需要將資料匯出為不同格式,並保持視覺一致性時,此功能尤其重要。 對齊系統與其他格式設定功能(如字型樣式)搭配使用,可建立外觀專業的電子表格。
下圖展示了IronXL提供的所有對齊選項:
水平對齊枚舉
General: 常規水平對齊。 文字資料左對齊。 數字、日期和時間均右對齊。 布林類型居中顯示。 更改對齊方式不會影響資料類型。 這是未設定特定對齊方式時的預設對齊方式。Left: 即使在從右到左的模式下,水平方向也保持左對齊。 將內容對齊到單元格的左邊緣。 如果指定了縮排量,則儲存格的內容將從左側縮排指定的字元空格數。Center: 水平居中對齊。 文字在儲存格中會居中顯示。 這通常用於標題和標頭。Right: 右對齊水平對齊。 即使在從右到左的模式下,儲存格內容也會與儲存格的右邊緣對齊。 這通常用於數值資料的呈現。Fill: 儲存格值填滿整個寬度。 如果右側相鄰單元格也具有相同的填充對齊方式,則它們也會被填充。 附加規則:- 只能附加完整的值,不能附加部分值。
- 列寬不會"最佳適應"填滿值。
- 如果要新增的額外值超出儲存格的左右邊界,則不會新增該值。
- 填滿的是儲存格的顯示值,而不是其底層的原始數值。
Justify: 兩端對齊(左右齊平)水平對齊。 將文字自動換行套用到儲存格,並確保每一行的第一個單字與儲存格的左邊緣對齊,最後一個單字與儲存格的右邊緣對齊(最後一行除外)。 這對於包含段落的文本密集型單元格尤其有用。CenterSelection: 將最左側儲存格的內容水平置中至多個儲存格的中心。 它在視覺上看起來類似於合併細胞,但實際上並沒有合併它們。 使用此選項有助於防止合併儲存格可能出現的潛在問題。Distributed: 單元格內每行文字中的每個"單字"均勻分佈在單元格的寬度上,左右邊緣齊平。 如果需要套用縮排值,則儲存格的左右兩側都會填入該縮排值。
垂直對齊枚舉
None: 預設對齊方式,通常會導致底部對齊行為。Top: 將內容對齊到儲存格頂部。 適用於內容高度不一的儲存格。Center: 在儲存格內垂直置中顯示內容。 這樣可以營造出平衡的視覺效果,尤其是在與水平居中結合時。Bottom: 將內容對齊到儲存格底部。 這是大多數電子表格應用程式的標準行為。Justify: 將文字行均勻分佈在儲存格的高度上,上下邊距齊平。 其工作原理類似於水平對齊,透過自動換行並調整行間距來填滿整行高度。Distributed: 將每行文字中的每個"單字"均勻分佈在儲存格的高度上,水平文字方向上的頂部和底部邊距齊平。 在垂直文字方向上,它的行為與分佈式水平對齊完全相同,將文字行從上到下均勻分佈。
使用對齊設定時,請考慮它們如何與其他單元格屬性互動。 例如,當您自動調整行和列的大小時,對齊設定會影響內容在自動調整大小的儲存格中的顯示方式。 同樣,在使用公式時,正確的對齊方式可以使電子表格計算更易於閱讀、更專業。
常見問題解答
不使用 Microsoft Office,如何在 C# 中為 Excel 單元格添加邊框?
您可以使用 IronXL.Excel 的 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 等選項。您可以將這些樣式套用到儲存格的任何一邊 (上、右、下、左),以建立外觀專業的試算表。
如何以程式化方式將 Excel 單元格中的文字居中?
要使用 IronXL 使 Excel 單元格中的文字居中,請將 Style.HorizontalAlignment 屬性設定為 IronXL.Styles.HorizontalAlignment.Center。您也可以使用 VerticalAlignment 屬性控制垂直對齊,以獲得完整的文字定位控制。
我可以一次對多個儲存格套用邊框和對齊方式嗎?
是的,IronXL 允許您對整個範圍、列或行套用邊框和對齊方式。只需選取所需的範圍,套用樣式屬性即可同時格式化多個儲存格,讓大量格式化作業變得更有效率。
如何在 C# 中為 Excel 單元格設定邊框顏色?
IronXL 可讓您使用預先定義的顏色類型或自訂的 Hex 顏色碼設定邊框顏色。透過樣式物件存取邊框顏色屬性,自訂儲存格邊框的外觀。
添加邊框和居中文字所需的最少代碼是多少?
使用 IronXL,您只需兩行即可新增邊框和居中文字:workSheet["B2「].Style.LeftBorder.Type = IronXL.Styles.BorderType.MediumDashed; 以及 workSheet[」B2"].Style.HorizontalAlignment = IronXL.Styles.HorizontalAlignment.Center; 這可提供快速格式化,且無需 Interop 開銷。

