العمل مع XML Processing

العمل مع XML Processing

يتم تخزين ملفات XLSX بياناتها في أجزاء XML داخل حزمة OPC. Aspose.Cells FOSS for .NET يعرض طبقة XML من التفريغ والتسلسل من خلال أربعة فصول خرائط: WorkbookXmlMapper, WorksheetXmlMapper, SharedStringTableXmlMapper,و ، و StylesheetXmlMapper.كل خريطة تنفذ كلاهما Read و Write هذه هي البنية التحتية الداخلية APIs - معظم رمز التطبيق يعمل بالكامل من خلال Workbook و Worksheet الأجسام .

XML Mapper الفصول الدراسية

كل خريطة XML مسؤولة عن جزء واحد من هيكل XLSX:

كل خريطة تظهر طريقتين - Read و Write - استدعاء من خلال الحمل المكتبي وتخزين الأنابيب على التوالي.

XmlParsingException

XmlParsingException يتم رميها عندما يلتقي خريطة XML غير صالحة التي لا يمكن إصلاحها. WorkbookLoadException في الهرم الخطأ عندما يحدث الفشل أثناء XML تداول على وجه التحديد.

using Aspose.Cells_FOSS;

var opts = new LoadOptions
{
    TryRepairPackage = true,
    TryRepairXml = true,
};

try
{
    var wb = new Workbook("malformed.xlsx", opts);
    Console.WriteLine("Loaded: " + wb.Worksheets.Count + " sheet(s)");
}
catch (XmlParsingException ex)
{
    Console.WriteLine("XML parse error: " + ex.Message);
}
catch (WorkbookLoadException ex)
{
    Console.WriteLine("Load error: " + ex.Message);
}

نصائح وأفضل الممارسات

• مجموعة TryRepairXml = true في LoadOptions لتسمح مسار التسامح الخاطئ للمجلد.
• القبض XmlParsingException وبالإضافة إلى WorkbookLoadException عندما تتعامل مع الملفات من أنظمة خارجية قد تنتج XML الخاطئة.
• لا يُهدف فصول المجلد XML إلى أن تكون متوفرة بواسطة رمز التطبيق – يتم استدعاءها تلقائيًا خلال Workbook البناء و Save().
• إذا كنت بحاجة إلى فحص محتوى XML الخام للتشخيص، استخراج XLSX كZIP والفحص على أجزاء XML ذات الصلة مباشرة.

القضايا المشتركة

FAQ

هل يمكنني تنفيذ خريطة XML الخاصة بي؟?

فصول الخرائط XML هي البنية التحتية الداخلية المغلقة.المخازن المخصصة لا تدعم في سطح API الحالي.

لماذا يوجد منفصل SharedStringTableXmlMapper?

يفرق المحدد OOXML قيم الصفوف في جدول صفوف مشتركة (xl/sharedStrings.xml) لتقليص الشرائح المتكررة عبر دفتر العمل.الخريطة تتعامل مع قراءة وكتابة هذه الجدول بشكل مستقل.

يُفعل TryRepairXml = true إصلاح جميع مشاكل XML.?

TryRepairXml التعامل مع المشاكل القابلة للتحلل مثل العناصر غير المغلقة، وتفتقر المساحات الاسمية، والقيم المتعثرة.وقد لا تزال XML صالحة بنية ولكنها غير متسقة بشكل شيوعي (مثل إشارات الصيغة المكسورة) قد تسبب XmlParsingException.

إشارة API