מבוא

Aspose.Cells FOSS for .NET הוא ספרייה בקוד מנוהל טהור, ברישיון MIT, לקריאה, כתיבה, ולמניפולציה של חוברות Excel .xlsx ללא תלות ב-Microsoft Office. מותקנת כ חבילת NuGet Aspose.Cells_FOSS, היא משולבת בכל פרויקט .NET — אפליקציות קונסול, רשת APIs, עובדי רקע, ופונקציות ללא שרת.

פוסט זה מספק מדריך שלב‑אחר‑שלב של הממשק הציבורי, המציג מה אפשרי וכיצד להפעיל כל יכולת מקוד C#.


סקירת תכונות

מחזור חיי חוברת עבודה וגליון עבודה

נקודת הכניסה לכל פעולה היא המחלקה Workbook. צור אחת מאפס עם new Workbook(), או טען .xlsx קיימת עם new Workbook(filePath) או new Workbook(stream). נווט בגיליונות דרך Workbook.Worksheets, הגדר Worksheet.Name ו‑Worksheet.VisibilityType, ושמור עם Workbook.Save(). עבור קבצים פגומים, העבר מופע של LoadOptions עם TryRepairPackage = true ו‑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);
}

נתוני תאים ונוסחאות

כתוב ערכים לתאים עם Cell.PutValue() — גרסאות עודפות מקבלות string, int, double, decimal, bool, ו-DateTime. קרא ערכים בחזרה באמצעות Cell.Value, Cell.StringValue, ו- Cell.Formula. הגדר נוסחאות Excel עם המאפיין Cell.Formula; מחרוזת הנוסחה נשמרת בעת השמירה ועמידה במעגל טעינה מחדש.

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

עיצוב תאים

החל Style אובייקטים כדי לשלוט בגופן, במילוי, בגבולות, בפורמט מספר וביישור.
קבל את הסגנון הנוכחי עם Cell.GetStyle(), שנה אותו, ואז הגש עם
Cell.SetStyle(). למילויים ברקע, הגדר Style.Pattern = FillPattern.Solid והקצה
Color לStyle.ForegroundColor. השתמש בCells.Merge() כדי למתוח טווחי תאים.

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

עיצוב מותנה

צור חוקים של עיצוב מותנה לטווחי תאים באמצעות ConditionalFormattingCollection.
החוקים תומכים ב-FormatConditionType.CellValue, Expression, ColorScale, DataBar, ו
IconSet.
השתמש ב-OperatorType כדי לציין מפעילי השוואה (Between, Equal,
GreaterThan, וכו׳), הקצה Style לתאים תואמים, והגדר עדיפות והתנהגות עצור‑אם‑אמת לכל חוק.

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

אימות נתונים

הוסף מגבלות קלט לתאים באמצעות Worksheet.Validations. סוגי אימות נתמכים כוללים ValidationType.List, Decimal, Custom, ועוד. הגדר תזכירי קלט (InputTitle, InputMessage) והודעות שגיאה (ErrorTitle, ErrorMessage, ValidationAlertType). השתמש בCellArea.CreateCellArea() כדי להגדיר את הטווח המאומת וValidation.AddArea() כדי להחיל כלל על טווחים נוספים.

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

הגדרות עמוד ואפשרויות הדפסה

הגדר פריסת הדפסה באמצעות Worksheet.PageSetup. הגדר שוליים (LeftMarginInch, RightMarginInch, TopMarginInch, BottomMarginInch), Orientation, PaperSize, קנה מידה, אזור הדפסה, שורות ועמודות כותרת, כותרות ותחתיות, ושבירות עמוד. כל ההגדרות נשמרות במהלך סיבוב שמירה-טעינה.

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

הגדרות והגנה של גיליון עבודה

שלוט בתצוגה לכל גיליון עם Worksheet.ShowGridlines, ShowRowColumnHeaders, ShowZeros, RightToLeft, Zoom, ו-TabColor. הגן על גיליונות עם Worksheet.Protect() והגדר דגלים מדויקים Protection (Objects, FormatCells, InsertRows, AutoFilter, SelectLockedCells). נהל גובה שורה, רוחב עמודה, שורות/עמודות מוסתרות, ו אזורי מיזוג דרך Cells.Rows, Cells.Columns, ו-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");

קישורים וטווחים בשם

הוסף קישורים חיצוניים, פנימיים ו-mailto: באמצעות HyperlinkCollection.Add().
הגדר Hyperlink.TextToDisplay ו-Hyperlink.ScreenTip לתוויות גלויות למשתמש.
הגדר טווחים בשם ברמת חוברת עבודה או גיליון באמצעות DefinedNameCollection.Add() — טווחים בשם משמשים כעוגנים יציבים לנוסחאות ומקורות נתוני גרף שמשרידים טעינת קובץ.

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

התחלה מהירה

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

פורמטים נתמכים

פורמטסיומתקריאהכתיבה
Xlsx.xlsx
Auto(שונות)

קוד פתוח ורישוי

Aspose.Cells FOSS for .NET מתפרסם תחת רישיון MIT ומופץ דרך NuGet כ Aspose.Cells_FOSS. הוא מתאים לפרויקטים קוד פתוח ומסחריים כאחד.


התחלה

משאבים קשורים