حماية الصف في ورقة عمل Excel

في هذا البرنامج التعليمي، سنلقي نظرة على بعض التعليمات البرمجية المصدر لـ C# التي تستخدم مكتبة Aspose.Cells لحماية الصفوف في جدول بيانات Excel. سنتعرف على كل خطوة من خطوات الكود ونشرح كيفية عمله. اتبعي التعليمات بعناية للحصول على النتائج المرجوة.

الخطوة 1: المتطلبات الأساسية

قبل البدء، تأكد من تثبيت مكتبة Aspose.Cells لـ .NET. يمكنك الحصول عليه من موقع Aspose الرسمي. تأكد أيضًا من أن لديك إصدارًا حديثًا من Visual Studio أو أي بيئة تطوير أخرى لـ C#.

الخطوة 2: استيراد مساحات الأسماء المطلوبة

لاستخدام مكتبة Aspose.Cells، نحتاج إلى استيراد مساحات الأسماء الضرورية إلى الكود الخاص بنا. أضف الأسطر التالية إلى أعلى ملف مصدر C# الخاص بك:

using Aspose.Cells;

الخطوة 3: إنشاء مصنف Excel

في هذه الخطوة، سنقوم بإنشاء مصنف Excel جديد. استخدم الكود التالي لإنشاء مصنف Excel:

// المسار إلى دليل المستندات.
string dataDir = "YOUR_DIRECTORY_OF_DOCUMENTS";

// إنشاء مصنف جديد.
Workbook wb = new Workbook();

تأكد من استبدال"YOUR_DOCUMENTS_DIR" بالمسار المناسب إلى دليل المستندات الخاص بك.

الخطوة 4: إنشاء جدول بيانات

الآن بعد أن أنشأنا مصنف Excel، فلنقم بإنشاء ورقة عمل ونحصل على الورقة الأولى. استخدم الكود التالي:

// قم بإنشاء كائن جدول بيانات واحصل على الورقة الأولى.
Worksheet sheet = wb.Worksheets[0];

الخطوة 5: تحديد النمط

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

// تعريف كائن النمط.
Styling styling;

الخطوة 6: قم بالتكرار لفتح جميع الأعمدة

سنقوم الآن بتمرير كافة الأعمدة الموجودة في ورقة العمل وإلغاء قفلها. استخدم الكود التالي:

// قم بالمرور عبر كافة الأعمدة الموجودة في ورقة العمل وقم بإلغاء قفلها.
for (int i = 0; i <= 255; i++)
{
     style = sheet.Cells.Columns[(byte)i].Style;
     style. IsLocked = false;
     sheet.Cells.Columns[(byte)i].ApplyStyle(style);
}

الخطوة 7: قفل السطر الأول

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

// احصل على نمط السطر الأول.
style = sheet.Cells.Rows[0].Style;
// قفل النمط.
style. IsLocked = true;
// تطبيق النمط على السطر الأول.
sheet.Cells.ApplyRowStyle(0, style);

الخطوة 8: حماية ورقة العمل

الآن بعد أن قمنا بتعيين الأنماط وتأمين الصفوف، فلنحمي جدول البيانات. استخدم الكود التالي:

// حماية ورقة العمل.
sheet.Protect(ProtectionType.All);

الخطوة 9: حفظ ملف Excel

وأخيرا، سوف نقوم بحفظ ملف Excel المعدل. استخدم الكود التالي:

// احفظ ملف إكسل.
wb.Save(dataDir + "output.out.xls", SaveFormat.Excel97To2003);

تأكد من تحديد المسار الصحيح لحفظ ملف Excel المعدل.

نموذج التعليمات البرمجية المصدر لحماية الصف في ورقة عمل Excel باستخدام Aspose.Cells لـ .NET

//المسار إلى دليل المستندات.
string dataDir = "YOUR DOCUMENT DIRECTORY";
// قم بإنشاء الدليل إذا لم يكن موجودًا بالفعل.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
    System.IO.Directory.CreateDirectory(dataDir);
// إنشاء مصنف جديد.
Workbook wb = new Workbook();
// قم بإنشاء كائن ورقة عمل واحصل على الورقة الأولى.
Worksheet sheet = wb.Worksheets[0];
// تحديد كائن النمط.
Style style;
// تحديد كائن styleflag.
StyleFlag flag;
// قم بالمرور عبر كافة الأعمدة الموجودة في ورقة العمل وقم بإلغاء قفلها.
for (int i = 0; i <= 255; i++)
{
    style = sheet.Cells.Columns[(byte)i].Style;
    style.IsLocked = false;
    flag = new StyleFlag();
    flag.Locked = true;
    sheet.Cells.Columns[(byte)i].ApplyStyle(style, flag);
}
// احصل على نمط الصف الأول.
style = sheet.Cells.Rows[0].Style;
// أغلق.
style.IsLocked = true;
//إنشاء مثيل للعلم.
flag = new StyleFlag();
// اضبط إعداد القفل.
flag.Locked = true;
// قم بتطبيق النمط على الصف الأول.
sheet.Cells.ApplyRowStyle(0, style, flag);
// حماية الورقة.
sheet.Protect(ProtectionType.All);
// احفظ ملف الاكسل.
wb.Save(dataDir + "output.out.xls", SaveFormat.Excel97To2003);

خاتمة

تهنئة ! لديك الآن كود مصدر C# الذي يسمح لك بحماية الصفوف في جدول بيانات Excel باستخدام مكتبة Aspose.Cells لـ .NET. تأكد من اتباع الخطوات بعناية وتخصيص الرمز وفقًا لاحتياجاتك المحددة.

الأسئلة الشائعة (الأسئلة المتداولة)

هل يعمل هذا الرمز مع الإصدارات الأخيرة من Excel؟

نعم، يعمل هذا الرمز مع الإصدارات الحديثة من Excel، بما في ذلك الملفات بتنسيق Excel 2010 والإصدارات الأحدث.

هل يمكنني حماية صفوف محددة فقط بدلاً من كافة الصفوف في ورقة العمل؟

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

كيف يمكنني فتح الخطوط المقفلة مرة أخرى؟

يمكنك استخدام الIsLocked طريقةStyle كائن لتعيين القيمة إليهfalse وفتح الصفوف.

هل من الممكن حماية أوراق عمل متعددة في نفس مصنف Excel؟

نعم، يمكنك تكرار خطوات إنشاء ورقة عمل وتعيين النمط والحماية لكل ورقة عمل في المصنف.

كيف يمكنني تغيير كلمة مرور حماية جداول البيانات؟

يمكنك تغيير كلمة المرور باستخدامProtect الطريقة وتحديد كلمة مرور جديدة كوسيطة.