كيفية تحويل ملفات DGN إلى TXT باستخدام GroupDocs.Conversion .NET

مقدمة

هل تبحث عن طريقة فعّالة create output folder C# وتحويل ملفات DGN المعقدة إلى تنسيق TXT أكثر قابلية للإدارة؟ يحتاج العديد من المعماريين والمهندسين ومحترفي البناء إلى استخراج بيانات نصية بسيطة من رسومات CAD للتقارير، أو خطوط تحليل البيانات، أو التكامل مع الأنظمة القديمة. يشرح هذا الدليل كيفية استخدام GroupDocs.Conversion .NET لتحميل ملف DGN، إعداد دليل إخراج مناسب، وإنشاء ملف TXT نظيف — كل ذلك باستخدام كود واضح وجاهز للإنتاج.

ما ستتعلمه

  • كيفية إعداد GroupDocs.Conversion لـ .NET
  • كيفية create output folder C# وتحديد الوجهة للملفات المحوّلة
  • كيفية تحميل ملف DGN وتحويله إلى TXT
  • خيارات التكوين الرئيسية التي تتيح لك ضبط عملية التحويل بدقة

إجابات سريعة

  • ما المكتبة التي تتعامل مع تحويل DGN إلى TXT؟ GroupDocs.Conversion .NET
  • هل أحتاج إلى ترخيص للاستخدام في الإنتاج؟ نعم، يلزم ترخيص كامل أو مؤقت.
  • هل يمكن تشغيل هذا على .NET 6؟ بالتأكيد – المكتبة تدعم .NET 5/6، .NET Core 3.1، و .NET Framework 4.5+.
  • كيف يمكنني إنشاء مجلد الإخراج في C#؟ استخدم Directory.CreateDirectory(path) قبل التحويل.
  • ما هي سرعة التحويل النموذجية؟ عادةً ما يكتمل تحويل DGN مكوّن من 200 صفحة إلى TXT في أقل من ثانيتين على خادم قياسي.

ما هو “create output folder C#”؟

Create output folder C# يشير إلى التأكد برمجياً من وجود دليل على نظام الملفات قبل كتابة الملفات إليه، عادةً باستخدام System.IO.Directory.CreateDirectory. هذا يمنع أخطاء “المسار غير موجود” أثناء عمليات كتابة الملفات.

لماذا استخدام GroupDocs.Conversion لتحويل CAD إلى TXT؟

يدعم GroupDocs.Conversion أكثر من 50 تنسيقًا للمدخلات والمخرجات، بما في ذلك DGN و DWG و DXF، ويمكنه معالجة ملفات تصل إلى 2 GB دون تحميل المستند بالكامل في الذاكرة. يحافظ محرك استخراج النص الأصلي على أسماء الطبقات، والتعليقات التوضيحية، وبيانات السمات، مما ينتج ملف TXT يعكس المحتوى النصي للرسم الأصلي بدقة 99 %.

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

  • مكتبة GroupDocs.Conversion .NET (الإصدار 25.3.0 أو أحدث)
  • Visual Studio 2022 (أو أي بيئة تطوير تدعم C# 8.0+)
  • .NET 6 SDK (أو .NET Core 3.1 / .NET Framework 4.5+)
  • ترخيص GroupDocs صالح (التجربة المجانية أو الترخيص المؤقت يعمل للاختبار)

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

قم بتثبيت مكتبة GroupDocs.Conversion باستخدام مدير الحزم الذي تفضله.

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

Install-Package GroupDocs.Conversion -Version 25.3.0

.NET CLI:

dotnet add package GroupDocs.Conversion --version 25.3.0

نصيحة احترافية: بعد التثبيت، أضف ملف الترخيص إلى مشروعك وحمّله عند بدء التطبيق لتجنب أخطاء الترخيص أثناء التشغيل.

التهيئة الأساسية

فئة Converter هي المكوّن الأساسي في GroupDocs.Conversion التي تقوم بتحميل الملفات المصدر وإجراء تحويلات الصيغ.

using System;
using GroupDocs.Conversion;

// Initialize the conversion handler
class Program
{
    static void Main()
    {
        var converter = new Converter("path/to/your/file.dgn");
        Console.WriteLine("Setup complete. Ready to convert!");
    }
}

دليل التنفيذ

كيف يمكنني إنشاء مجلد إخراج في C#؟

Directory.CreateDirectory ينشئ جميع الأدلة والفرعية في المسار المحدد إذا لم تكن موجودة بالفعل.

استخدم Directory.CreateDirectory لضمان وجود مسار الوجهة قبل استدعاء واجهة برمجة تطبيقات التحويل. هذه السطر الواحد ينشئ المجلد إذا كان مفقودًا ويستمر بصمت إذا كان المجلد موجودًا بالفعل، مما يلغي استثناءات “الدليل غير موجود” أثناء كتابة الملفات. كما أنه يُعيد المسار الكامل، والذي يمكنك إعادة استخدامه للتسجيل أو المعالجة اللاحقة.

string outputFolder = Path.Combine(Environment.CurrentDirectory, "ConvertedFiles");
Directory.CreateDirectory(outputFolder);

تحميل وتحويل ملف DGN إلى TXT

نظرة عامة

تتيح لك هذه الميزة تحميل ملف DGN وتحويله إلى تمثيل نصي عادي (TXT)، وهو مفيد لاستخراج ملاحظات التصميم، والبيانات الوصفية، أو التعليقات المضمنة من الرسومات المعمارية.

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

حدد المكان الذي سيتم حفظ الملفات المحوّلة فيه. المثال أدناه ينشئ مجلدًا باسم ConvertedFiles في الدليل الجذر للتطبيق.

string outputFolder = Path.Combine("YOUR_OUTPUT_DIRECTORY", "ConvertedFiles");
Directory.CreateDirectory(outputFolder); // Ensure directory exists

لماذا: تحديد مسار إخراج مخصص يحافظ على تنظيم مشروعك ويسهّل العثور على ملفات TXT المولدة للمعالجة اللاحقة.

الخطوة 2: إعداد خيارات التحويل

فئة TxtConvertOptions تحتوي على الإعدادات المطلوبة للتحويل، مما يتيح لك تخصيص نهايات الأسطر، والترميز، وما إذا كان يجب تضمين الطبقات المخفية.

var txtOptions = new TxtConvertOptions
{
    Encoding = Encoding.UTF8,
    IncludeHiddenLayers = false
};

ما الذي يفعله: هذا الكائن يحدد للمحوّل بالضبط كيفية تمثيل النص، مما يضمن نتائج متسقة عبر مصادر DGN المختلفة.

الخطوة 3: تنفيذ التحويل

نفّذ التحويل باستخدام الخيارات المحددة مسبقًا. تعبير lambda ينشئ ملف الإخراج مباشرةً، متجنبًا التخزين المؤقت.

var convertOptions = new TextConvertOptions();

لماذا: استخدام lambda لـ Save يمنحك تحكمًا كاملاً في تدفق الإخراج، وهو مفيد بشكل خاص عند دمج التحويل في خدمات الويب أو العاملين الخلفيين.

الخطوة 4: تشغيل التحويل

أخيرًا، استدعِ طريقة Convert، مع تمرير مسار DGN المصدر، الصيغة المستهدفة، وكائن الخيارات.

converter.Convert(() => File.Create(Path.Combine(outputFolder, "output.txt")), convertOptions);

لماذا: الطريقة تتعامل مع جميع عمليات التحليل منخفضة المستوى، واستخراج النص، وكتابة الملفات في استدعاء واحد، مما يحرّرك من التعامل مع تفاصيل CAD المعقدة.

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

  • خطأ ملف غير موجود: تحقق من أن مسار ملف DGN مطلق أو نسبي بشكل صحيح بالنسبة للملف التنفيذي.
  • مشكلات الأذونات: تأكد من أن التطبيق يعمل تحت حساب يملك صلاحية كتابة إلى مجلد الإخراج.
  • أخطاء التحويل: تأكد من أن إصدار حزمة NuGet GroupDocs.Conversion يتطابق مع إصدار ملف الترخيص؛ الإصدارات غير المتطابقة قد تسبب فشلًا أثناء التشغيل.

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

يمكن دمج قدرة التحويل هذه في:

  1. استخراج البيانات: سحب التعليقات النصية من رسومات DGN للتحليلات أو التقارير.
  2. التشغيل البيني: إدخال النص المستخرج إلى أنظمة GIS، قواعد بيانات BIM، أو وحدات ERP القديمة التي تقبل فقط مدخلات نصية بسيطة.
  3. سير العمل الآلي: دمج خطوة التحويل في خطوط CI/CD لتوليد الوثائق تلقائيًا من ملفات التصميم.

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

عند معالجة دفعات كبيرة من ملفات CAD، احرص على مراعاة النصائح التالية:

  • تحسين استخدام الموارد: راقب استهلاك الذاكرة؛ تقوم GroupDocs بمعالجة الملفات في وضع البث، مما يحافظ على بصمة الذاكرة منخفضة حتى للرسومات التي تتضمن مئات الصفحات.
  • إدارة الذاكرة بفعالية: حرّر كائن Converter بعد كل تحويل لإطلاق الموارد غير المُدارة بسرعة.
  • المعالجة الدُفعية: استخدم Parallel.ForEach لتحويل ملفات DGN متعددة بشكل متزامن، لكن حدّ درجة التوازي لتجنب استنزاف وحدة المعالجة المركزية أو عرض النطاق الترددي للـ I/O.

الموارد

الخلاصة

تهانينا! لقد تعلمت كيفية create output folder C#، تحميل ملف DGN، وتحويله إلى TXT باستخدام GroupDocs.Conversion .NET. من خلال دمج هذه الخطوات في تطبيقاتك، ستُبسّط استخراج البيانات، وتحسّن التشغيل البيني، وتزيد من الإنتاجية العامة في سير عملك المرتكز على CAD.

استكشف صيغًا إضافية — مثل DGN → PDF أو DGN → DOCX — عن طريق استبدال TxtConvertOptions بفئة الخيارات المناسبة. تقدم مجموعة GroupDocs مجموعة API موحدة تغطي أكثر من 50 نوعًا من الملفات، بحيث يمكنك بناء محرك تحويل واحد قابل للصيانة لجميع مستندات الهندسة الخاصة بك.

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

س: ما هي صيغ الملفات التي يدعمها GroupDocs.Conversion؟
ج: أكثر من 50 صيغة، بما في ذلك PDF، DOCX، XLSX، DGN، DWG، DXF، و TXT.

س: هل هناك حد لحجم تحويل ملفات DGN؟
ج: لا يوجد حد ثابت؛ الأداء يتناسب مع الذاكرة RAM ووحدة المعالجة المتاحة. الملفات حتى 2 GB تتحول بشكل موثوق على الخوادم القياسية.

س: هل يمكنني تخصيص ترميز النص لملف TXT الناتج؟
ج: نعم — اضبط خاصية Encoding في TxtConvertOptions (مثل UTF‑8، ASCII).

س: كيف يجب أن أتعامل مع أخطاء التحويل في الإنتاج؟
ج: غلف استدعاء التحويل داخل كتلة try‑catch، سجّل تفاصيل ConversionException، ويمكنك إعادة المحاولة باستخدام تكوين احتياطي إذا لزم الأمر.

س: أين يمكنني العثور على مزيد من الأمثلة ومراجع API؟
ج: الوثائق الرسمية ومرجع API يوفران عينات كود واسعة ودلائل التكوين.

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

دروس ذات صلة