Fitur-fiturnya

Fitur-fiturnya

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 class, yang menyediakan akses ke lembar kerja, nama-nama terdefinisi, dan operasi save/load. Halaman ini meringkas setiap area fitur utama dengan contoh kode singkat.

Buku Kerja Buat, muat, dan Simpan

Buat buku kerja baru dengan new Workbook(). Mengunggah file XLSX yang ada dengan melewati jalur file ke konstruktor. Gunakan LoadOptions untuk memungkinkan beban yang toleran terhadap kesalahan. Workbook.Save(path) untuk mempertahankan perubahan.

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

Data dan Rumus Sel

Penggunaan Cell.PutValue() untuk menulis string, bilangan bulat, desimal, boolean, dan DateTime Nilai-nilai. Set Cell.Formula untuk menetapkan string rumus yang kompatibel dengan Excel. Baca kembali teks tampilan melalui Cell.StringValue dan nilai mentah melalui Cell.Value.

using Aspose.Cells_FOSS;

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

Penataan gaya sel

Dapatkan dan modifikasi file . Style objek untuk setiap sel dengan Cell.GetStyle() dan (b) Cell.SetStyle().- Aku tidak tahu. Style kelas memberikan Font (ditulis tebal, kursif, ukuran, nama), ForegroundColor, Pattern (berupa: FillPattern), HorizontalAlignment (menggunakan HorizontalAlignmentType), dan kontrol perbatasan melalui Borders.

using Aspose.Cells_FOSS;

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

Formatasi Berkondisi

Worksheet.ConditionalFormattings mengembalikan a ConditionalFormattingCollection.- Panggil. Add() untuk membuat set aturan, maka AddCondition() untuk menambahkan aturan menggunakan FormatConditionType dan (b) OperatorType.Jenis kondisi yang didukung meliputi: CellValue, Expression, ColorScale, DataBar, dan IconSet.

using Aspose.Cells_FOSS;

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

Validasi data

Worksheet.Validations mengembalikan a ValidationCollection.- Panggil. Add(CellArea) untuk menciptakan sebuah Validation untuk jangkauan sel. Type properti menggunakan ValidationType (List, Decimal, atau Custom). Mengkonfigurasi Formula1, Formula2, Operator, InputTitle, InputMessage, ErrorTitle, dan ErrorMessage.

using Aspose.Cells_FOSS;

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

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

Auto-Filter

Worksheet.AutoFilter memperlihatkan AutoFilter objek. set AutoFilter.Range untuk mendefinisikan rentang baris header. Access AutoFilter.FilterColumns (pengumpulan) dan panggilan Add(columnIndex) untuk mengaktifkan penyaringan pada kolom tertentu.

using Aspose.Cells_FOSS;

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

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

Hyperlink dan Nama-nama yang Ditentukan

Worksheet.Hyperlinks adalah a HyperlinkCollection.- Panggil. Add() untuk memasukkan URL eksternal, referensi sel internal, atau link mailto. Set Hyperlink.TextToDisplay dan (b) Hyperlink.ScreenTip untuk teks yang menghadap pengguna. Workbook.DefinedNames adalah a DefinedNameCollection; telepon Add(name, refersTo) untuk membuat rentang yang diberi nama.

using Aspose.Cells_FOSS;

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

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

Pengaturan halaman

Worksheet.PageSetup mengontrol margin cetak, orientasi, ukuran kertas, area cetakan, baris/kolom judul, header, footers, dan page break. PageOrientationType dan (b) PaperSizeType Enum. - Apa?.

using Aspose.Cells_FOSS;

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

Manajemen lembar kerja

Tambahkan, ganti nama, sembunyikan, dan atur ulang lembar kerja melalui WorksheetCollection. WorksheetCollection.Add(name) mengembalikan indeks lembar baru. Set Worksheet.VisibilityType menggunakan VisibilityType. Gabungan sel dengan Cells.Merge() dan pengukuran baris/kolom kontrol melalui Cells.Rows dan (b) Cells.Columns.

using Aspose.Cells_FOSS;

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

Tips dan Praktik Terbaik

• Selalu menangkap. WorkbookLoadException saat memuat file dari jalur yang disediakan pengguna.
• Penggunaan Cell.PutValue() dengan jenis .NET yang tepat Anda ingin menyimpan pass decimal untuk mata uang, DateTime untuk kencan.
• Bacalah. Cell.StringValue untuk teks tampilan; penggunaan Cell.Value ketika Anda membutuhkan .NET obyek mentah.
• Buat set aturan formatasi bersyarat pada rentang terluas yang Anda butuhkan Per-aturan baris mahal dalam lembar besar.
• Panggil. wb.Save() sekali di akhir daripada setelah setiap sel menulis.

Masalah Umum

FAQ

Apakah Aspose.Cells FOSS untuk .NET memerlukan Microsoft Office?

Tidak. Perpustakaan ini adalah kode yang dikelola murni tanpa ketergantungan pada Office, Excel, atau COM interop.

Format file apa yang didukung?

XLSX (baca dan tulis). CSV, ODS, PDF, dan biner XSL tidak didukung dalam rilis ini.

Bisakah saya menggunakan perpustakaan ini dalam aplikasi komersial?

Ya. Aspose.Cells FOSS diterbitkan di bawah Lisensi MIT, yang memungkinkan penggunaan komersial tanpa batasan tanpa royalti.

Apa versi minimum .NET?

.NET 6.0 atau lebih baru.

Bagaimana saya menerapkan warna latar belakang ke sel?

Set (set) style.Pattern = FillPattern.Solid dan (b) style.ForegroundColor = Color.FromArgb(...), lalu hubungi cell.SetStyle(style).

Ringkasan Referensi API