הכניסה

Aspose.Cells FOSS for .NET is a pure managed-code, MIT-licensed library for reading, writing, ניתוח Excel .xlsx ספר עבודה ללא כל תלות Microsoft Office. The Aspose.Cells_FOSS חבילת NuGet, היא משולבת לכל פרויקט .NET – יישומי קונסולה, אינטרנט. APIs, עובדי רקע ופונקציות ללא שרתים.

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


סקירת תכונות

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

נקודת הכניסה לכל פעולה היא Workbook בואו לבנות אחד מתוך סקרץ’ עם new Workbook(),או להעלות את הקיימת .xlsx עם new Workbook(filePath) או new Workbook(stream).• ניווט על ידי Workbook.Worksheets,סאט Worksheet.Name ו Worksheet.VisibilityType,והיא ממשיכה עם Workbook.Save().עבור קבצים שבורים, עבר A 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().עבור רקע מלא, Set Style.Pattern = FillPattern.Solid להקצות A 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, וכו ‘, להעניק A 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: Hyperlink דרך 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
מכונית(התמונות שונות )

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

Aspose.Cells FOSS for .NET is published under the MIT license and distributed via NuGet as Aspose.Cells_FOSS.מתאים גם לפרויקטים מקוריים ומסחריים.


להתחיל