تؤدي العلامات المائية دورًا حيويًا في إدارة المستندات الاحترافية - من هوية العلامة التجارية إلى حماية المحتوى. في Excel ، يمكن أن تحدد العلامات المائية ورقة على أنها “سرية” أو “مسودة” أو تتضمن شعار الشركة لضمان تماسك العلامة التجارية. توفر هذه المقالة التفاصيل اللازمة حول مجموعة أدوات تطوير البرمجيات المستندة إلى السحابة الخاصة بنا والتي توفر المرونة والأتمتة والدقة لإدراج علامة مائية في دفتر عمل Excel.

واجهة برمجة تطبيقات معالجة إكسل

Aspose.Cells Cloud SDK for .NET يقدم لمطوري C# طريقة متقدمة وقابلة للت扩يا وآمنة لإدارة ملفات Excel عبر الإنترنت. عندما يتعلق الأمر بالتوثيق، فإنه يوفر:

  • أتمتة قائمة على السحابة - أضف أو أزل العلامات المائية دون تثبيتات محلية.
  • دعم عبر المنصات – يعمل عبر .NET Core و .NET Framework وبيئات بدون خادم.
  • أداء عالي – يعالج كفاءًة دفاتر العمل الكبيرة في السحابة.
  • التكامل القائم على REST – يبسط التكامل باستخدام SDKs أو طلبات HTTP مباشرة.

سواء كنت بحاجة إلى تطبيق علامة مائية على أوراق عمل Excel للحماية أو العلامة التجارية، فإن Aspose.Cells Cloud يجعل العملية سهلة للغاية.

إعداد البيئة

قبل أن تبدأ في معالجة دفتر عمل Excel، تأكد من أنك لديك:

  1. حساب صالح Aspose.Cloud(للحصول على معرف العميل والسر).
  2. تم تثبيت Visual Studio أو أي بيئة تطوير متكاملة متوافقة مع .NET.
  3. ملف Excel (XLS أو XLSX) وملف صورة (شعار أو علامة مائية).

قم بتثبيت SDK باستخدام مدير حزم NuGet:

Install-Package Aspose.Cells-Cloud

Watermark Excel باستخدام C#

المثال التالي يوضح كيفية رفع ملف Excel إلى تخزين السحاب وتطبيق صورة علامة مائية باستخدام Aspose.Cells Cloud SDK لـ .NET.

  1. إنشاء مثيل لـ CellsApi حيث نقوم بتمرير بيانات اعتماد العميل كوسائط.
CellsApi cellsInstance = new CellsApi(clientID, clientSecret);
  1. قم برفع دفتر عمل Excel إلى تخزين سحابي.
cellsInstance.UploadFile(input_Excel, File.OpenRead(input_Excel));
  1. Convert image stream to byte array.
byte[] imageBytes = File.ReadAllBytes(watermarkImage);
  1. استدعِ واجهة برمجة التطبيقات لتطبيق صورة العلامة المائية كخلفية لجميع أوراق العمل في مصنف العمل.
var response = cellsInstance.CellsWorkbookPutWorkbookBackground(input_Excel, imageBytes, null);

// للحصول على مزيد من الأمثلة، يرجى زيارة https://github.com/aspose-cells-cloud/aspose-cells-cloud-dotnet/

// احصل على بيانات اعتماد العميل من https://dashboard.aspose.cloud/
string clientId = "CLIENT_ID";
string clientSecret = "CLIENT_SECRET";
string inputExcel = "input.xlsx";
string watermarkImage = "Watermark.png";

// create an instance of CellsApi class.
var cellsApi = new CellsApi(clientId, clientSecret);

// قم بتحميل ملف Excel المدخل إلى التخزين السحابي
using (var fileStream = File.OpenRead(inputExcel))
{
    cellsApi.UploadFile(inputExcel, fileStream);
}

// اقرأ ملف صورة العلامة المائية
byte[] imageBytes = File.ReadAllBytes(watermarkImage);

// إضافة علامة مائية إلى دفتر عمل Excel
var response = cellsApi.CellsWorkbookPutWorkbookBackground(inputExcel, imageBytes, null);

Console.WriteLine("Watermark successfully added to Excel workbook.");

إدراج علامة مائية في إكسل باستخدام cURL

إذا كنت تفضل الأتمتة من خلال سطر الأوامر أو عن طريق السكربتات، فإن Aspose.Cells Cloud يدعم أيضًا عمليات cURL القابلة لإعادة التشغيل.

Step 1. - إنشاء رمز وصول (ACCESSTOKEN) استنادًا إلى بيانات اعتماد العميل:

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=XXXXXX-XXXXXX-XXXXXX&client_secret=XXXXXXXXXXXXX" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

الخطوة 2- تحميل ملف Excel إلى التخزين السحابي.

curl -v "https://api.aspose.cloud/v3.0/cells/storage/file/{filePath}" \
-X PUT \
-F file=@{localFilePath} \
-H "Content-Type: multipart/form-data" \
-H "Authorization: Bearer {ACCESS_TOKEN}"

الخطوة 3 - إضافة صورة العلامة المائية إلى دفتر العمل Excel.

curl -v "https://api.aspose.cloud/v3.0/cells/{excelFile}/background" \
-X PUT \
-H  "accept: multipart/form-data" \
-H  "authorization: Bearer {ACCESS_TOKEN}" \
-H  "Content-Type: multipart/form-data" \
-d  "File":{"watermarkImage"}

Replace:

  • {excelFile} - اسم ملف Excel المدخل في تخزين السحابة.
  • {ACCESSTOKEN} - رمز JWT المولد أعلاه.
  • {watermarkImage} - ملف الصورة الذي سيتم استخدامه كعلامة مائية.

Watermark Excel Online

تريد اختبار الميزة بدون ترميز؟

جرّب تطبيق Free Online Excel Watermark App لدينا — الذي تدعمه Aspose.Cells Cloud. ما عليك سوى تحميل دفتر عمل Excel الخاص بك، وتطبيق شعارك أو صورة العلامة المائية، وتنزيل الملف الناتج على الفور.

watermark excel online

استنتاج

سواء كنت تقوم بتطوير نظام لأتمتة الوثائق أو دمج تمييز ملفات Excel في سير العمل الخاص بتطبيقك، فإن هذا SDK يمكّن من إضافة علامات مائية على Excel بسلاسة في السحابة - آمن، قابل للتوسع، وصديق للمطورين.

روابط مفيدة

الأسئلة الشائعة (FAQs)

  1. Does the Excel watermark API support both image and text watermarks? تسمح لك واجهة برمجة التطبيقات (API) بإضافة علامات مائية تعتمد على الصور (مثل PNG و JPEG أو BMP).فيما يتعلق بعلامات المياه المعتمدة على النصوص، يمكنك تنفيذها عن طريق وضع النص فوقه من خلال واجهات برمجة التطبيقات للرسم أو الأشكال.

  2. Can I apply a different watermark to each worksheet in the Excel file? نعم. يوفر Aspose.Cells Cloud SDK تحكمًا دقيقًا على أوراق العمل الفردية. يمكنك استخدام طريقة CellsWorksheetPutBackground() لتطبيق علامة مائية فريدة على ورقة عمل معينة بدلاً من المصنف بأكمله.

  3. هل أحتاج إلى تثبيت Microsoft Excel لاستخدام Aspose.Cells Cloud SDK؟ لا. SDK Aspose.Cells السحابي لـ .NET معتمد بالكامل على السحابة، مما يعني أنه يمكنك تطبيق أو إزالة العلامات المائية من ملفات Excel دون الحاجة إلى تثبيت Microsoft Excel أو أي برامج سطح مكتب إضافية.

  4. هل بياناتي آمنة أثناء معالجة علامة مائية في Excel على السحابة؟ نعم. تستخدم Aspose.Cells Cloud تشفير SSL لنقل البيانات وتخزن الملفات بأمان في السحابة. يتم حذف الملفات المرفوعة تلقائيًا بعد إتمام العملية (استنادًا إلى فترة الاحتفاظ التي تختارها لتخزينك المخصص).

مقالات موصى بها

نوصي بزيارة روابط g لمعرفة المزيد عن: