Các tính năng chính của Aspose.Cells FOSS cho .NET

Introduction

Aspose.Cells FOSS for .NET is a pure managed-code, MIT-licensed library for reading, writing, - Sử dụng Excel .xlsx sổ làm việc mà không có bất kỳ sự phụ thuộc Microsoft Office. cài đặt như: Các Aspose.Cells_FOSS NuGet gói, nó tích hợp vào bất kỳ dự án .NET - các ứng dụng console, web APIs, nhân viên nền và chức năng không có máy chủ.

Bài viết này cung cấp hướng dẫn chi tiết tính năng theo tính năng của API công cộng, cho thấy những gì có thể làm và cách gọi mỗi khả năng từ mã C#.

Tổng quan tính năng

Vòng đời Workbook và Worksheet

Điểm đầu cho mỗi hoạt động là Workbook Thẻ: Xây dựng một từ scratch với new Workbook(),hoặc tải một hiện có .xlsx Với new Workbook(filePath) hoặc new Workbook(stream).- Navigate sheets via thông qua Workbook.Worksheets, Set Worksheet.Name và Worksheet.VisibilityType,Và tiếp tục với Workbook.Save().Đối với các file bị hư hại, hãy chuyển qua một LoadOptions Ví dụ với TryRepairPackage = true và TryRepairXml = true.

using Aspose.Cells_FOSS;

var options = new LoadOptions
{
    TryRepairPackage = true,
    TryRepairXml = true,
};

try
{
    _ = new Workbook("sample.xlsx", options);
}
catch (WorkbookLoadException exception)
{
    Console.WriteLine(exception.Message);
}

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

Viết giá trị cho các tế bào với Cell.PutValue() - Tăng tải chấp nhận string, int, double, decimal, bool, và DateTime.Đọc giá trị trở lại qua Cell.Value, Cell.StringValue, và Cell.Formula.- Thiết lập các công thức Excel với Cell.Formula - Tính chất; công thức string là được bảo tồn trên tiết kiệm và sống sót một chu kỳ tải lại.

var workbook = new Workbook(); var sheet = workbook.Worksheets[0]; sheet.Cells[“A1”].PutValue(“Hello”); sheet.Cells[“B1”].PutValue(123); sheet.Cells[“C1”].Formula = “=B1*2”;

workbook.Save(“hello.xlsx”);

var loaded = new Workbook(“hello.xlsx”); Console.WriteLine(loaded.Worksheets[0].Cells[“C1”].Formula); Console.WriteLine(loaded.Worksheets[0].Cells[“C1”].StringValue);

### Định dạng ô

Apply `Style` Các đối tượng để kiểm soát chữ cái, lấp đầy, giới hạn, định dạng số và phù hợp. Tạo lại phong cách hiện tại với `Cell.GetStyle()`,thay đổi nó, sau đó cam kết với `Cell.SetStyle()`.Đối với nền lấp đầy, set `Style.Pattern = FillPattern.Solid` và trao một `Color` để `Style.ForegroundColor`.Sử dụng `Cells.Merge()` để span cell ranges.

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

var style = cell.GetStyle();
style.Font.Bold = true;
style.Pattern = FillPattern.Solid;
style.ForegroundColor = Color.FromArgb(255, 241, 196, 15);
cell.SetStyle(style);

Console.WriteLine($"{cell.StringValue} / Bold={cell.GetStyle().Font.Bold}");

Định dạng có điều kiện

Thêm các quy tắc định dạng điều kiện vào chuỗi ô qua ConditionalFormattingCollection. Quy tắc hỗ trợ FormatConditionType.CellValue, Expression, ColorScale, DataBar, và IconSet.Sử dụng OperatorType Các hoạt động tương tự (Between, Equal, GreaterThan, vv) cho A Style để phù hợp với các tế bào, và thiết lập ưu tiên và Stop-if-true hành vi theo quy tắc.

var workbook = new Workbook(); var sheet = workbook.Worksheets[0];

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

workbook.Save(“conditional-formatting.xlsx”);

### Xác thực dữ liệu

Thêm giới hạn nhập vào các tế bào sử dụng `Worksheet.Validations`.Các loại xác thực được hỗ trợ bao gồm `ValidationType.List`, `Decimal`, `Custom`, và nhiều hơn nữa. thiết lập input prompts (`InputTitle`, `InputMessage`và các thông tin sai lầm (`ErrorTitle`, `ErrorMessage`, `ValidationAlertType`* Sử dụng `CellArea.CreateCellArea()` định nghĩa phạm vi xác nhận và `Validation.AddArea()` áp dụng một quy tắc cho các ranh giới bổ sung.

var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
sheet.Name = "Validation Sheet";

var listIdx = sheet.Validations.Add(CellArea.CreateCellArea("A1", "A3"));
var listVal = sheet.Validations[listIdx];
listVal.Type = ValidationType.List;
listVal.Formula1 = "\"Open,Closed\"";
listVal.IgnoreBlank = true;
listVal.InCellDropDown = true;
listVal.ShowInput = true;
listVal.InputTitle = "Status";
listVal.InputMessage = "Pick a status";
listVal.ShowError = true;
listVal.ErrorTitle = "Invalid";
listVal.ErrorMessage = "Choose from the list";

workbook.Save("validations-sample.xlsx");

Cài Đặt Trang và Tùy Chọn In

Tạo layout print via Worksheet.PageSetup.Tính năng của Margin (LeftMarginInch, RightMarginInch, TopMarginInch, BottomMarginInch), Orientation, PaperSize,Mức thang, Vùng in, dòng tiêu đề và cột, đầu và chân, và các đoạn trượt trang. Tất cả thiết lập tồn tại Một chuyến đi vòng quanh Save-load.

var workbook = new Workbook(); var sheet = workbook.Worksheets[0]; sheet.Name = “Print Sheet”; sheet.Cells[“A1”].PutValue(“Title”);

var pageSetup = sheet.PageSetup; pageSetup.Orientation = PageOrientationType.Landscape; pageSetup.PaperSize = PaperSizeType.PaperA4; pageSetup.PrintArea = “$A$1:$C$10”; pageSetup.PrintTitleRows = “$1:$2”; pageSetup.LeftHeader = “Left Header”; pageSetup.CenterFooter = “Center Footer”; pageSetup.PrintGridlines = true; pageSetup.CenterHorizontally = true;

workbook.Save(“page-setup-sample.xlsx”);

### Cài đặt và Bảo vệ Worksheet

Kiểm soát màn hình/sheet với `Worksheet.ShowGridlines`, `ShowRowColumnHeaders`, `ShowZeros`, `RightToLeft`, `Zoom`, và `TabColor`.Bảo vệ các tấm với `Worksheet.Protect()` và cấu hình fine-grained `Protection` Bảng (`Objects`, `FormatCells`, `InsertRows`, `AutoFilter`, `SelectLockedCells`Quản lý chiều cao hàng, chiều rộng cột, các dòng / cốt lõi ẩn và Các khu vực qua `Cells.Rows`, `Cells.Columns`, và `Cells.Merge()`.

var workbook = new Workbook();
var layout = workbook.Worksheets[0];
layout.Name = "Layout";
layout.VisibilityType = VisibilityType.Hidden;
layout.TabColor = Color.FromArgb(255, 34, 68, 102);
layout.ShowGridlines = false;
layout.Zoom = 85;
layout.Protect();
layout.Protection.FormatCells = true;
layout.Protection.InsertRows = true;

layout.Cells["A1"].PutValue("Merged");
layout.Cells.Rows[1].Height = 22.5d;
layout.Cells.Columns[0].Width = 18.25d;
layout.Cells.Merge(0, 0, 2, 2);

workbook.Save("worksheet-settings-sample.xlsx");

Liên kết siêu văn bản và Phạm vi được đặt tên

Thêm bên ngoài, nội bộ và mailto: Hyperlink qua HyperlinkCollection.Add().Set Đặt Hyperlink.TextToDisplay và Hyperlink.ScreenTip cho các nhãn có thể xem bởi người dùng.Thiết định tên - Các ranh giới trong sổ làm việc hoặc bảng điều khiển sử dụng DefinedNameCollection.Add() - Tên ranh giới phục vụ như formule ổn định anchors và chart dữ liệu nguồn mà sống sót file reload.

var workbook = new Workbook(); var sheet = workbook.Worksheets[0];

sheet.Cells[“A1”].PutValue(“Docs”); var link = sheet.Hyperlinks[sheet.Hyperlinks.Add(“A1”, 1, 1, “https://example.com/docs”)]; link.TextToDisplay = “Docs”; link.ScreenTip = “External documentation”;

var name = workbook.DefinedNames[workbook.DefinedNames.Add(“PrimaryRange”, “=‘Sheet1’!$A$1:$D$5”)]; name.Comment = “Primary data range”;

workbook.Save(“hyperlinks-names.xlsx”); Console.WriteLine(“Hyperlinks: " + sheet.Hyperlinks.Count); Console.WriteLine(“Defined names: " + workbook.DefinedNames.Count);

---

## Khởi động nhanh

```bash
dotnet add package Aspose.Cells_FOSS

var workbook = new Workbook(); var sheet = workbook.Worksheets[0]; sheet.Cells[“A1”].PutValue(“Hello”); sheet.Cells[“B1”].PutValue(123); sheet.Cells[“C1”].Formula = “=B1*2”; workbook.Save(“output.xlsx”);

---

## Các định dạng hỗ trợ

| Format | Extension | Read | Write |
| ------ | --------- | ---- | ----- |
| Xlsx   | .Xlsx     | ✓    | ✓     |
| Auto   | ( Khác )  | ✓    | —     |

---

## Open Source & Giấy phép

Aspose.Cells FOSS for .NET is published under the MIT license and distributed via NuGet as `Aspose.Cells_FOSS`.Nó phù hợp cho các dự án nguồn mở và thương mại cũng như.

---

## bắt đầu

- [bắt đầu](https://docs.aspose.org/cells/net/getting-started/)
- [Hướng dẫn dành cho nhà phát triển](https://docs.aspose.org/cells/net/developer-guide/)
- [Bài viết KB](https://kb.aspose.org/cells/net/)
- [Tham chiếu API](https://reference.aspose.org/cells/net/)