مميزات

مميزات

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().- من 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 الخارجية، أو مرجعية الخلية الداخلية، ويربطات mailto. 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");

صفحة إعداد

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 الدقيق الذي تريد تخزينه - pass 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 for .NET يتطلب Microsoft Office؟?

لا. المكتبة هي رمز خالص مع إدارة دون الاعتماد على Office أو Excel أو COM Interop.

ما هي تنسيقات الملفات التي يتم دعمها؟?

XLSX (قراءة والكتابة). 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.Hyperlinksجمع hyperlink
Worksheet.PageSetupإعدادات طباعة layout
Cell.PutValue()كتابة بيانات الخلايا المكتوبة
Cell.FormulaExcel-Compatible Formula String - صيغة متوافقة مع Excel
Cell.GetStyle() / Cell.SetStyle()قراءة / كتابة الخلية
Style.Patternكلمات مفتاحية (FillPattern إينوم )
Style.HorizontalAlignmentالتكيف مع الخلايا (HorizontalAlignmentType)
LoadOptionsخيارات تحميل الملفات المتسامحة بالخطأ
 العربية