1. مهمان گرامی، جهت ارسال پست، دانلود و سایر امکانات ویژه کاربران عضو، ثبت نام کنید.
    بستن اطلاعیه

پلاگین PageMethod برای jQuery

شروع موضوع توسط minaaa ‏6/1/12 در انجمن بخش قرنطینه

  1. کاربر پیشرفته

    تاریخ عضویت:
    ‏9/12/10
    ارسال ها:
    19,773
    تشکر شده:
    6,457
    امتیاز دستاورد:
    113
    [h=1][/h]


    در صفحات aspx این امکان وجود داره تا با اضافه کردن خصوصیت WebMethod به یک متد، اون رو درست مثل یک Web Service صدا بزنید. یعنی از سمت client و بدون یک postback کامل.
    برای اینکه قادر باشید از طریق jQuery این کار رو انجام بدید، باید از تابع jQuery.ajax استفاده کنید. همینطور باید پارامترهایی رو که میخواین به متدتون در سمت سرور بفرستید، با فرمت json به صورت serialize شده درآورده باشید.
    برای راحتی بیشتر، پلاگینی برای JQuery نوشتم که قسمت های زیادی از کار رو براتون انجام میده و شما تنها با یک خط می تونید تابع دلخواهتون رو صدا بزنید. اما روش کار:

    1. یک لینک برای فایل مربوط به هسته jQuery و یکی هم برای فایل PageMethod.js در صفحه تون بوجود میارید:
      <script src="js/jquery-1.3.2.min.js" type="text/javascript"></script> <script src="js/PageMethod.js" type="text/javascript"></script>
    2. با فرمان زیر، متدتون رو از javascript صدا میزنید:

    <script type="text/javascript" language="javascript"> function getData() { $.PageMethod('ReturnCustomData', onSuccess, onFail, 'CustomName', myName, 'CustomID', myID); } در اینجا، myName و myID اسم دو پارامتر تعریف شده در WebMethod مربوطه و ‘CustomName’ و ‘CustomID’ مقادیر پاس شده هستند. شما می تونید هر چند پارامتری رو که میخواید تعریف کنید و در بدنه تابع صدا بزنید مثلا:

    $.PageMethod('ReturnCustomData', onSuccess, onFail, 'MyName', myName, 'MyID', myID, 'CustomThirdParam', customThirdParam); اگر عملیات با موفقیت انجام بشه، تابع OnSuccess که خودتون تعریف کردید صدا زده میشه در غیر این صورت، تابع onFail که باز شما تعریف کردید صدا زده میشه. شما میتونید در تابع onSuccess، اقدام مناسب رو در قبال اطلاعاتی که از سمت سرور دریافت کردید انجام بدید. به عنوان مثال در پروژه الصاقی به ابن مقاله، من دو تابع زیر رو تعریف کردم:

    function onSuccess(response) { var ltr = document.getElementById('<%=lblResult.ClientID %>'); ltr.innerHTML = 'Your Name: ' + response.d.Name + ', Your ID: ' + response.d.ID; } function onFail(response) { alert("An error occurred."); } اول باید قوانین کلی زیر رو در مورد WebMethodها بدونید. این قوانین ربطی به این پلاگین ندارن ولی اگر میخواید از WebMethodها استفاده کنید، باید مراقب باشید که:

    1. متد شما در سمت سرور حتما باید به صورت static تعریف شده باشه.
    2. متد شما حتما باید در صفحه aspx تعریف شده باشه. امکان اضافه کردن خصوصیت WebMethod به متدهایی که در صفحات ascx (همون User Control) تعریف شدند وجود نداره.
    قصد ندارم در اینجا در مورد دلایل این محدودیتها صحبت کنم. اما اگر مایل بودید مقاله جدایی در موردش می نویسم.
    اما روش کار:
    اول نام صفحه رو در پیدا می کنیم. اگر نام صفحه در آدرس نبود، از نام default.aspx استفاده می کنیم:

    var pagePath = window.location.pathname; if ( pagePath.lastIndexOf('/') == pagePath.length-1 ) { pagePath = pagePath + "default.aspx"; } در مرحله بعد، پارامترها رو با فرمت json به صورت Serialized در میاریم:

    var jsonParams = ''; var paramLength = arguments.length; if (paramLength > 3) { for (var i = 3; i < paramLength - 1; i += 2) { if (jsonParams.length != 0) jsonParams += ','; jsonParams += '"' + arguments + '":"' + arguments[i + 1] + '"'; } } jsonParams = '{' + jsonParams + '}'; در نهایت با استفاده از تابع jQuery.ajax، متد سمت سرور رو صدا می کنیم:

    $.ajax({ type: "POST", url: pagePath + "/" + fn, contentType: "application/json; charset=utf-8", data: jsonParams, dataType: "json", success: successFn, error: errorFn });