Features

Features

Aspose.Cells FOSS for .NET is a pure managed .NET library for creating, reading, and modifying Excel XLSX spreadsheets. The entry point is the Workbook lớp, cung cấp quyền truy cập vào bảng tính, tên xác định và lưu / tải các hoạt động. trang này tổng hợp mỗi khu vực đặc điểm chính với ví dụ mã ngắn.

Workbook Create, Load và Save (Tạo, tải và lưu)

Tạo một cuốn sách làm việc mới với new Workbook().Tải một tệp XLSX hiện có bằng cách chuyển một đường file đến nhà xây dựng. LoadOptions để cho phép tải lỗi-tolerant. call Workbook.Save(path) để tiếp tục thay đổi.

using Aspose.Cells_FOSS;

// New workbook
var wb = new Workbook();
wb.Worksheets[0].Cells["A1"].PutValue("Hello");
wb.Save("output.xlsx");

// Load with repair options
var opts = new LoadOptions { TryRepairPackage = true, TryRepairXml = true };
try
{
    var loaded = new Workbook("input.xlsx", opts);
    Console.WriteLine(loaded.Worksheets[0].Cells["A1"].StringValue);
}
catch (WorkbookLoadException ex)
{
    Console.WriteLine("Load failed: " + ex.Message);
}

Dữ liệu và công thức cell

Sử dụng Cell.PutValue() để viết các dây, integers, decimals, booleans, và DateTime Giá trị Set Cell.Formula để gán một dòng công thức tương thích Excel. đọc lại hiển thị văn bản qua Cell.StringValue Giá trị nguyên chất thông qua Cell.Value.

var wb = new Workbook(); var ws = wb.Worksheets[0];

ws.Cells[“A1”].PutValue(“Qty”); ws.Cells[“B1”].PutValue(“Price”); ws.Cells[“C1”].PutValue(“Total”); ws.Cells[“A2”].PutValue(10); ws.Cells[“B2”].PutValue(4.99m); ws.Cells[“C2”].Formula = “=A2*B2”;

wb.Save(“data.xlsx”);

var loaded = new Workbook(“data.xlsx”); Console.WriteLine(loaded.Worksheets[0].Cells[“C2”].StringValue); // 49.9

---

### Cell phong cách

Đổi lại và sửa đổi các `Style` Đối với bất kỳ tế bào nào với `Cell.GetStyle()` và `Cell.SetStyle()`.The `Style` lớp cung cấp `Font` (Bóng, Ý, kích thước, tên), `ForegroundColor`, `Pattern` (Type của `FillPattern`), `HorizontalAlignment` ( Sử dụng `HorizontalAlignmentType`(c) và kiểm soát biên giới thông qua `Borders`.

var wb = new Workbook();
var cell = wb.Worksheets[0].Cells["A1"];
cell.PutValue("Styled Header");

var style = cell.GetStyle();
style.Font.Bold = true;
style.Font.Size = 14;
style.Pattern = FillPattern.Solid;
style.ForegroundColor = Color.FromArgb(255, 198, 239, 206);
style.HorizontalAlignment = HorizontalAlignmentType.Center;
cell.SetStyle(style);

wb.Save("styled.xlsx");

Formatting điều kiện

Worksheet.ConditionalFormattings Trở lại a ConditionalFormattingCollection.gọi điện Add() để tạo ra một quy tắc, sau đó AddCondition() Để thêm quy tắc sử dụng FormatConditionType và OperatorType.Các loại điều kiện được hỗ trợ bao gồm: CellValue, Expression, ColorScale, DataBar, và IconSet.

var wb = new Workbook(); var ws = wb.Worksheets[0]; for (var i = 0; i < 10; i++) ws.Cells[i, 0].PutValue(i + 1);

var ruleSet = ws.ConditionalFormattings[ws.ConditionalFormattings.Add()]; ruleSet.AddArea(CellArea.CreateCellArea(“A1”, “A10”)); var rule = ruleSet[ruleSet.AddCondition(FormatConditionType.CellValue, OperatorType.Between, “3”, “7”)]; var ruleStyle = rule.Style; ruleStyle.Pattern = FillPattern.Solid; ruleStyle.ForegroundColor = Color.FromArgb(255, 255, 199, 206); rule.Style = ruleStyle;

wb.Save(“cf.xlsx”);

---

### Data Validation thông tin

`Worksheet.Validations` Trở lại a `ValidationCollection`.gọi điện `Add(CellArea)` để tạo ra một `Validation` cho một ô phạm vi. thiết lập các `Type` Tài sản sử dụng `ValidationType` (`List`, `Decimal`,hoặc `Custom`• Thiết lập `Formula1`, `Formula2`, `Operator`, `InputTitle`, `InputMessage`, `ErrorTitle`, và `ErrorMessage`.

var listVal = ws.Validations[ws.Validations.Add(CellArea.CreateCellArea("A1", "A10"))];
listVal.Type = ValidationType.List;
listVal.Formula1 = "\"Open,Closed,Pending\"";
listVal.InCellDropDown = true;

var numVal = ws.Validations[ws.Validations.Add(CellArea.CreateCellArea("B1", "B10"))];
numVal.Type = ValidationType.Decimal;
numVal.Operator = OperatorType.Between;
numVal.Formula1 = "0";
numVal.Formula2 = "100";
numVal.ShowError = true;

wb.Save("validation.xlsx");

Tự động lọc

Worksheet.AutoFilter Hiển thị The AutoFilter Mục tiêu Set AutoFilter.Range để xác định phạm vi dòng đầu. Access AutoFilter.FilterColumns (một bộ sưu tập) và gọi điện thoại Add(columnIndex) để kích hoạt lọc trên một cột cụ thể.

ws.Cells[“A1”].PutValue(“Name”); ws.Cells[“B1”].PutValue(“Region”); ws.Cells[“C1”].PutValue(“Sales”); ws.Cells[“A2”].PutValue(“Alice”); ws.Cells[“B2”].PutValue(“North”); ws.Cells[“C2”].PutValue(1200);

ws.AutoFilter.Range = “A1:C1”; ws.AutoFilter.FilterColumns.Add(1);

wb.Save(“filter.xlsx”);

---

### Hyperlinks và tên định nghĩa

`Worksheet.Hyperlinks` là a `HyperlinkCollection`.gọi điện `Add()` để nhập URL bên ngoài, tham chiếu tế bào nội bộ hoặc liên kết mailto. `Hyperlink.TextToDisplay` và `Hyperlink.ScreenTip` Đối với người dùng-face text. `Workbook.DefinedNames` là a `DefinedNameCollection`;· gọi `Add(name, refersTo)` tạo ra những tên gọi.

ws.Cells["A1"].PutValue("Docs");
var link = ws.Hyperlinks[ws.Hyperlinks.Add("A1", 1, 1, "https://docs.aspose.org/cells/net/")];
link.TextToDisplay = "Documentation";

wb.DefinedNames[wb.DefinedNames.Add("DataRange", "Sheet1!$A$1:$D$10")].Comment = "Main data range";

wb.Save("links.xlsx");

Trang Setup

Worksheet.PageSetup kiểm soát các đường biên in, định hướng, kích thước giấy, khu vực in của tiêu đề/một cột, đầu, chân và khoảng trống trang. PageOrientationType và PaperSizeType Enum ạ.

var wb = new Workbook(); var ps = wb.Worksheets[0].PageSetup; ps.Orientation = PageOrientationType.Landscape; ps.PaperSize = PaperSizeType.PaperA4; ps.PrintArea = “$A$1:$H$50”; ps.CenterHeader = “My Report”; ps.CenterHorizontally = true; ps.AddHorizontalPageBreak(25);

wb.Save(“paged.xlsx”);

---

### Quản lý Worksheet

Thêm, đổi tên, ẩn và đặt lại các bảng tính thông qua `WorksheetCollection`. `WorksheetCollection.Add(name)` trả về chỉ số của bảng mới. Set `Worksheet.VisibilityType` Sử dụng `VisibilityType`.- Kết hợp các tế bào với `Cells.Merge()` và kiểm soát hàng / cột kích thước qua `Cells.Rows` và `Cells.Columns`.

var wb = new Workbook();
wb.Worksheets[0].Name = "Summary";
var dataIdx = wb.Worksheets.Add("Data");
wb.Worksheets[dataIdx].VisibilityType = VisibilityType.Hidden;
wb.Worksheets.ActiveSheetName = "Summary";

var ws = wb.Worksheets["Summary"];
ws.Cells["A1"].PutValue("Title");
ws.Cells.Merge(0, 0, 1, 4);
ws.Cells.Rows[0].Height = 30d;
ws.Cells.Columns[0].Width = 20d;

wb.Save("worksheets.xlsx");

Mẹo và Thực hành Tốt nhất

• Luôn bắt WorkbookLoadException khi tải các tập tin từ các con đường được cung cấp bởi người dùng.
• Sử dụng Cell.PutValue() với loại .NET chính xác bạn dự định lưu trữ — pass decimal Đối với tiền tệ, DateTime cho ngày.
• Read Cell.StringValue để hiển thị văn bản; sử dụng Cell.Value Khi bạn cần đối tượng .NET nguyên chất.
• Tạo các quy tắc định dạng điều kiện trên phạm vi rộng nhất bạn cần - quy luật mỗi lỗ là đắt tiền trong các bảng lớn.
• Call wb.Save() Một lần cuối cùng thay vì sau mỗi ô viết.

Các vấn đề thường gặp

FAQ

Aspose.Cells FOSS cho .NET có cần Microsoft Office không?

Thư viện là mã được quản lý tinh khiết mà không phụ thuộc vào Office, Excel hoặc COM Interop.

Các định dạng tệp nào được hỗ trợ?

CSV, ODS, PDF và XLS nhị phân không được hỗ trợ trong bản phát hành này.

Tôi có thể sử dụng thư viện này trong một ứng dụng thương mại không?

Có. Aspose.Cells FOSS được công bố theo Giấy phép MIT, cho phép sử dụng thương mại không giới hạn với không có tiền gửi.

Phiên bản .NET tối thiểu là gì?

.NET 6.0 hoặc hơn.

Làm thế nào để tôi áp dụng một màu nền cho một tế bào?

Set Đặt style.Pattern = FillPattern.Solid và style.ForegroundColor = Color.FromArgb(...),Sau đó gọi cell.SetStyle(style).

Tóm tắt Tham chiếu API

See Also

• Aspose.Cells for .NET — Enterprise Documentation