تحويل الحقول في الفقرة

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

تأكد من تثبيت Aspose.Words لـ .NET وإعداد بيئة التطوير الخاصة بك قبل البدء.

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

لاستخدام Aspose.Words في مشروعك، تحتاج إلى إضافة المراجع الضرورية. تأكد من إضافة مرجع إلى مكتبة Aspose.Words في مشروعك.

الخطوة 2: تحميل الوثيقة

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

// المسار إلى دليل المستندات.
string dataDir = "YOUR DOCUMENTS DIRECTORY";

// قم بتحميل المستند.
Document doc = new Document(dataDir + "Linked fields.docx");

استبدل “دليل مستنداتك” بالمسار الفعلي لدليل مستنداتك.

الخطوة 3: تحويل الحقول إلى نص

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

doc.FirstSection.Body.LastParagraph.Range.Fields
     .Where(f => f.Type == FieldType.FieldIf)
     .ToList()
     .ForEach(f => f.Unlink());

يستخدم هذا الرمز مجموعة من أساليب LINQ لتصفية الحقول الموجودة في الفقرة الأخيرة من المستند ثم تحويلها إلى نص عادي عن طريق استدعاء الأمرUnlink() طريقة.

الخطوة 4: حفظ المستند المعدل

بمجرد تحويل الحقول، يمكنك حفظ المستند المعدل. استخدم الSave() طريقة لهذا. هنا مثال :

doc.Save(dataDir + "WorkingWithFields.TestFile.docx");

تأكد من تحديد المسار الصحيح واسم الملف للنسخ الاحتياطي.

مثال على التعليمات البرمجية المصدر لتحويل الحقول في الفقرة باستخدام Aspose.Words لـ .NET

// المسار إلى دليل المستندات.
string dataDir = "YOUR DOCUMENTS DIRECTORY";

// قم بتحميل المستند.
Document doc = new Document(dataDir + "Linked fields.docx");

// تحويل حقول IF إلى نص عادي في الفقرة الأخيرة من المستند.
doc.FirstSection.Body.LastParagraph.Range.Fields
     .Where(f => f.Type == FieldType.FieldIf)
     .ToList()
     .ForEach(f => f.Unlink());

// احفظ المستند المعدل.
doc.Save(dataDir + "WorkingWithFields.TestFile.docx");

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

س: ما هو حقل التحويل في Aspose.Words؟

ج: حقل التحويل في Aspose.Words هو نوع الحقل الذي يحول قيمة أو تعبير إلى تنسيق أو نوع بيانات آخر. على سبيل المثال، يمكنك استخدام حقل تحويل لتحويل تاريخ إلى تنسيق معين، أو رقم إلى نص، أو إجراء أنواع أخرى من التحويلات.

س: كيفية إدراج حقل تحويل في فقرة باستخدام Aspose.Words؟

ج: لإدراج حقل تحويل في فقرة باستخدام Aspose.Words، يمكنك اتباع الخطوات التالية:

  1. قم باستيراد فئة المستند من مساحة الاسم Aspose.Words.
  2. قم بإنشاء مثيل للمستند عن طريق تحميل المستند الموجود لديك.
  3. احصل على الفقرة التي تريد إدراج حقل التحويل فيها.
  4. استخدم الأسلوب InsertField لإدراج حقل التحويل باستخدام بناء الجملة الصحيح.

س: ما هي تنسيقات التحويل التي يدعمها Aspose.Words؟

ج: يدعم Aspose.Words نطاقًا واسعًا من تنسيقات التحويل في الحقول، بما في ذلك تنسيقات التاريخ وتنسيقات الأرقام وتنسيقات النص وتنسيقات العملات وتنسيقات النسبة المئوية والمزيد. يمكنك مراجعة وثائق Aspose.Words للحصول على قائمة كاملة بتنسيقات التحويل المتاحة.

س: كيفية تحديث حقل التحويل في مستند Word باستخدام Aspose.Words؟

ج: لتحديث حقل تحويل في مستند Word باستخدام Aspose.Words، يمكنك استخدام الأسلوب UpdateFields. تتكرر هذه الطريقة خلال المستند وتقوم بتحديث كافة الحقول، بما في ذلك حقول التحويل، وإعادة حساب القيم بناءً على البيانات الحالية.