أضف إشارة مرجعية في Word باستخدام NET REST API

تستلزم هذه المقالة عملية إضافة إشارة مرجعية في Word باستخدام NET REST API. سنستخدم Aspose.Words لـ .NET Cloud SDK ** لإضافة إشارة مرجعية إلى مستند Word باستخدام C# Low Code API**. ستقوم بتعيين معلمات مرجعية مختلفة واستدعاء استدعاءات API لإضافة هذه الإشارة المرجعية إلى ملف Word الخاص بك على القرص المحلي.

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

خطوات إنشاء إشارة مرجعية في Word باستخدام NET REST API

  1. قم بتعيين معرف العميل وسر العميل لواجهة برمجة التطبيقات (API) لإضافة إشارة مرجعية
  2. قم بإنشاء مثيل لكائن من فئة WordsApi باستخدام بيانات اعتماد العميل الخاصة بك
  3. اقرأ ملف Word المصدر في دفق الذاكرة لإنشاء إشارة مرجعية
  4. حدد نطاق البداية والنهاية للإشارة المرجعية باستخدام فئة PositionInsideNode
  5. قم بإنشاء كائن InsertBookmarkOnlineRequest عن طريق توفير المعلمات المطلوبة
  6. اتصل بأسلوب InsertBookmarkOnline بـ insert a bookmark وفقًا لـ InsertBookmarkOnlineRequest
  7. احفظ ملف Word الناتج باستخدام الإشارة المرجعية الجديدة

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

رمز لإدراج إشارة مرجعية في Word باستخدام C# REST API

using System;
using System.IO;
using Aspose.Words.Cloud.Sdk;
using Aspose.Words.Cloud.Sdk.Model;
using Aspose.Words.Cloud.Sdk.Model.Requests;
namespace WordsSample.Words
{
public class Bookmarks
{
public void AddBookmark()
{
try
{
// Set the client secret and ID
var config = new Configuration();
config.ClientSecret = "Client Secret";
config.ClientId = "Client ID";
// Instantiate the WordsApi object
var wordsApi = new WordsApi(config);
// Read the input file
using var requestDocument = File.OpenRead("Sample.docx");
// Define start and end range for the bookmark
var requestBookmarkStartRange = new PositionInsideNode
{
NodeId = "0.0.0.0",
Offset = 0
};
var requestBookmarkEndRange = new PositionInsideNode()
{
NodeId = "0.0.0.0",
Offset = 0
};
// Initialize the BookmarkInsert object
var requestBookmark = new BookmarkInsert()
{
StartRange = requestBookmarkStartRange,
EndRange = requestBookmarkEndRange,
Name = "new_bookmark",
Text = "Some text"
};
string output = "output.docx";
// Insert the bookmark
var insertRequest = new InsertBookmarkOnlineRequest(requestDocument, requestBookmark,destFileName:output);
var insertTask = wordsApi.InsertBookmarkOnline(insertRequest);
insertTask.Wait();
var result = insertTask.Result;
// Save the Word file with the bookmark
if (result.Document.TryGetValue(output, out var stream))
{
stream.Position = 0;
using (var fileStream = File.Create(output))
{
stream.Seek(0, SeekOrigin.Begin);
stream.CopyTo(fileStream);
}
}
}
catch (Exception e)
{
Console.WriteLine(e.Message);
}
}
}
}

يعرض نموذج التعليمات البرمجية هذا كيفية إضافة إشارة مرجعية في Word باستخدام C# REST API. يتم استخدام فئة PositionInsideNode لتعيين نطاق البداية والنهاية للإشارة المرجعية في ملف Word الوجهة. يتم إرجاع الدفق الناتج كعنصر قاموس بالمفتاح المحدد ويمكن استرجاعه باستخدام أسلوب TryGetValue كما هو موضح في نموذج التعليمات البرمجية.

في هذا الموضوع، تعلمنا كيفية إنشاء إشارة مرجعية في Word باستخدام C# REST API. إذا كنت تريد تحويل ملف Word إلى ملف HTML، فارجع إلى المقالة الموجودة على قم بتحويل DOCX إلى HTML باستخدام NET REST API.

 عربي