أضف علامة مائية إلى مستندات Word باستخدام REST API في C#

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

سيتم تناول الموضوعات التالية في هذه المقالة:

Watermark REST API و .NET SDK

لإضافة نص أو علامة مائية للصورة إلى ملفات DOCX ، سأستخدم .NET SDK من GroupDocs.Watermark Cloud API. يسمح لك بإضافة العلامات المائية وإزالتها والبحث عنها واستبدالها برمجيًا من الصور والمستندات بتنسيقات الملفات المدعومة مثل PDF و Microsoft Word و Powerpoint. علاوة على ذلك ، يمكنك التحكم في تخصيص العلامات المائية عن طريق تحديد نمط النص أو الخط أو الحجم أو اللون أو الموضع وفقًا لمتطلباتك. حاليًا ، يوفر أيضًا Java SDK لـ Cloud API.

يمكنك تثبيت GroupDocs.Watermark Cloud في مشروع Visual Studio الخاص بك من NuGet Package Manager أو باستخدام الأمر التالي في وحدة تحكم مدير الحزم:

Install-Package GroupDocs.Watermark-Cloud

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

string clientId = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5";
string clientSecret = "479db2b01dcb93a3d4d20efb16dea971";
string myStorage = "";

var configuration = new Configuration(clientId, clientSecret);
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";

أضف علامة مائية نصية إلى مستندات Word باستخدام واجهة برمجة تطبيقات REST في C#

يمكنك إضافة أي نص كعلامة مائية إلى مستندات Word الخاصة بك برمجيًا باتباع الخطوات البسيطة المذكورة أدناه:

قم بتحميل المستند

أولاً ، قم بتحميل مستند Word إلى Cloud باستخدام مثال الرمز الموضح أدناه:

// تهيئة api
var fileApi = new FileApi(configuration);

// فتح ملف
var fileStream = File.Open(@"C:\Files\sample.docx", FileMode.Open);

// إنشاء طلب تحميل ملف
var request = new UploadFileRequest("sample.docx", fileStream, MyStorage);

// رفع ملف
fileApi.UploadFile(request);
fileStream.Close();

نتيجة لذلك ، سيتم تحميل ملف DOCX إلى التخزين السحابي وسيكون متاحًا في قسم الملفات من لوحة المعلومات الخاصة بك.

أضف علامة مائية نصية إلى DOCX باستخدام C#

يمكنك إضافة علامة مائية نصية إلى ملف DOCX برمجيًا باتباع الخطوات الواردة أدناه.

  • قم بإنشاء مثيل لـ WatermarkApi
  • قم بإنشاء مثيل FileInfo
  • قم بتعيين مسار ملف DOCX
  • قم بإنشاء WatermarkOptions وقم بتعيين FileInfo
  • قم بإنشاء TextWatermarkOptions
  • قم بتعيين النص ومجموعة الخط وحجم الخط ومحاذاة النص
  • قم بتعيين لون المقدمة لنص العلامة المائية
  • حدد موضع العلامة المائية
  • حدد WatermarkDetails وقم بتعيين TextWatermarkOptions and Position
  • قم بإنشاء AddRequest باستخدام WatermarkOptions
  • احصل على النتائج عن طريق استدعاء طريقة WatermarkApi.add()

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

// تهيئة api
var apiInstance = new WatermarkApi(configuration);

// مسار ملف الإدخال
var fileInfo = new FileInfo
{
    FilePath = "sample.docx"
};

// إنشاء خيارات العلامة المائية
var options = new WatermarkOptions()
{
    FileInfo = fileInfo,
    
    // تحديد تفاصيل العلامة المائية
    WatermarkDetails = new List<WatermarkDetails>
    {
        new WatermarkDetails
        {
            // تحديد نص العلامة المائية
            TextWatermarkOptions = new TextWatermarkOptions
            {
                Text = "Copyright© 2021",
                FontFamilyName = "Arial",
                FontSize = 22d,
                TextAlignment = "Center",
                ForegroundColor = new Color()
                {
                    Name = "Red"
                }
            },

            // تعيين موضع العلامة المائية
            Position = new Position()
            {
                X = 230.0,
                Y = 500.0
            }
        }
    }
};

// إنشاء طلب الإضافة
var request = new AddRequest(options);

// أضف علامة مائية
var response = apiInstance.Add(request);

Console.WriteLine("Resultant file path: " + response.DownloadUrl);
أضف علامة مائية نصية إلى مستندات Word باستخدام واجهة برمجة تطبيقات REST في C#

أضف علامة مائية نصية إلى مستندات Word باستخدام واجهة برمجة تطبيقات REST في C#

قم بتنزيل الملف المحدث

سيحفظ نموذج الكود أعلاه ملف Word بعلامة مائية نصية على السحابة. يمكنك تنزيله باستخدام نموذج التعليمات البرمجية التالي:

// تهيئة api
var fileApi = new FileApi(configuration);

// مسار ملف التقصير على السحابة
var file = "watermark/added_watermark/sample_docx/sample.docx";

// طلب إنشاء ملف تنزيل
var downloadRequest = new DownloadFileRequest(file, myStorage);

// تحميل الملف
Stream downloadResponse = fileApi.DownloadFile(downloadRequest);

// حفظ الملف في دليل العمل
using (var fileStream = System.IO.File.Create("C:\\Files\\DownloadedFile.docx"))
{
    downloadResponse.Seek(0, SeekOrigin.Begin);
    downloadResponse.CopyTo(fileStream);
}

أضف علامة مائية للصورة إلى مستندات Word باستخدام واجهة برمجة تطبيقات REST

يمكنك إضافة صورة أو شعار كعلامة مائية إلى مستندات Word الخاصة بك برمجيًا باتباع الخطوات الواردة أدناه.

  • قم بإنشاء مثيل لـ WatermarkApi
  • قم بإنشاء مثيل FileInfo
  • قم بتعيين مسار ملف DOCX
  • قم بإنشاء WatermarkOptions وقم بتعيين FileInfo
  • إنشاء خيارات ImageWatermarkOptions
  • قم بتعيين مسار ملف صورة PNG إلى علامة مائية باستخدام
  • حدد موضع العلامة المائية
  • قم بإنشاء تفاصيل العلامة المائية
  • تعيين خيارات ImageWatermarkOptions والموقع
  • اضبط WatermarkDetails على قائمة
  • قم بإنشاء AddRequest باستخدام WatermarkOptions
  • احصل على النتائج عن طريق استدعاء طريقة WatermarkApi.add()

يوضح نموذج التعليمات البرمجية التالي كيفية إضافة صورة كعلامة مائية إلى DOCX باستخدام واجهة برمجة تطبيقات REST في C#. يرجى اتباع الخطوات المذكورة سابقاً لتحميل وتنزيل الملفات.

// تهيئة api
var apiInstance = new WatermarkApi(configuration);

// مسار ملف الإدخال
var fileInfo = new FileInfo
{
    FilePath = "sample.docx"
};

// إنشاء خيارات العلامة المائية
var options = new WatermarkOptions()
{
    FileInfo = fileInfo,
    // تحديد تفاصيل العلامة المائية
    WatermarkDetails = new List<WatermarkDetails>
    {
        new WatermarkDetails
        {
            // تحديد صورة العلامة المائية
            ImageWatermarkOptions = new ImageWatermarkOptions()
            {
                Image = new FileInfo { 
                    FilePath = "logo.png" 
                }
            },

            // تعيين موضع العلامة المائية
            Position = new Position()
            {
                X = 180.0,
                Y = 280.0
            }
        }
    }
};

// إنشاء طلب الإضافة
var request = new AddRequest(options);

// أضف علامة مائية
var response = apiInstance.Add(request);

Console.WriteLine("Resultant file path: " + response.DownloadUrl);
أضف علامة مائية على الصور باستخدام واجهة برمجة تطبيقات REST في C#

إضافة علامة مائية إلى مستندات Word باستخدام واجهة برمجة تطبيقات REST في C#

جرب عبر الإنترنت

يرجى تجربة أداة العلامة المائية المجانية التالية عبر الإنترنت ، والتي تم تطويرها باستخدام واجهة برمجة التطبيقات المذكورة أعلاه. https://products.groupdocs.app/watermark/docx

خاتمة

في الختام ، تعلمت كيفية إضافة نص أو علامة مائية للصورة إلى مستند Word على السحابة. لقد تعلمت أيضًا كيفية تحميل ملفات DOCX برمجيًا على السحابة ثم تنزيل الملف المحدث من السحابة. يمكنك معرفة المزيد حول GroupDocs.Watermark Cloud API من الوثائق. نوفر أيضًا قسم مرجع واجهة برمجة التطبيقات الذي يتيح لك تصور واجهات برمجة التطبيقات الخاصة بنا والتفاعل معها مباشرةً من خلال المتصفح. في حالة وجود أي غموض ، لا تتردد في الاتصال بـ الدعم.

أنظر أيضا