Pengantar

Aspose.Cells FOSS for .NET is a pure managed-code, MIT-licensed library for reading, writing, dan memanipulasi Excel .xlsx buku kerja tanpa ketergantungan Microsoft Office. Dilengkapi sebagai Pengumuman Aspose.Cells_FOSS Paket NuGet, terintegrasi ke dalam proyek .NET aplikasi konsol, web API, pekerja latar belakang dan fungsi tanpa server.

Posting ini memberikan walkthrough fitur-by-feature dari API publik, menunjukkan apa yang mungkin dan bagaimana memanggil setiap kemampuan dari kode C #.

Tinjauan Fitur

Buku kerja dan lembar kerja Siklus hidup

Titik masuk untuk setiap operasi adalah: Workbook Bangun satu dari awal dengan new Workbook(), atau memuat yang ada .xlsx dengan: new Workbook(filePath) atau: new Workbook(stream). Navigasi lembar melalui Workbook.Worksheets, set Worksheet.Name dan (b) Worksheet.VisibilityType, dan terus dengan Workbook.Save().Untuk file yang rusak, kirimkan ke LoadOptions contoh dengan TryRepairPackage = true dan (b) 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);
}

Data dan Rumus Sel

Tulis nilai ke sel dengan Cell.PutValue() menerima overloads string, int, double, decimal, bool, dan DateTime.Membaca nilai kembali melalui Cell.Value, Cell.StringValue, dan Cell.Formula. Atur rumus Excel dengan Cell.Formula sifat; string rumus adalah: disimpan pada save dan bertahan dalam siklus pengisian ulang.

using 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("hello.xlsx");

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

Penataan gaya sel

Memohon Style objek untuk mengontrol font, isian, batas, format nomor, dan penyelarasan. Dapatkan gaya saat ini dengan Cell.GetStyle(), memutasi, kemudian berkomitmen dengan Cell.SetStyle().Untuk mengisi latar belakang, set Style.Pattern = FillPattern.Solid dan menetapkan a Color ke Style.ForegroundColor.Gunakan . Cells.Merge() untuk menjangkau sel rentang.

using Aspose.Cells_FOSS;

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}");

Formatasi Berkondisi

Menambahkan aturan format bersyarat ke kisaran sel melalui ConditionalFormattingCollection. Dukungan peraturan FormatConditionType.CellValue, Expression, ColorScale, DataBar, dan IconSet.Gunakan . OperatorType untuk menentukan operator perbandingan (Between, Equal, GreaterThan, dll.), memberikan sebuah Style untuk sel yang cocok, dan mengkonfigurasi prioritas dan perilaku stop-if-true per aturan.

using Aspose.Cells_FOSS;

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");

Validasi data

Tambahkan batasan input ke sel menggunakan Worksheet.Validations.Jenis validasi yang didukung termasuk: ValidationType.List, Decimal, Custom, dan banyak lagi. Mengkonfigurasi input prompt (InputTitle, InputMessage) dan pesan kesalahan (ErrorTitle, ErrorMessage, ValidationAlertType) Penggunaan CellArea.CreateCellArea() untuk menentukan rentang yang divalidasi dan Validation.AddArea() untuk menerapkan aturan pada kisaran tambahan.

using Aspose.Cells_FOSS;

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");

Opsi Setup dan Cetak Halaman

Mengkonfigurasi tata letak cetak melalui Worksheet.PageSetup.Menetapkan margin (LeftMarginInch, RightMarginInch, TopMarginInch, BottomMarginInch), Orientation, PaperSize, skala, area cetak, baris dan kolom judul, header dan footer, dan istirahat halaman. Semua pengaturan bertahan perjalanan pulang-pergi untuk menghemat muatan.

using Aspose.Cells_FOSS;

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");

Pengaturan dan Perlindungan Lembar Kerja

Kontrol per-sheet display dengan Worksheet.ShowGridlines, ShowRowColumnHeaders, ShowZeros, RightToLeft, Zoom, dan TabColor. Melindungi lembaran dengan Worksheet.Protect() dan konfigurasi halus-berbutir Protection bendera (Objects, FormatCells, InsertRows, AutoFilter, SelectLockedCells). Mengelola tinggi baris, lebar kolom, baris/kolom tersembunyi, dan wilayah yang bergabung melalui Cells.Rows, Cells.Columns, dan Cells.Merge().

using Aspose.Cells_FOSS;

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");

Tambahkan eksternal, internal dan mailto: hyperlink melalui HyperlinkCollection.Add()./ Siap. Hyperlink.TextToDisplay dan (b) Hyperlink.ScreenTip untuk label yang terlihat pengguna. Tentukan nama kisaran pada buku kerja atau ruang lingkup lembar menggunakan DefinedNameCollection.Add() rentang yang diberi nama berfungsi sebagai Anchor formula yang stabil dan sumber data grafik yang bertahan di file reload.

using Aspose.Cells_FOSS;

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);

Memulai dengan cepat

dotnet add package Aspose.Cells_FOSS

using 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");

Format yang Didhukung

Format (Inggris)PerpanjanganBacalah.Menulis
Xlsx (dalam bahasa Inggris).xlsx✓✓
Otomatis(berbagai)✓—

Open Source & Lisensi

Aspose.Cells FOSS for .NET is published under the MIT license and distributed via NuGet as Aspose.Cells_FOSS. Cocok untuk proyek open source dan komersial.

Memulai