مميزات
مميزات
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 الدقيق الذي تريد تخزينه - passdecimalمن أجل العملة،,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.Formula | Excel-Compatible Formula String - صيغة متوافقة مع Excel |
Cell.GetStyle() / Cell.SetStyle() | قراءة / كتابة الخلية |
Style.Pattern | كلمات مفتاحية (FillPattern إينوم ) |
Style.HorizontalAlignment | التكيف مع الخلايا (HorizontalAlignmentType) |
LoadOptions | خيارات تحميل الملفات المتسامحة بالخطأ |