如何设置 Excel 中的单元格边框和对齐 | IronXL

如何使用 IronXL 在 C# 中设置单元格边框和对齐方式

This article was translated from English: Does it need improvement?
Translated
View the article in English

在 Excel 中,单元格边框是指可以应用于单个单元格或单元格组的线条或边框,而文本对齐是指单元格内文本的垂直和水平位置。

快速入门:一次调用即可设置单元格边框和居中文本对齐

在 IronXL 中设置单元格格式非常简单:只需两行简单的代码,即可为单元格的一侧应用边框样式,并将文本水平居中。 快速启动并运行,无需互操作开销。

Nuget Icon立即开始使用 NuGet 创建 PDF 文件:

  1. 使用 NuGet 包管理器安装 IronXL

    PM > Install-Package IronXL.Excel

  2. 复制并运行这段代码。

    workSheet["B2"].Style.LeftBorder.Type = IronXL.Styles.BorderType.MediumDashed;
    workSheet["B2"].Style.HorizontalAlignment = IronXL.Styles.HorizontalAlignment.Center;
  3. 部署到您的生产环境中进行测试

    立即开始在您的项目中使用 IronXL,免费试用!
    arrow pointer


开始使用 IronXL

今天在您的项目中使用 IronXL,免费试用。

第一步:
green arrow pointer


设置单元格边框和对齐方式示例

使用TopBorderRightBorderBottomBorderLeftBorder属性添加边框,可以自定义所选单元格、列、行或区域的外观。 从IronXL.Styles.BorderType枚举中提供的各种样式中进行选择。 浏览所有可用的边框类型,找到最合适的款式。

为了实现精确的文本对齐,请在样式中调整HorizontalAlignmentVerticalAlignment属性,以达到所需的布局。 使用IronXL.Styles.HorizontalAlignment ntalAlignment 和IronXL.Styles.VerticalAlignment枚举来设置所需的对齐方式。 探索所有可用的对齐方式,完美呈现您的数据。

: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")
$vbLabelText   $csharpLabel
边界和对齐

设置单元格边框和对齐方式高级示例

边框颜色

默认情况下,边框颜色为黑色,但您可以将其自定义为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")
$vbLabelText   $csharpLabel
边框颜色

边框线和图案

总共有六个边界线位置,每个位置都呈现出多种图案或类型。这些位置包括上、右、下、左,以及向前、向后和双向的对角线。

: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")
$vbLabelText   $csharpLabel

边界线

可用的边界线

边框图案

可用的边框类型

对齐类型

下图展示了IronXL提供的所有对齐选项:

可用的对齐类型

水平对齐枚举

  • General :常规水平对齐方式。 文本数据左对齐。 数字、日期和时间右对齐,布尔类型居中对齐。 更改对齐方式不会影响数据类型。
  • Left :即使在从右到左的模式下,水平对齐方式也为左对齐。 将内容对齐到单元格的左边缘。 如果指定了缩进量,则单元格的内容将从左侧缩进指定的字符空格数。
  • Center :水平居中对齐,意味着文本在单元格中居中。
  • Right :水平方向右对齐,这意味着即使在从右到左的模式下,单元格内容也会与单元格的右边缘对齐。
  • Fill :单元格的值将填充到整个宽度。 如果右侧相邻单元格也具有相同的填充对齐方式,则它们也会被填充。 附加规则:
    • 只能附加整数值,不能附加部分值。
    • 列宽不会"最佳适应"填充值。
    • 如果要添加的额外值超出单元格的左右边界,则不会添加该值。
    • 填充的是单元格的显示值,而不是其底层的原始数值。
  • Justify :水平两端对齐(左右齐平)。 将文本自动换行应用于单元格,并确保每一行的第一个单词与单元格的左边缘对齐,最后一个单词与单元格的右边缘对齐(最后一行除外)。
  • CenterSelection :将最左侧单元格的内容水平居中于多个单元格的中心。 它在视觉上看起来类似于合并细胞,但实际上并没有合并它们。 使用此选项有助于防止合并单元格可能出现的潜在问题。
  • Distributed :单元格内每行文本中的每个"单词"均匀分布在单元格的宽度上,左右边缘齐平。 如果需要应用缩进值,则单元格的左右两侧都会按缩进值进行填充。

垂直对齐枚举

  • None :默认对齐方式。
  • Top :将内容对齐到单元格顶部。
  • Center :使单元格内的内容垂直居中。
  • Bottom :将内容对齐到单元格底部。
  • Justify :将文本行均匀分布在单元格的高度上,上下边距齐平。 其工作原理类似于水平对齐,通过自动换行并调整行间距来填充整行高度。
  • Distributed :将每行文本中的每个"单词"均匀分布在单元格的高度上,水平文本方向上的顶部和底部边距齐平。 在垂直文本方向上,它的行为与分布式水平对齐完全相同,将文本行从上到下均匀分布。

常见问题解答

如何使用 C# 在 Excel 中设置单元格边框?

要在 Excel 中使用 C# 设置单元格边框,可以使用 IronXL 的属性,如 TopBorderRightBorderBottomBorderLeftBorder。使用 Color 类或十六进制代码自定义每一边的不同 BorderType 和颜色。

使用 C# 在 Excel 单元格中对齐文本有哪些方法?

IronXL 允许您通过使用 HorizontalAlignmentVerticalAlignment 属性设置 Excel 单元格中的文本对齐。您可以从选项中选择 LeftCenterRightTopCenterBottom 来实现精确的数据呈现。

如何使用 C# 将不同的边框样式应用于 Excel 单元格?

IronXL 提供一系列边框样式,如 ThinDoubleDashedDottedSolid。您可以将这些样式应用于单元格的每一边,以增强电子表格的外观。

能否解释如何使用 C# 库自定义 Excel 中的边框颜色?

是的,使用 IronXL,您可以通过使用十六进制颜色代码或预定义颜色类型设置 Color 属性轻松自定义边框颜色,全面掌控电子表格的美学。

在 C# 中自定义 Excel 工作簿后保存的流程是什么?

在使用 IronXL 自定义单元格边框和对齐后,您可以使用 SaveAs 方法保存工作簿,指定所需的文件名和格式,确保更改得到保存。

在 C# Excel 库中,'Fill' 对齐如何工作?

在 IronXL 中,'Fill' 对齐会将单元格内容拉伸以填满单元格的整个宽度。如果相邻单元格也具有 'Fill' 对齐,内容将延伸到那些单元格,创建无缝外观。

使用 IronXL 进行 Excel 操作在 C# 中有什么优势?

在 C# 中使用 IronXL 进行 Excel 操作提供了许多优势,包括增强的数据可视化、更好的可读性,以及无需依赖 Excel Interop 即可创建专业外观的电子表格。

在使用 C# 为 Excel 设置边框时,如何排除常见问题?

常见问题可能包括边框应用不当或颜色不匹配。确保正确设置 BorderTypeColor 属性。使用 IronXL 时,请仔细检查您的十六进制代码和属性分配。

什么是 'Justify' 垂直对齐,以及如何在 C# 中使用?

IronXL 中的 'Justify' 垂直对齐将文本均匀分布在单元格的整个高度,并具有上下边距,类似于水平对齐,提供整齐且平衡的外观。

Chaknith Bin
软件工程师
Chaknith 在 IronXL 和 IronBarcode 工作。他在 C# 和 .NET 方面有着深厚的专业知识,帮助改进软件并支持客户。他从用户互动中获得的见解有助于更好的产品、文档和整体体验。
准备开始了吗?
Nuget 下载 1,738,553 | Version: 2025.11 刚刚发布