يجب أن تكون على دراية بمصطلح “إشارة مرجعية” والذي يمثل ميزة يمكنك الوصول إليها بسهولة عند الحاجة. أثناء العمل مع مستندات Word الكبيرة ، يمكنك في كثير من الأحيان إضافة إشارات مرجعية إلى بعض النصوص/الصفحات التي ترغب في تضمينها في قائمة الأماكن التي تريد الوصول إليها بسرعة إذا لزم الأمر. تتيح لك Microsoft Word العمل مع الإشارات المرجعية في المستندات من خلال إضافة وتحديث وحذف الإشارات المرجعية. كمطور .NET ، ومع ذلك ، فأنت ترغب في الحصول على وظيفة العمل مع مرجعية من داخل تطبيق C#/VB.NET الخاص بك. في هذه المدونة ، سنعرض كيفية إضافة إشارات مرجعية إلى مستند Word في C# باستخدام API المجاني والمفتوح المصدر ، npoi .

كيفية إدراج إشارة مرجعية في مستند Word باستخدام Microsoft Word؟

قبل أن نتمكن من التحقيق في تطوير تطبيق C# لإضافة إشارة مرجعية إلى كلمة DOCX ملف ، دعونا أولاً نلقي نظرة على كيفية القيام بذلك باستخدام Microsoft Word. تتيح لك Microsoft Word إنشاء إشارات مرجعية تشير إلى موقع معين في مستند Word الخاص بك. يمكنك إذن الانتقال إلى أي من هذه الإشارات المرجعية ويمكنك أيضًا حذفها إذا لم يكن مطلوبًا.

خطوات لإضافة إشارة مرجعية في مستند Word باستخدام Microsoft Word

لإضافة إشارة مرجعية في مستند Word من داخل Microsoft Word ، يمكنك استخدام الخطوات التالية.

  1. افتح Microsoft Word وابدأ بمستند فارغ.
  2. حدد نصًا أو صورة أو مكانًا في المستند الخاص بك حيث تريد إدراج إشارة مرجعية.
  3. من قائمة إدراج ، انقر فوق إشارة مرجعية . سيؤدي هذا إلى فتح قائمة الإشارة المرجعية لإضافة إشارة مرجعية.
  4. تحت اسم إشارة مرجعية ، اكتب اسمًا وانقر فوق إضافة. يمكنك تكرار الخطوات المذكورة أعلاه لإضافة مرجعية متعددة إلى مواقع مختلفة في المستند.

كيف تذهب إلى إشارة مرجعية؟

للانتقال إلى إشارة مرجعية محددة ، اكتب Ctrl+G لفتح انتقل إلى علامة التبويب في مربع Find واستبدل . تحت انتقل إلى ماذا ، انقر فوق إشارة مرجعية . أدخل أو حدد اسم المرجعية ، ثم انقر فوق انتقل إلى .

كيفية إدراج إشارة مرجعية في مستند Word باستخدام C#؟

الآن بعد أن رأينا كيفية إدراج إشارة مرجعية في مستند Word باستخدام Microsoft Word ، يمكننا التحرك نحو القيام بنفس الشيء باستخدام API NPOI لـ .NET في تطبيق C# الخاص بنا. إذا لم تكن قد قمت بالفعل بتثبيت NPOI API ، فيمكنك المرور من خلال دليلنا الشامل لـ NPOI API تثبيت في مشروع .NET الخاص بك.

دليل خطوة بخطوة لإضافة إشارة مرجعية في مستند Word باستخدام C# {.wp-block-heading}}

في هذه المرحلة ، يجب أن يكون مشروع .NET جاهزًا لكتابة التعليمات البرمجية لإدخال إشارة مرجعية في مستند Word باستخدام NPOI API في C#. يمكن استخدام الخطوات التالية لهذا الغرض.

  1. قم بإنشاء مثيل من xwpfdocument
  2. تحديد مثيل فئة CT_Bookmark
  3. أضف المرجعية إلى الفقرة
  4. احفظ الملف إلى القرص
//Creat document
XWPFDocument doc = new XWPFDocument();
CT_P para = doc.Document.body.AddNewP();
//Bookmark start
CT_Bookmark bookmark = new CT_Bookmark();
bookmark.name = "P1";
para.Items.Add(bookmark);
int idCount = para.Items.Count;
bookmark.id = idCount.ToString();
para.ItemsElementName.Add(ParagraphItemsChoiceType.bookmarkStart);
para.AddNewR().AddNewT().Value = "FileFormat.com - How to add bookmarks in Word Document.";
//Bookmark end
bookmark = new CT_Bookmark();
bookmark.id = idCount.ToString();
para.Items.Add(bookmark);
para.ItemsElementName.Add(ParagraphItemsChoiceType.bookmarkEnd);
//Save the file
using (FileStream file = File.Create("Bookmark.docx"))
{
    doc.Write(file);
}

الخاتمة

في هذه المقالة ، أظهرنا كيفية استخدام NPOI API بلغة البرمجة C# لإدراج إشارة مرجعية في مستند كلمة. NPOI API هي واجهة برمجة تطبيقات مفتوحة المصدر ومجاني للاستخدام للعمل مع مستندات Microsoft Word. يمكنك إلقاء نظرة على أمثلة أخرى NPOI للعمل مع ملفات المستندات في C#. لمزيد من الأمثلة على العمل مع NPOI ، ترقبوا.