إضافة تعليقات في ورقة عمل Excel C#

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

C# API لإضافة تعليقات في Excel

لإضافة التعليقات في أوراق عمل Excel ، سنستخدم Aspose.Cells for .NET. إنها واجهة برمجة تطبيقات قوية لمعالجة جداول البيانات تتيح لك إنشاء ملفات Excel من البداية. كما أنه يدعم تعديل وتحويل ملفات Excel الموجودة بسلاسة. يمكنك إما تنزيل API أو تثبيته باستخدام NuGet.

PM> Install-Package Aspose.Cells

أضف تعليقات إلى ورقة عمل Excel في C#

فيما يلي خطوات إضافة تعليقات إلى ورقة عمل Excel في C#.

يوضح نموذج التعليمات البرمجية التالي كيفية إضافة تعليق في ورقة عمل Excel باستخدام C#.

// إنشاء كائن مصنف
Workbook workbook = new Workbook("workbook.xlsx");

// الحصول على مرجع ورقة العمل الأولى بتمرير فهرس الورقة الخاص بها
Worksheet worksheet = workbook.Worksheets[0];

// إضافة تعليق إلى الخلية "F5"
int commentIndex = worksheet.Comments.Add("F5");

// الوصول إلى التعليق المضاف حديثًا
Comment comment = worksheet.Comments[commentIndex];

// ضبط ملاحظة التعليق
comment.Note = "Hello Aspose!";

// حفظ ملف Excel
workbook.Save("output.xlsx");

أضف صورة إلى تعليق في Excel باستخدام C#

يمكنك أيضًا إضافة صورة إلى التعليق في ورقة عمل Excel باتباع الخطوات التالية.

  • قم بتحميل ملف Excel باستخدام فئة مصنف.
  • احصل على مرجع لـ CommentCollection في ورقة العمل المطلوبة باستخدام خاصية Workbook.Worksheets[index] .Comments.
  • أضف تعليقًا جديدًا إلى المجموعة واحصل على مرجعها في كائن تعليق.
  • عيّن ملاحظة التعليق باستخدام خاصية Comment.Note.
  • قم بتحميل الصورة من ملف إلى كائن نقطي.
  • احفظ الصورة النقطية في كائن MemoryStream.
  • أضف صورة إلى التعليق باستخدام خاصية Comment.CommentShape.Fill.ImageData.
  • احفظ ملف Excel المحدث باستخدام طريقة Workbook.Save(string).

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

// إنشاء كائن مصنف
Workbook workbook = new Workbook("workbook.xlsx");

// الحصول على مرجع لمجموعة التعليقات مع الورقة الأولى
CommentCollection comments = workbook.Worksheets[0].Comments;

// إضافة تعليق إلى الخلية A1
int commentIndex = comments.Add(0, 0);
Comment comment = comments[commentIndex];
comment.Note = "First note.";
comment.Font.Name = "Times New Roman";

// تحميل صورة في الدفق
Bitmap bmp = new Bitmap("logo.jpg");
MemoryStream ms = new MemoryStream();
bmp.Save(ms, System.Drawing.Imaging.ImageFormat.Png);

// ضبط بيانات الصورة على الشكل المرتبط بالتعليق
comment.CommentShape.Fill.ImageData = ms.ToArray();

// حفظ المصنف
workbook.Save("book1.xlsx");

تطبيق التنسيق على التعليقات في Excel باستخدام C#

فيما يلي خطوات تطبيق التنسيق على التعليقات في Excel باستخدام C#.

  • قم بتحميل ملف Excel باستخدام فئة مصنف.
  • احصل على مرجع من ورقة العمل المطلوبة من مجموعة Workbook.Worksheets.
  • أضف تعليقًا إلى ورقة العمل باستخدام طريقة Worksheet.Comments.Add(string) واحصل على مرجع التعليق في كائن Comment.
  • عيّن ملاحظة التعليق باستخدام خاصية Comment.Note.
  • قم بتعيين خيارات التنسيق المطلوبة للتعليق.
  • احفظ ملف Excel المحدث باستخدام طريقة Workbook.Save(string).

يوضح نموذج التعليمات البرمجية التالي كيفية تعيين تنسيق التعليقات في Excel باستخدام C#.

// إنشاء كائن مصنف
Workbook workbook = new Workbook("workbook.xlsx");

// الحصول على مرجع ورقة العمل الأولى بتمرير فهرس الورقة الخاص بها
Worksheet worksheet = workbook.Worksheets[0];

// إضافة تعليق إلى الخلية "F5"
int commentIndex = worksheet.Comments.Add("F5");

// الوصول إلى التعليق المضاف حديثًا
Comment comment = worksheet.Comments[commentIndex];

// ضبط ملاحظة التعليق
comment.Note = "Hello Aspose!";

// ضبط حجم خط التعليق على 14
comment.Font.Size = 14;

// ضبط خط التعليق على غامق
comment.Font.IsBold = true;

// ضبط ارتفاع الخط على 10
comment.HeightCM = 10;

// ضبط عرض الخط على 2
comment.WidthCM = 2;

// حفظ ملف Excel
workbook.Save("output.xlsx");

احصل على رخصة مجانية

يمكنك استخدام Aspose.Cells for .NET بدون قيود تقييمية باستخدام ترخيص مؤقت.

استنتاج

في هذه المقالة ، تعلمت كيفية إضافة تعليقات إلى أوراق عمل Excel باستخدام C#. علاوة على ذلك ، لقد رأيت كيفية إضافة صورة إلى تعليق برمجيًا. يمكنك بسهولة دمج الكود المقدم في تطبيقاتك المستندة إلى .NET أو .NET Core أو Xamarin. بالإضافة إلى ذلك ، يمكنك استكشاف وثائق Aspose.Cells for .NET. في حال كان لديك أي استفسارات ، فلا تتردد في النشر على المنتدى الخاص بنا.

أنظر أيضا