اكتب البرنامج النصي من جانب عميل GridWeb

يمكن للمطورين كتابة برامج نصية من جانب العميل لعنصر التحكم Aspose.Cells.GridWeb. هذا يعني أنه من الممكن استدعاء جانب العميل لوظيفة JavaScript لأداء مهمة محددة متعلقة بالتحكم في GridWeb. على سبيل المثال ، يمكن للمطورين كتابة وظائف JavaScript لإرسال بيانات GridWeb إلى خادم أو إظهار رسالة تنبيه عند حدوث خطأ في التحقق من الصحة وما إلى ذلك.

يشرح هذا الموضوع هذه الميزة بمساعدة الأمثلة.

كتابة البرامج النصية من جانب العميل لـ Aspose.Cells.GridWeb

معلومات اساسية

Aspose.Cells.GridWeb يوفر خاصيتين تم إنشاؤهما خصيصًا لدعم البرامج النصية من جانب العميل:

• OnSubmitClientFunction
• OnValidationErrorClientFunction

قم بإنشاء وظائف JavaScript في صفحة ASPX وقم بتعيين أسماء هذه الوظائف إلى خصائص OnSubmitClientFunction و OnValidationErrorClientFunction.

يجب تحديد وظيفة JavaScript التي سيتم تعيينها لخاصية OnSubmitClientFunction بشكل صحيح كما هو موضح أدناه:

جافا سكريبت

 function function_name(arg, cancelEdit)
{
//Add javascript code here

}

حيث تمثل المعلمة [arg] الأمر الذي تم إنشاؤه بواسطة عنصر التحكم. يمكن أن يكون الأمر “حفظ” و “إرسال” و “تراجع” وما إلى ذلك والمعلمة [إلغاء تحرير] هي قيمة منطقية ، والتي تشير إلى ما إذا كان إدخال المستخدم قد تم إلغاؤه أم لا.

يتم استدعاء أي وظيفة JavaScript مخصصة لخاصية OnSubmitClientFunction في كل مرة بواسطة عنصر التحكم GridWeb قبل إرسال بيانات GridWeb إلى الخادم. وبالمثل ، إذا تم تعيين دالة لخاصية OnValidationErrorClientFunction ، فسيتم استدعاء هذه الوظيفة في كل مرة يحدث فيها خطأ في التحقق من الصحة.

وظائف البرمجة النصية من جانب العميل

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

المهام	وصف
updateData (منطقي إلغاء تحرير)	يقوم بتحديث كافة بيانات العميل لـ Aspose.Cells.GridWeb قبل إرسالها إلى الخادم. إذا كانت المعلمة CancelEdit صحيحة ، فإن GridWeb يتجاهل كل مدخلات المستخدم.
تحقق من صحة الكل ()	يُستخدم للتحقق مما إذا كانت هناك أية أخطاء في التحقق من صحة إدخال المستخدم. إذا كان هناك خطأ ، فإن الدالة ترجع خطأ ، وإلا تكون صحيحة.
إرسال (سلسلة أحرف ، منطقية إلغاء تحرير)	استدعاء هذه الوظيفة لإعادة النشر أو إرسال البيانات إلى الخادم. تؤدي هذه الوظيفة المهام التي تقوم بتحديث البيانات والتحقق من صحة إدخال المستخدم. يمكن لهذه الوظيفة أيضًا إطلاق حدث أمر على جانب الخادم. استخدم المعلمة arg لتمرير الأمر الخاص بك. على سبيل المثال: يتم استخدام الأمر SAVE للنقر فوق ملفيحفظ الزر الموجود على شريط الأوامر لعنصر التحكم GridWeb ثم الأمر CCMD: MYCOMMAND بإطلاق حدث CustomCommand.
setActiveCell (صف int ، عمود int)	يستخدم لتنشيط خلية معينة.
setCellValue (الصف int ، العمود int ، قيمة السلسلة)	تُستخدم لوضع قيمة لأي خلية محددة باستخدام أرقام الصفوف والأعمدة الخاصة بها.
getCellValue (الصف int ، العمود int)	ترجع قيمة أي خلية محددة.
getActiveRow ()	تُستخدم مع وظيفة getActiveColumn () لتحديد موضع الخلية النشطة.
getActiveColumn ()	تُستخدم مع وظيفة getActiveRow () لتحديد موضع الخلية النشطة.
getSelectRange ()	إرجاع النطاق المحدد الأخير.
setSelectRange ()	يختار النطاق المحدد.
clearSelections ()	يمسح كل التحديد باستثناء الخلية النشطة الحالية.
getCellsArray ()	يتم استخدامه مع الوظائف الأخرى ذات الصلة مثل getCellName () و getCellValueByCell () و getCellRow () و getCellColumn (). يرجى قراءة هذه المقالة لمزيد من المعلومات حول استخدام هذه الوظيفة:اقرأ قيم خلايا GridWeb على جانب العميل
لإنشاء تطبيق اختبار يحتوي على برامج نصية من جانب العميل تعمل مع Aspose.Cells.GridWeb ، اتبع الخطوات التالية:

1. قم بإنشاء وظائف JavaScript ليتم استدعاؤها بواسطة GridWeb. ستتم إضافة هذه الوظائف إلى صفحات ASP.NET بطاقة شعار.
2. قم بتعيين أسماء الدالات إلى الخاصيتين OnSubmitClientFunction و OnValidationErrorClientFunction.

يتم عرض إخراج مثال الكود أدناه:

تمت إضافة التحقق إلى خلية C1

أضف قيمة غير صالحة وانقريحفظ. حدث خطأ في التحقق من الصحة وتم تنفيذ وظيفة ValidationErrorFunction.

تم استدعاء ValidationErrorFunction عند حدوث خطأ في التحقق من الصحة

حتى يتم إدخال قيمة صالحة ، لا يتم تقديم أي بيانات إلى الخادم. أدخل قيمة صالحة وانقريحفظ. تم تنفيذ وظيفة التأكيد.

تم استدعاء وظيفة ConfirmFunction قبل إرسال بيانات GridWeb إلى الخادم

For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// A client side JavaScript function that will be executed before submitting data to server
function ConfirmFunction(arg, cancelEdit) {
    // Showing a confirm dialog with some information where "this" refers to GridWeb
    return confirm("The control is " + this.id + "\nThe command is \"" + arg + "\".\nDo you want to continue?");
}
        
// A client side JavaScript function that will be executed whenever a validation error will occur
function ValidationErrorFunction() {
    // Showing an alert message where "this" refers to GridWeb
    alert(this.id + ": Please correct your input error.");
}

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Assigning the name of JavaScript function to OnSubmitClientFunction property of GridWeb
GridWeb1.OnSubmitClientFunction = "ConfirmFunction";

// Assigning the name of JavaScript function to OnValidationErrorClientFunction property of GridWeb
GridWeb1.OnValidationErrorClientFunction = "ValidationErrorFunction";

// Accessing the cells collection of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

// Accessing "B1" cell and add some text
GridCell cell = sheet.Cells[0, 1];
cell.PutValue("Date (yyyy-mm-dd):");

// Accessing "C1" cell and add to it custom expression validation to accept dates in yyyy-mm-dd format
cell = sheet.Cells[0, 2];
var validation = cell.CreateValidation(GridValidationType.CustomExpression, true);            
validation.RegEx = @"\d{4}-\d{2}-\d{2}";