قم بإلغاء العرض باستخدام رمز الإلغاء

مقدمة

يعد Groupdocs.Viewer for .NET أداة قوية مصممة لتبسيط عرض المستندات ومعالجتها داخل تطبيقات .NET. سواء كنت تتعامل مع ملفات PDF، أو مستندات Microsoft Office، أو التنسيقات الشائعة الأخرى، توفر هذه المكتبة وظائف قوية لدمج إمكانات عرض المستندات بسلاسة في مشاريع .NET الخاصة بك.

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

قبل الغوص في تكامل Groupdocs.Viewer لـ .NET، تأكد من توفر المتطلبات الأساسية التالية:

1. التثبيت: قم بتنزيل وتثبيت Groupdocs.Viewer لمكتبة .NET من الملف المتوفررابط التحميل.

2. الترخيص: الحصول على ترخيص منمستندات جماعية لفتح الإمكانات الكاملة للمكتبة. وبدلاً من ذلك، يمكنك البدء بتجربة مجانية باستخدامترخيص مؤقت.

3. بيئة التطوير: تأكد من إعداد بيئة تطوير متوافقة، بما في ذلك Visual Studio أو أي .NET IDE آخر من اختيارك.

استيراد مساحات الأسماء

للاستفادة من Groupdocs.Viewer لـ .NET بشكل فعال، تحتاج إلى استيراد مساحات الأسماء الضرورية إلى مشروعك. اتبع الخطوات التالية:

using System;
using System.IO;
using GroupDocs.Viewer.Options;
using System.Threading.Tasks;
using System.Threading;

الآن، دعنا نقسم المثال المقدم إلى خطوات متعددة لفهم وتنفيذ أفضل:

الخطوة 1: تحديد دليل الإخراج

string outputDirectory = "Your Document Directory";

تقوم هذه الخطوة بتعيين الدليل حيث سيتم تخزين صفحات المستند المعروضة.

الخطوة 2: تحديد تنسيق مسار ملف الصفحة

string pageFilePathFormat = Path.Combine(outputDirectory, "page_{0}.html");

هنا، نحدد تنسيق مسارات الملفات لصفحات المستندات الفردية.

الخطوة 3: تهيئة CancellationTokenSource

CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();

يتم استخدام CancellationTokenSource لإنشاء مثيلات CancellationToken التي يمكن استخدامها لإلغاء العمليات غير المتزامنة.

الخطوة 4: الحصول على CancelToken

CancellationToken cancellationToken = cancellationTokenSource.Token;

تسترد هذه الخطوة الرمز المميز من CancellationTokenSource، والذي سيتم استخدامه لإلغاء عملية العرض.

الخطوة 5: عرض صفحات المستند

Task.Run(() =>
{
    using (Viewer viewer = new Viewer(TestFiles.SAMPLE_DOCX, new ViewerSettings(new GroupDocs.Viewer.Logging.ConsoleLogger())))
    {
        HtmlViewOptions options = HtmlViewOptions.ForEmbeddedResources(pageFilePathFormat);
        options.RenderComments = true;
        viewer.View(options, cancellationToken);
    }
}, cancellationToken);

هنا، نبدأ في عرض صفحات المستند بشكل غير متزامن باستخدام Task.Run(). يتم إنشاء مثيل العارض باستخدام ملف المستند المحدد (SAMPLE_DOCX)، ويتم تكوين خيارات العرض. تبدأ عملية العرض بعد ذلك باستخدام طريقة العرض لفئة العارض.

الخطوة 6: تعيين مهلة العرض

cancellationTokenSource.CancelAfter(10);

تحدد هذه الخطوة مهلة قدرها 10 مللي ثانية لعملية العرض. إذا تجاوزت العملية هذه المهلة، فسيتم إلغاؤها تلقائيًا.

الخطوة 7: عرض رسالة النجاح

Console.WriteLine($"\nSource document rendered successfully.\nCheck output in {outputDirectory}.");

وأخيرًا، يتم عرض رسالة نجاح تشير إلى أنه تم تقديم المستند بنجاح.

خاتمة

في هذا البرنامج التعليمي، قمنا بتغطية أساسيات دمج Groupdocs.Viewer لـ .NET في مشاريعك. باتباع الخطوات الموضحة أعلاه، يمكنك دمج إمكانيات عرض المستندات في تطبيقات .NET الخاصة بك بسلاسة، مما يعزز تجربة المستخدم والإنتاجية.

الأسئلة الشائعة

هل يتوافق Groupdocs.Viewer for .NET مع كافة تنسيقات المستندات؟

يدعم Groupdocs.Viewer for .NET نطاقًا واسعًا من تنسيقات المستندات، بما في ذلك PDF ومستندات Microsoft Office والصور والمزيد.

هل يمكنني تخصيص مظهر صفحات المستندات المعروضة؟

نعم، يمكنك تخصيص جوانب مختلفة من عملية العرض، بما في ذلك حجم الصفحة والجودة والعلامة المائية والمزيد.

هل يتطلب Groupdocs.Viewer for .NET اتصالاً بالإنترنت؟

لا، يعمل Groupdocs.Viewer for .NET محليًا ضمن بيئة .NET الخاصة بك ولا يتطلب الاتصال بالإنترنت لعرض المستندات.

هل يتوفر الدعم الفني لـ Groupdocs.Viewer لـ .NET؟

نعم، الدعم الفني متوفر من خلالمنتدى المستندات الجماعيةحيث يمكنك طرح الأسئلة والإبلاغ عن المشكلات والتفاعل مع المجتمع.

هل يمكنني تجربة Groupdocs.Viewer لـ .NET قبل الشراء؟

نعم، يمكنك البدء بالإصدار التجريبي المجاني باستخدام البرنامج المقدمنسخه تجريبيه.