תכונות

תכונות

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 מדרגה, אשר מספקת גישה לכתבי עבודה, שמות מוגדרים ופעולות אחסון/העלאת.דף זה מצטבר כל אזור תכונה עיקרי עם דוגמאות קצרות של קוד.


ספר עבודה יצירת, טעינה ושמירה

יצירת ספר עבודה חדש עם new Workbook().הורד קובץ XLSX קיימת על ידי העברת מסלול קבצים למפיק. LoadOptions כדי לאפשר טעות סובלנות.קרא Workbook.Save(path) כדי להמשיך את השינויים.

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

נתונים ותבניות תאים

שימוש Cell.PutValue() לכתוב רצועות, אינגרים, עשרות, בולנים, ו DateTime ערכים - Set Cell.Formula כדי לסמן שורת נוסחה תואמת Excel.קרא בחזרה את הטקסט המוצג באמצעות Cell.StringValue ערך ירוק באמצעות 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

סגנון תאים

לשנות ולשנות את Style כל תא עם Cell.GetStyle() ו Cell.SetStyle().• The Style שיעור מספק Font (בגרמנית, איטלקית, גודל, שם), ForegroundColor, Pattern (בנוסף לסוג FillPattern), HorizontalAlignment (השימוש HorizontalAlignmentType• הגבול עם שליטה דרך 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");

פורמט תנאי

Worksheet.ConditionalFormattings חוזר א ConditionalFormattingCollection.צלצול Add() כדי ליצור כללים, אז AddCondition() להוסיף את הכללים לשימוש FormatConditionType ו OperatorType.סוגים של תנאים תומכים כוללים CellValue, Expression, ColorScale, DataBar, ו 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");

נתונים אימות

Worksheet.Validations חוזר א ValidationCollection.צלצול Add(CellArea) כדי ליצור A Validation עבור תאים מסוימים, הגדרת Type נכסים בשימוש ValidationType (List, Decimal,או Custom• הגדרת Formula1, Formula2, Operator, InputTitle, InputMessage, ErrorTitle, ו 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");

סרטי אוטומטיים

Worksheet.AutoFilter להציג את AutoFilter אובייקט - Set AutoFilter.Range להגדיר את טווח השורה של הכותרת.Access AutoFilter.FilterColumns (אחד האתרים) וטלפון Add(columnIndex) כדי להפעיל את הפילטר על עמוד מסוים.

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

קישורים ושם מוגדר

Worksheet.Hyperlinks הוא א HyperlinkCollection.צלצול Add() כדי להזין URLים חיצוניים, רמזים פנימיים של תאים או קישורים למייל. Hyperlink.TextToDisplay ו Hyperlink.ScreenTip על המשתמש פנים טקסט. Workbook.DefinedNames הוא א DefinedNameCollection;· צלצול Add(name, refersTo) כדי ליצור שורות בשם.

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

דף Setup

Worksheet.PageSetup בקרת שולי הדפסה, כיוון, גודל נייר, אזור הדפיסה , שורות כותרת / עמודים, ראשי, רגליים ופרקים דף. PageOrientationType ו PaperSizeType אנדרואיד.

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

ניהול לוח העבודה

הוסף, שם מחדש, הסתיר ועריכה של לוח העבודה דרך WorksheetCollection. WorksheetCollection.Add(name) החזיר את האינדקס של הדף החדש. Worksheet.VisibilityType שימוש VisibilityType.תאים מתמזגים עם Cells.Merge() וניהול שורה / גודל עמוד באמצעות Cells.Rows ו 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");

טיפים ושיטות טובות

  • תמיד תפס WorkbookLoadException כאשר אתה מחזיק קבצים מהדרכים המוצעות על ידי המשתמש.
  • שימוש Cell.PutValue() עם סוג .NET המדויק שאתה מתכוון לאחסן - עובר decimal על מטבע, DateTime על תאריכים .
  • קראו Cell.StringValue • שימוש בטקסט; שימוש Cell.Value כאשר אתה צריך את האובייקט .NET.
  • יצירת סדרת חוקים של עיצוב תנאי על המגוון הרחב ביותר שאתה צריך - כללים לפי רגל הם יקרים בשורות גדולות.
  • שיחת טלפון wb.Save() פעם אחת בסוף ולא אחרי כל תא לכתוב.

בעיות נפוצות

נושאסיבהקבע
WorkbookLoadException על פתיחהמבנה ZIP שבור ב- XLSXסדנה LoadOptions.TryRepairPackage = true
הפורמולה חוזרת ריקה StringValueטופס לא מחושב על העומסגישה Cell.StringValue לאחר Workbook.Save() טיול סביב
כתובת Hyperlink מציגה URL ירוקTextToDisplay לא להגדירסדנה Hyperlink.TextToDisplay לאחר Add()
תגית: לא נראהVisibilityType סתור ל Hiddenסדנה ws.VisibilityType = VisibilityType.Visible

FAQ

האם Aspose.Cells FOSS עבור .NET דורש Microsoft Office?

הספרייה היא קוד מנוהל טהור ללא תלות ב- Office, Excel או COM Interop.

אילו פורמטים של קבצים נתמכים?

CSV, ODS, PDF ו- XLS בינאריים אינם נתמכים בגרסה זו.

האם אני יכול להשתמש בספריה זו באפליקציה מסחרית?

כן. Aspose.Cells FOSS פורסם תחת רישיון MIT, אשר מאפשר שימוש מסחרי ללא הגבלה ללא רוויאלטיות.

מהו גרסה מינימלית של .NET?

.NET 6.0 או מאוחר יותר.

כיצד ניתן ליישם צבע רקע לתא?

סדנה style.Pattern = FillPattern.Solid ו style.ForegroundColor = Color.FromArgb(...),ואז התקשר cell.SetStyle(style).


סיכום התייחסות API

שיעור / שיטהתיאור
Workbookשיעור שורש – יצירת, טעינה, שמירה על ספרים עבודה
Workbook.Worksheetsחוזרים ל WorksheetCollection
Workbook.Save(path)חוסך את ספר העבודה לדיסק
Workbook.DefinedNamesשם אוסף רצועות
Worksheet.Cellsגישה לרשת סלולרית
Worksheet.ConditionalFormattingsתקנות פורמט תנאי
Worksheet.Validationsחוקי אימות נתונים
Worksheet.AutoFilterהגדרת סוללה אוטומטית
Worksheet.HyperlinksHyperlink אוסף
Worksheet.PageSetupהגדרות ליאוט הדפסה
Cell.PutValue()כתוב נתונים תא מסוג
Cell.FormulaExcel-Compatible Formula String – מסגרת תואמת
Cell.GetStyle() / Cell.SetStyle()קריאה / כתיבה סגנון תא
Style.Patternתגית: Fill pattern (FillPattern אנדרו)
Style.HorizontalAlignmentתזונה של סוללה (HorizontalAlignmentType)
LoadOptionsאפשרויות עבור טעות-סובלנות קובץ להורדה

ראה גם

 עברית