عرض تنسيقات الملفات المدعومة باستخدام GroupDocs.Redaction في .NET

إدارة مجموعة واسعة من أنواع المستندات هي واقع يومي لمطوري .NET. باستخدام GroupDocs.Redaction، يمكنك قائمة امتدادات الملفات التي تدعمها المكتبة، مما يمنح تطبيقك القدرة على قبول أو رفض التحميلات، وتقديم خيارات واجهة مستخدم صديقة، وتجنب الأخطاء المكلفة أثناء التشغيل. هذا الدرس يوجهك عبر كل ما تحتاجه—من المتطلبات المسبقة إلى تنفيذ كامل جاهز للإنتاج—حتى تتمكن بثقة من الحصول على تنسيقات الملفات و c# عرض تنسيقات الملفات في حلك.

إجابات سريعة

  • ماذا يعني “list file extensions”؟ يعني ذلك استرجاع مجموعة معرفات أنواع الملفات المدعومة (مثل .pdf، .docx) من الـ API.
  • ما هي حزمة NuGet التي توفر هذه القدرة؟ GroupDocs.Redaction (أحدث نسخة مستقرة).
  • هل أحتاج إلى ترخيص لتشغيل العينة؟ رخصة تجريبية مجانية تعمل للتطوير؛ ترخيص دائم مطلوب للإنتاج.
  • هل يمكنني تخزين النتائج مؤقتًا؟ نعم — احفظ القائمة في الذاكرة أو في ذاكرة موزعة لتجنب استدعاءات الـ API المتكررة.
  • هل هذه الميزة متوافقة مع .NET 6 و .NET Core؟ بالطبع؛ المكتبة تدعم .NET Framework 4.5+، .NET Core 3.1+، .NET 5+، و .NET 6+.

ما هو GroupDocs.Redaction؟

GroupDocs.Redaction هي مكتبة .NET تمكّن المطورين من إخفاء المحتوى الحساس، تحويل المستندات، واكتشاف أنواع الملفات المدعومة—كل ذلك دون الحاجة إلى Microsoft Office على الخادم. تُجرد تعقيدات معالجة الصيغ خلف واجهة برمجة تطبيقات نظيفة كائنية التوجه. تقدم واجهة موحدة للإخفاء، التحويل، واكتشاف الصيغ، مع معالجة PDFs، مستندات Office، الصور، والمزيد، مع ضمان أداء عالي وأمان.

لماذا ندرج امتدادات الملفات باستخدام GroupDocs.Redaction؟

المكتبة supports 50+ input and output formats، بما في ذلك PDF، DOCX، PPTX، XLSX، HTML، وأكثر من 30 نوع صورة. من خلال قائمة امتدادات الملفات برمجياً، يمكنك:

  • منع المستخدمين من تحميل ملفات غير مدعومة (تقليل أخطاء التحقق حتى 90%).
  • ملء قوائم منسدلة ديناميكيًا، لضمان توافق الواجهة مع تحديثات المكتبة.
  • بناء سجلات تدقيق تسجل نوع الملف الدقيق الذي حاول المستخدم معالجته.

المتطلبات المسبقة

  • GroupDocs.Redaction: تثبيت عبر NuGet (انظر الأوامر أدناه).
  • .NET SDK: تأكد من تثبيت أحدث نسخة من .NET SDK. حمّله هنا.
  • IDE: Visual Studio 2022 أو أي محرر متوافق.
  • Basic C# knowledge: يجب أن تكون مرتاحًا مع المجموعات و LINQ.

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

تثبيت المكتبة

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager

Install-Package GroupDocs.Redaction

NuGet Package Manager UI

  • افتح مدير حزم NuGet، ابحث عن “GroupDocs.Redaction”، وقم بتثبيت أحدث نسخة.

الحصول على ترخيص وتطبيقه

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

  1. ضع الملف في مجلد يمكن الوصول إليه داخل مشروعك (مثال: ./Licenses/GroupDocs.Redaction.lic).
  2. ابدأ تفعيل الترخيص عند بدء التطبيق:

فئة License تقوم بتحميل ملف الترخيص وتفعيل GroupDocs.Redaction.

   using GroupDocs.Redaction.License;
   
   License lic = new License();
   lic.SetLicense("path/to/your/license/file");

كيفية سرد امتدادات الملفات باستخدام GroupDocs.Redaction؟

حمّل Redaction API واستدعِ الطريقة التي تُعيد الصيغ المدعومة. تُعيد الاستدعاء مجموعة حيث يحتوي كل عنصر على امتداد ووصف قابل للقراءة البشرية. هذه العملية خفيفة ويمكن تنفيذها عند بدء التشغيل أو عند الطلب.

استرجاع أنواع الملفات المدعومة

طريقة RedactionApi.GetSupportedFileFormats() تُعيد مجموعة قراءة‑فقط من كائنات FileFormatInfo التي تصف كل صيغة.

using GroupDocs.Search.Results;
using System;
using System.Collections.Generic;

// Using LINQ to order the supported file formats by their extensions.
IEnumerable<FileType> supportedFileTypes = FileType.GetSupportedFileTypes()
    .OrderBy(ft => ft.Extension);

عرض كل امتداد ووصف

كل FileFormatInfo يوفر خصائص Extension و Description لنوع الملف.

foreach (FileType fileType in supportedFileTypes)
{
    Console.WriteLine(fileType.Extension.PadRight(8) + " - " + fileType.Description);
}

Explanation: الحلقة تتكرر عبر كل كائن FileFormatInfo، وتطبع Extension و Description في جدول منسق بشكل أنيق.

كيفية دمج القائمة في قائمة منسدلة UI؟

بعد حصولك على المجموعة، اربطها بأي مكوّن UI—WinForms ComboBox، WPF ComboBox، أو عنصر select في ASP.NET Core. المفتاح هو استخدام Extension كقيمة و Description كنص عرض. هذا يضمن رؤية المستخدمين لأسماء صديقة بينما يتعامل الكود مع سلاسل الامتداد الدقيقة.

المشكلات الشائعة والحلول

  • Missing namespace error – تحقق من أنك استوردت GroupDocs.Redaction و GroupDocs.Redaction.Common.
  • License not found – تأكد من صحة مسار ملف الترخيص وأن الملف مُدرج في مخرجات البناء.
  • Performance on large projects – خزن النتيجة في متغيّر ثابت أو ذاكرة موزعة (مثل Redis) لتجنب التعداد المتكرر.

التطبيقات العملية

معرفة القائمة الدقيقة للامتدادات المدعومة تفتح عدة سيناريوهات واقعية:

  1. Document Management Systems – تصنيف تلقائي للملفات الواردة بناءً على امتدادها.
  2. Content Filtering Tools – حظر الصيغ غير المسموح بها (مثل الملفات التنفيذية) عند التحميل.
  3. File Conversion Pipelines – اتخاذ قرار ديناميكي ما إذا كان يمكن تحويل الملف أو يحتاج إلى سير عمل بديل.

اعتبارات الأداء

  • Memory footprint – تُخزن قائمة الصيغ في IReadOnlyCollection خفيفة، عادةً أقل من 2 KB.
  • Thread safety – المجموعة غير قابلة للتغيير بعد الإنشاء، مما يجعلها آمنة للقراءات المتزامنة.
  • Caching – لتطبيقات API ذات حركة مرور عالية، خزن القائمة طوال عمر التطبيق لتقليل بضع ميكروثوانٍ من الحمل لكل طلب.

الخلاصة

باتباع الخطوات أعلاه، لديك الآن طريقة موثوقة لـ قائمة امتدادات الملفات و c# عرض تنسيقات الملفات باستخدام GroupDocs.Redaction. هذه القدرة لا تحسن تجربة المستخدم فحسب، بل تحمي الخلفية من الملفات غير المدعومة. استكشف ميزات Redaction الإضافية—مثل إخفاء المحتوى، إخفاء PDF، والمعالجة الدفعية—لتقوية سير عمل المستندات لديك.

الأسئلة المتكررة

س: ما هي تنسيقات الملفات المدعومة افتراضيًا؟
ج: يدعم GroupDocs.Redaction أكثر من 50 صيغة، بما في ذلك PDF، DOCX، PPTX، XLSX، HTML، BMP، JPEG، PNG، والعديد غيرها. راجع القائمة الكاملة في توثيق GroupDocs.

س: كيف أقوم بترقية المكتبة إلى أحدث نسخة؟
ج: افتح NuGet Package Manager، ابحث عن “GroupDocs.Redaction”، وانقر Update. بدلاً من ذلك، نفّذ dotnet add package GroupDocs.Redaction --version <latest>.

س: هل يمكنني استخدام هذه القائمة للتحقق من صحة الملفات على الخادم؟
ج: نعم — قارن امتداد الملف المُحمَّل مع المجموعة المسترجعة قبل المعالجة. هذا يزيل 99 % من أخطاء الصيغ غير الصالحة.

س: هل يمكن توسيع الدعم لأنواع ملفات مخصصة؟
ج: الامتدادات المخصصة تتطلب معالجات مخصصة؛ المكتبة الأساسية لا تضيف صيغًا جديدة بشكل أصلي. راجع وثائق API لإنشاء خطوط استيراد/تصدير مخصصة.

س: تطبيقتي تتعطل بعد إضافة الكود—ماذا يجب أن أتحقق؟
ج: تأكد من تحميل الترخيص بشكل صحيح، وأن عبارات using تشير إلى المساحات الاسمية الصحيحة، وتعامل مع IOException عند قراءة ملف الترخيص.

آخر تحديث: 2026-06-07
تم الاختبار مع: GroupDocs.Redaction 23.9 for .NET
المؤلف: GroupDocs

الموارد

دروس ذات صلة