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

تحويل رسم DGN إلى PDF هو خطوة شائعة عندما تحتاج إلى مشاركة ملفات CAD مع أصحاب المصلحة الذين لا يمتلكون برامج متخصصة. في هذا البرنامج التعليمي ستتعلم كيفية تحويل dgn إلى pdf بسرعة وبشكل موثوق باستخدام GroupDocs.Conversion لـ .NET. سنستعرض عملية التثبيت والترخيص ومثالًا كاملاً للكود، ثم نوضح لك كيفية تحسين الأداء للرسومات الهندسية الكبيرة.

إجابات سريعة

أي مكتبة تتعامل مع التحويل؟ GroupDocs.Conversion for .NET.
ما هو استدعاء الطريقة الأساسي؟ converter.Convert(sourcePath, new PdfConvertOptions()).
ما هي صيغ CAD المدعومة؟ Over 30, including DGN, DWG, DXF.
ما هو الحد الأقصى لحجم الملف؟ Up to 2 GB can be processed without loading the whole file into memory.
ما هو متطلب الترخيص؟ A valid GroupDocs license is needed for production use.

ما هو تحويل dgn إلى pdf؟

convert dgn to pdf هي عملية تحويل ملف MicroStation DGN إلى تنسيق المستندات القابلة للعرض (PDF) يحافظ على الرسومات المتجهية، الطبقات، سماكة الخطوط، والتعليقات التوضيحية. يتيح هذا التحويل عرضًا دقيقًا، طباعة، وتوزيعًا سهلاً عبر أي منصة، مما يسمح للمستخدمين الذين لا يمتلكون برنامج CAD بمشاهدة الرسم كما هو مقصود.

لماذا تستخدم GroupDocs.Conversion لـ .NET؟

يدعم GroupDocs.Conversion أكثر من 30 صيغة إدخال وإخراج ويمكنه معالجة الملفات حتى 2 GB مع الحفاظ على استهلاك الذاكرة أقل من 100 MB بفضل بنية البث الخاصة به. تعمل المكتبة على .NET Framework 4.6+، .NET Core 3.1+، و .NET 6+، مما يجعلها مناسبة لسيناريوهات سطح المكتب، الويب، والسحابة.

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

GroupDocs.Conversion لـ .NET (الإصدار 25.3.0 أو أحدث)
بيئة تطوير مثل Visual Studio 2022 أو Visual Studio Code
.NET 6 SDK مثبت على جهازك
ملف ترخيص GroupDocs صالح (تجريبي أو تجاري)

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

GroupDocs.Conversion لـ .NET – 25.3.0
Newtonsoft.Json – مطلوب لمعالجة التكوين الداخلي (يتم تثبيته تلقائيًا كاعتماد)

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

تأكد من أن وقت تشغيل .NET يتطابق مع إطار العمل المستهدف لمشروعك. يعمل GroupDocs.Conversion على Windows و Linux و macOS.

كيفية تحويل DGN إلى PDF في C#؟

الفئة Converter هي المكوّن الأساسي الذي يحمل المستند ويجري تحويلات الصيغ. PdfConvertOptions تحدد إعدادات إخراج PDF مثل حجم الصفحة وتضمين الخطوط. قم بتحميل ملف DGN المصدر، ضبط خيارات التحويل، واستدعِ طريقة Convert – يمكن تنفيذ العملية بالكامل في ثلاث أسطر من الكود. يضمن هذا النهج المباشر أن الطبقات، سماكة الخطوط، وتعليقات النص تُعاد إنتاجها بأمان في ملف PDF الناتج.

// Define paths
string outputFolder = Path.Combine(@"YOUR_OUTPUT_DIRECTORY");
string documentPath = Path.Combine(@"YOUR_DOCUMENT_DIRECTORY\sample.dgn");

// Initialize the converter and perform conversion
var converter = new GroupDocs.Conversion.Converter(documentPath);
converter.Convert(outputFolder, new GroupDocs.Conversion.Options.PdfConvertOptions());

المقتطف أعلاه يوضح سير العمل الأساسي: إنشاء كائن من الفئة Converter، تحديد موقع الإخراج، وتمرير كائن PdfConvertOptions. المكتبة تكتشف تلقائيًا صيغة DGN وتطبق محرك العرض المناسب.

دليل خطوة بخطوة

الخطوة 1: تثبيت حزمة NuGet

افتح Package Manager Console في Visual Studio وشغّل:

Install-Package GroupDocs.Conversion -Version 25.3.0

أو استخدم .NET CLI إذا كنت تفضّل التثبيت عبر سطر الأوامر:

dotnet add package GroupDocs.Conversion --version 25.3.0

كلا الأمرين يضيفان أحدث حزمة مستقرة من GroupDocs.Conversion إلى مشروعك.

الخطوة 2: إضافة الترخيص الخاص بك

ضع ملف GroupDocs.Conversion.lic في جذر مشروعك وسجّله عند بدء التطبيق:

GroupDocs.Conversion.License license = new GroupDocs.Conversion.License();
license.SetLicense("GroupDocs.Conversion.lic");

نصيحة احترافية: احتفظ بملف الترخيص خارج نظام التحكم في المصدر وحمّله من موقع آمن في بيئة الإنتاج.

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

استخدم كتلة الكود المعروضة سابقًا. عدّل outputFolder و documentPath لتشير إلى الدلائل الفعلية الخاصة بك. تسمح لك فئة PdfConvertOptions بالتحكم في حجم الصفحة، الاتجاه، وما إذا كان يجب تضمين الخطوط.

الخطوة 4: التحقق من النتيجة

بعد التحويل، افتح ملف PDF المُنشأ في أي عارض لتأكيد أن جميع عناصر الرسم تظهر بشكل صحيح. للمعالجة الدفعية، غلف استدعاء التحويل داخل حلقة foreach على مجموعة من ملفات DGN.

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

الخطوط المفقودة – تأكد من تثبيت خطوط CAD المطلوبة على الجهاز المضيف أو قم بتضمينها عبر PdfConvertOptions.EmbedFonts = true.
الملفات الكبيرة تسبب مهلات – زد مهلة طلب HTTP إذا كنت تُجري التحويل في واجهة برمجة تطبيقات ويب، أو قسّم الرسم إلى أوراق أصغر قبل التحويل.
الترخيص غير موجود – تحقق من مسار GroupDocs.Conversion.lic وتأكد من أن الملف يمتلك أذونات القراءة للعملية الجارية.

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

س: هل يمكنني تحويل ملفات DGN المحمية بكلمة مرور؟
ج: نعم. قدّم كلمة المرور عبر مُحمل Converter الذي يقبل كائن LoadOptions. يتيح لك LoadOptions توفير معلمات إضافية مثل كلمات المرور عند تحميل المستند.

س: هل تعمل المكتبة على حاويات Linux؟
ج: بالطبع. GroupDocs.Conversion لـ .NET متوافق تمامًا مع الأنظمة المتعددة ويعمل في حاويات Docker المستندة إلى Alpine أو Ubuntu.

س: ما إصدارات .NET المدعومة؟
ج: .NET Framework 4.6+، .NET Core 3.1+، .NET 5، و .NET 6 كلها مدعومة رسميًا.

س: كيف يمكنني معالجة تحويل دفعي لآلاف الرسومات؟
ج: استخدم المعالجة غير المتزامنة مع Task.WhenAll (Task.WhenAll ينتظر إكمال عمليات غير متزامنة متعددة) وحدد حدًا للتوازي لتجنب استنزاف وحدة المعالجة المركزية أو الذاكرة.

س: هل هناك طريقة لتحويل تخطيط أو ورقة محددة فقط؟
ج: نعم. اضبط PdfConvertOptions.Layouts إلى مجموعة تحتوي على معرفات التخطيطات المطلوبة.

الخلاصة

أنت الآن تمتلك دليلًا كاملاً وجاهزًا للإنتاج لتحويل dgn إلى pdf باستخدام GroupDocs.Conversion لـ .NET. باتباع الخطوات أعلاه، يمكنك دمج تحويل CAD إلى PDF في أدوات سطح المكتب، خدمات الويب، أو خطوط الأنابيب الآلية بأقل جهد. استكشف خيارات إضافية مثل وضع العلامات المائية، التشفير، وتحديد حجم الصفحة المخصص لتكييف الناتج مع معايير مؤسستك.

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

using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;

// Initialize converter object
groupdocsConversion = new Converter("path/to/your/file.dgn");

// Convert to PDF settings
PdfConvertOptions options = new PdfConvertOptions();

{< /blocks/products/pf/tutorial-page-section >} {< /blocks/products/pf/main-container >} {< /blocks/products/pf/main-wrap-class >} {< blocks/products/products-backtop-button >}