محلل صيغ Excel C# مفتوح المصدر

البدء مع XLParser

يتوفر XLParser عبر NuGet ويمكن تثبيته باستخدام وحدة تحكم مدير الحزم أو واجهة NuGet في Visual Studio. أبسط طريقة هي تشغيل `Install-Package XLParser` في وحدة تحكم مدير الحزم. بدلاً من ذلك، يمكنك تنزيل أحدث إصدار من [مستودع XLParser على GitHub](https://github.com/spreadsheetlab/XLParser)، بناء الحل، والإشارة إلى ملف DLL مباشرة. تم بناء المكتبة على إطار عمل Irony للـ parser ولا تتطلب أي تبعيات إضافية. بمجرد التثبيت، يمكنك البدء في تحليل صيغ Excel باستخدام الفئة `ExcelFormulaParser`. طريقة `Parse()` الخاصة بها تقبل سلسلة الصيغة وتعيد شجرة تحليل لمزيد من التحليل أو التحويل.

Install-Package XLParser

تحليل صيغ Excel عالي التوافق

يقدم XLParser معدل نجاح في التحليل بنسبة 99.9٪ على أكثر من مليون صيغة إكسل حقيقية، مما يجعله أحد أكثر محللات الصيغ بلغة C# موثوقية المتاحة. تم التحقق من صحته باستخدام مجموعات البيانات المرجعية الشهيرة Enron و EUSES، وهو مصمم للتعامل مع الصيغ المعقدة والمتداخلة والحقيقية — بما في ذلك تعبيرات المصفوفات والمراجع والدوال. بينما لا يكون XLParser مقيّدًا بشكل مفرط (قد يحلل بعض الصيغ التي قد ترفضها إكسل)، فإن هذه المرونة مقصودة للاستخدامات البحثية والتحليلية. يمكن للمطورين الاعتماد على XLParser لتحليل الغالبية العظمى من الصيغ التي تُواجه في جداول البيانات الإنتاجية، مما يتيح تحليلاً قويًا للصيغ وإعادة هيكلة وضمان جودة سير العمل. تضمن قواعده المدمجة القابلية للصيانة والنقل عبر أطر التحليل.

using XLParser;

var parser = new ExcelFormulaParser();
var tree = parser.Parse("SUM(A1:B10, C12)");
Console.WriteLine(tree.Print());

استخراج جميع المراجع من صيغ Excel

يتضمن XLParser الفئة `FormulaAnalyzer`، التي توفر طرقًا قوية لتحليل الصيغ التي تم تحليلها. إحدى الميزات الرئيسية لها هي `ParserReferences()`، التي تُرجع جميع مراجع الخلايا والنطاقات والنطاقات المسماة والمراجع الأفقية/العمودية المستخدمة في الصيغة. هذا لا يقدر بثمن لتتبع الاعتمادات، وتحليل الأثر، وأدوات إعادة الهيكلة. على سبيل المثال، إذا كانت الصيغة مثل `SUM(A1:B10, C12, NamedRange)`، فإن `ParserReferences()` ستُرجع قائمة بـ `A1:B10` و `C12` و `NamedRange`. هذا يمكّن المطورين من بناء أدوات تدقيق جداول البيانات، وتصور تدفق البيانات، أو اكتشاف الاعتمادات الدائرية. تعمل الطريقة بسلاسة مع بنية شجرة التحليل المدمجة، مما يضمن استخراجًا سريعًا ودقيقًا حتى لل صيغ الكبيرة.

using XLParser;

var parser = new ExcelFormulaParser();
var tree = parser.Parse("SUM(A1:B10, C12, NamedRange)");
var analyzer = new FormulaAnalyzer(tree);
var references = analyzer.ParserReferences();
foreach (var refNode in references)
{
    Console.WriteLine(refNode.Print());
}

استعراض وتحليل أشجار التحليل

تم تصميم أشجار التحليل في XLParser لتكون فعّالة في التجوال والتحليل. توفر الفئة `ExcelFormulaParser` طرقًا مثل `AllNodes` للتنقل عبر كل عقدة في الشجرة، مما يتيح تحليلًا مخصصًا أو تحويلًا أو منطقًا للتحقق. يمكن للمطورين تصفية العقد حسب النوع (مثل الدوال، المراجع، المشغلات) وإجراء عمليات مثل عدّ مرات ظهور الدوال، اكتشاف النطاقات المسماة غير المستخدمة، أو تحديد الأخطاء المحتملة. تُبسّط الطريقة `GetFunction()` استخراج أسماء الدوال من عقد استدعاء الدوال، بينما تتيح `Print()` تصحيحًا سريعًا أو تسجيلًا لبنية أي عقدة. تجعل هذه القدرات XLParser مثاليًا لبناء أدوات جودة الجداول الإلكترونية، ومساعدي إعادة الهيكلة، والتصويرات التعليمية.

using XLParser;

var parser = new ExcelFormulaParser();
var tree = parser.Parse("SUM(A1, A2) + AVERAGE(B1:B5)");
var functions = tree.AllNodes.Where(n => n.IsFunction());
foreach (var func in functions)
{
    Console.WriteLine($"Function: {func.GetFunction()}");
}

تصحيح وتصور أشجار التحليل

يتكامل XLParser بشكل وثيق مع أداة GrammarExplorer الخاصة بـ Irony لتصحيح الأخطاء التفاعلي وعرض الشجرة. بعد بناء XLParser وحل GrammarExplorer، يمكنك تحميل `XLParser.dll` كقواعد واختبار الصيغ في الوقت الفعلي. أثناء التطوير، يدعم مصحح الأخطاء في Visual Studio فحص عقد شجرة التحليل عبر نافذة المراقبة باستخدام `yournode.Print(),ac`. هذه الميزة تسرّع فهم الصيغ المعقدة، واختبار الحالات الحدية، والتحقق من قواعد القواعد النحوية. يضمن هيكل الشجرة المدمج أن تظل الصيغ المتداخلة بعمق قابلة للقراءة والإدارة. سواء كنت تبني أداة تحليل جداول بيانات أو تبحث في سلوك صيغ Excel، فإن دعم تصحيح الأخطاء في XLParser يبسط عملية التطوير واستكشاف الأخطاء.

var tree = parser.Parse("IF(A1>0, A1*2, 0)");
// In Watch window: tree.Print(),ac