قراءة التعليقات المترابطة وإضافتها وتحريرها في Excel باستخدام C#

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

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

  1. C# Excel API لإدارة التعليقات المترابطة
  2. إضافة تعليقات مترابطة في Excel باستخدام #C
  3. قراءة التعليقات المترابطة لخلية معينة في Excel
  4. قراءة كافة التعليقات المترابطة في Excel باستخدام #C
  5. تحرير تعليق مترابطة في Excel باستخدام #C
  6. حذف التعليقات المترابطة في Excel باستخدام #C
  7. مصادر مجانية

C# Excel API لإدارة التعليقات المترابطة

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

للاستفادة من واجهة برمجة التطبيقات (API)، يرجى إما تنزيل ملف DLL أو تثبيته من NuGet باستخدام الأمر التالي:

PM> Install-Package Aspose.Cells

إضافة تعليق مترابطة في Excel باستخدام #C

يمكننا بسهولة إضافة تعليقات مترابطة إلى ورقة عمل Excel باتباع الخطوات التالية:

  1. إنشاء مثيل لفئة المصنف.
  2. قم بالوصول إلى ورقة العمل المحددة من خلال الفهرس الخاص بها.
  3. أضف مؤلفًا إلى مجموعة ThreadedCommentAuthors باستخدام طريقة Add().
  4. احصل على كائن فئة ThreadedCommentAuthor للمؤلف الذي تم إنشاؤه حديثًا من خلال فهرسه.
  5. أضف التعليق المترابط باستخدام طريقة AddThreadedComment().يأخذ اسم الخلية ونص التعليق وكائن ThreadedCommentAuthor كوسائط.
  6. احفظ ملف Excel باستخدام أسلوب Workbook.Save(string).

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

// يوضح مثال التعليمات البرمجية هذا كيفية إضافة تعليقات مترابطة في ورقة عمل Excel
// إنشاء مثيل لفئة المصنف
Workbook workbook = new Workbook();

// الوصول إلى ورقة العمل الأولى
Worksheet worksheet = workbook.Worksheets[0];

// إضافة مؤلف
var authorIndex = workbook.Worksheets.ThreadedCommentAuthors.Add("Aspose Test", "", "");
var author = workbook.Worksheets.ThreadedCommentAuthors[authorIndex];

// إضافة تعليق مترابطة
worksheet.Comments.AddThreadedComment("A1", "Test Threaded Comment", author);

// احفظ ملف الإخراج
workbook.Save("AddThreadedComments_out.xlsx");

قراءة التعليقات المترابطة لخلية معينة في Excel

لقراءة التعليقات المترابطة من خلية محددة في ورقة عمل Excel، اتبع الخطوات التالية:

  1. قم بتحميل ملف Excel موجود باستخدام فئة المصنف.
  2. الوصول إلى ورقة العمل عن طريق الفهرس الخاص بها.
  3. احصل على تعليقات مترابطة لخلية معينة باستخدام طريقة GetThreadedComments().يأخذ اسم الخلية كوسيطة.
  4. قم بمراجعة جميع التعليقات المترابطة واقرأ التفاصيل.

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

// يوضح مثال التعليمات البرمجية هذا كيفية قراءة التعليقات المترابطة لخلية محددة في ورقة عمل Excel
// قم بتحميل ملف Excel موجود
Workbook workbook = new Workbook("AddThreadedComments_out.xlsx");

// الوصول إلى ورقة العمل الأولى
Worksheet worksheet = workbook.Worksheets[0];

// الحصول على تعليقات مترابطة لخلية معينة
var threadedComments = worksheet.Comments.GetThreadedComments("A1");

// قراءة التعليقات المترابطة
foreach (var comment in threadedComments)
{
    Console.WriteLine("Author Name: " + comment.Author.Name);
    Console.WriteLine("Threaded comment Notes:" + comment.Notes);
}

Author Name: author@domain.com
Threaded comment Notes:Test Threaded Comment

قراءة جميع التعليقات المترابطة في Excel باستخدام #C

وبالمثل، يمكننا قراءة جميع التعليقات المترابطة المتوفرة في ورقة عمل Excel باتباع الخطوات التالية:

  1. قم بتحميل ملف Excel موجود باستخدام فئة المصنف.
  2. قم بمراجعة جميع التعليقات وقراءة التعليقات المترابطة واحدة تلو الأخرى.

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

// يوضح مثال التعليمات البرمجية هذا كيفية قراءة التعليقات المترابطة لخلية محددة في ورقة عمل Excel
// قم بتحميل ملف Excel موجود
Workbook workbook = new Workbook("AddThreadedComments_out.xlsx");

// الوصول إلى ورقة العمل الأولى
Worksheet worksheet = workbook.Worksheets[0];

// الحصول على جميع التعليقات
var comments = worksheet.Comments;

// قراءة جميع التعليقات المترابطة
foreach (var comment in comments)
{ 
    // معالجة التعليقات المترابطة
    foreach (var threadedComment in comment.ThreadedComments)
    {
        Console.WriteLine("Author Name: " + threadedComment.Author.Name);
        Console.WriteLine("Threaded comment author User Id: " + threadedComment.Author.UserId);
        Console.WriteLine("Threaded comment author ProviderId:" + threadedComment.Author.ProviderId);
        Console.WriteLine("Threaded comment Notes:" + threadedComment.Notes);
    }
}

تحرير تعليق مترابطة في Excel باستخدام #C

يرجى اتباع الخطوات أدناه لتحديث أي من التعليقات المترابطة في Excel:

  1. قم بتحميل ملف Excel موجود باستخدام فئة المصنف.
  2. الوصول إلى ورقة العمل عن طريق الفهرس الخاص بها.
  3. احصل على تعليقات مترابطة لخلية معينة باستخدام طريقة GetThreadedComments().يأخذ اسم الخلية كوسيطة.
  4. تحديث خاصية ملاحظات التعليق.
  5. احفظ ملف Excel باستخدام أسلوب Workbook.Save(string).

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

// يوضح مثال التعليمات البرمجية هذا كيفية تحرير التعليقات المترابطة في ورقة عمل Excel
// قم بتحميل ملف Excel موجود
Workbook workbook = new Workbook("AddThreadedComments_out.xlsx");

// الوصول إلى ورقة العمل الأولى
Worksheet worksheet = workbook.Worksheets[0];

// الحصول على تعليقات مترابطة لخلية معينة
var threadedComments = worksheet.Comments.GetThreadedComments("A1");
var comment = threadedComments[0];

// قم بتحديث ملاحظة التعليق
comment.Notes = "Updated Comment";

// احفظ ملف الإخراج
workbook.Save("EditThreadedComments.xlsx");

حذف التعليقات المترابطة في Excel باستخدام #C

يمكننا أيضًا حذف التعليقات المترابطة لخلية معينة في ورقة عمل Excel باتباع الخطوات التالية:

  1. قم بتحميل ملف Excel موجود باستخدام فئة المصنف.
  2. الوصول إلى ورقة العمل عن طريق الفهرس الخاص بها.
  3. قم بإزالة تعليق من مجموعة التعليقات باستخدام طريقة RemoveAt().يأخذ اسم الخلية كوسيطة.
  4. احفظ ملف Excel باستخدام طريقة Save(string).

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

// يوضح مثال التعليمات البرمجية هذا كيفية حذف التعليقات المترابطة في ورقة عمل Excel
// قم بتحميل ملف Excel موجود
Workbook workbook = new Workbook("AddThreadedComments_out.xlsx");

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

// إزالة التعليقات
comments.RemoveAt("A1");

// احفظ ملف الإخراج
workbook.Save("DeleteThreadedComments.xlsx");

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

من فضلك الحصول على ترخيص مؤقت مجاني لقراءة التعليقات المترابطة وإضافتها وتحريرها في Excel دون قيود تجريبية. قم بزيارة صفحة “الترخيص المؤقت” الخاصة بنا للحصول على تعليمات سهلة الاتباع حول المطالبة برخصتك المجانية بسرعة.

التعليقات المترابطة في Excel – موارد مجانية

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

خاتمة

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

أنظر أيضا