إنشاء معاينات جداول بيانات Excel المستهدفة باستخدام GroupDocs.Annotation .NET

دليل معاينة المستند

مقدمة

هل ترغب في تحسين وضوح معالجة مستنداتك بالتركيز على نقاط بيانات محددة؟ سواء كنت مطورًا تُنشئ أدوات تحليل بيانات، أو متخصصًا في تكنولوجيا المعلومات يُدير المستندات، أو أي شخص مهتم بتبسيط سير العمل، فإن معاينات المستندات المُخصصة تُوفر الوقت وتُحسّن الكفاءة. سيُرشدك هذا البرنامج التعليمي إلى كيفية استخدام GroupDocs.Annotation لـ .NET لإنشاء معاينات من أعمدة مُحددة في ورقة العمل، مما يضمن أن تكون مخرجاتك مُختصرة وذات صلة.

ما سوف تتعلمه:

  • كيفية إعداد GroupDocs.Annotation لـ .NET
  • إنشاء معاينات باستخدام أعمدة ورقة العمل المحددة
  • تكوين خيارات المعاينة للحصول على أفضل إخراج
  • التطبيقات العملية لهذه الميزة في سيناريوهات العالم الحقيقي

لنبدأ بمراجعة المتطلبات الأساسية اللازمة قبل البدء في تنفيذ هذا الحل.

المتطلبات الأساسية

قبل البدء في التنفيذ، تأكد من أن لديك ما يلي:

المكتبات والإصدارات المطلوبة:

  • GroupDocs.Annotation لـ .NET:الإصدار 25.4.0 أو أحدث مطلوب.

متطلبات إعداد البيئة:

  • بيئة تطوير مع تثبيت .NET Framework أو .NET Core.

المتطلبات المعرفية:

  • فهم أساسي لبرمجة C#
  • المعرفة بعمليات إدخال وإخراج الملفات في .NET

إعداد GroupDocs.Annotation لـ .NET

للبدء، عليك تثبيت مكتبة GroupDocs.Annotation. إليك كيفية القيام بذلك باستخدام مديري حزم مختلفين:

وحدة تحكم مدير الحزم NuGet

Install-Package GroupDocs.Annotation -Version 25.4.0

.NET CLI

dotnet add package GroupDocs.Annotation --version 25.4.0

خطوات الحصول على الترخيص:

  • نسخة تجريبية مجانية: قم بتنزيل النسخة التجريبية من موقع GroupDocs لاختبار الميزات.
  • رخصة مؤقتة:احصل على ترخيص مؤقت للوصول الكامل أثناء التطوير في صفحة الترخيص المؤقت.
  • شراء:للاستخدام الإنتاجي، قم بشراء ترخيص من خلال صفحة شراء GroupDocs.

التهيئة الأساسية والإعداد باستخدام C#:

فيما يلي كيفية إعداد بيئتك لبدء العمل مع GroupDocs.Annotation لـ .NET.

using System;
using GroupDocs.Annotation;
// قم بتهيئة كائن المعلق باستخدام مسار المستند.
string inputFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.xlsx";
Annotator annotator = new Annotator(inputFilePath);

الآن بعد أن قمت بإعداد الأمر، دعنا ننتقل إلى إنشاء معاينات من أعمدة ورقة عمل محددة.

دليل التنفيذ

سيرشدك هذا الدليل إلى كيفية تطبيق ميزة إنشاء معاينات للمستندات باستخدام أعمدة محددة في ورقة العمل. يركز كل قسم على جانب محدد من عملية التطبيق.

إنشاء معاينات المستندات من أعمدة ورقة عمل محددة

ملخص:تتيح هذه الميزة للمطورين إنشاء معاينات للمستندات تتضمن فقط أعمدة محددة من ورقة عمل Excel، مما يؤدي إلى تحسين الأداء والملاءمة.

الخطوة 1: تحديد خيارات المعاينة

ابدأ بإعداد PreviewOptions. يحدد هذا كيفية ومكان حفظ ملفات المعاينة الخاصة بك.

using System.IO;
using GroupDocs.Annotation.Options;
string outputDirectoryPath = "YOUR_OUTPUT_DIRECTORY";
PreviewOptions previewOptions = new PreviewOptions(pageNumber => 
    new FileStream(Path.Combine(outputDirectoryPath, $"cells_page{pageNumber}.png"), FileMode.Create),
    (number, stream) => stream.Dispose());

توضيح: ال PreviewOptions يأخذ المُنشئ مُفوَّضَين. يُحدِّد الأول مسار ملف صورة معاينة كل صفحة. أما الثاني، فيضمن التخلص من التدفقات بشكل صحيح بعد الاستخدام.

الخطوة 2: تحديد أعمدة ورقة العمل

اختر الأعمدة من ورقة العمل التي تريد تضمينها في المعاينات عن طريق إضافتها إلى WorksheetColumns.

// تضمين أعمدة محددة من الورقة 1.
previewOptions.WorksheetColumns.Add(new WorksheetColumnsRange("Sheet1\