This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

ClientScriptManager الفئة

Visual Studio 2010

يعرف وظائف لإدارة برامج نصية للعميل في تطبيقات ويب.

مساحة الاسم:  System.Web.UI
التجميع:  System.Web (في System.Web.dll)

public sealed class ClientScriptManager

ClientScriptManager الفئة هو المستخدمة لإدارة برامج نصية للعميل وإضافتها إلى تطبيقات ويب. يمكنك يحصل مرجع إلى ClientScriptManagerفئة من ClientScriptخاصية Pageالكائن.

يمكنك إضافة برنامج نصي عميل إلى صفحة ويب الصفحة شكل إلزامي بما في ذلك البرنامج النصي في علامات HTML الصفحة. ولكن، هناك حالات عند إضافة البرنامج النصي للعميل بشكل حيوي هو المطلوبة. لإضافة برنامج نصي بشكل حيوي، استخدم RegisterClientScriptBlockالأسلوب، RegisterClientScriptIncludeالأسلوب، RegisterStartupScriptالأسلوب، أو RegisterOnSubmitStatementالأسلوب، استناداً إلى متى و كيف تريد إضافة script. لمزيد من المعلومات، راجع كيفية: إضافة برنامج نصي عميل بشكل حيوي إلى صفحات ASP.NET على ويب.

ClientScriptManager فئة برامج نصية بواسطة المفتاح تعرف بشكل فريد Stringو Type. برامج نصية باستخدام نفس المفتاح و تعتبر نوع التكرار. يساعد استخدام نوع برنامج نصي إلى تجنب اضطراب برامج نصية مشابهة من عناصر تحكم مستخدم آخر قد لا تكون قيد استخدم في الصفحة.

ClientScriptManager الفئة التي يمكن استخدامها لاستدعاء رد الاتصال العميل في الحالات عند ذلك هو مطلوباً لتشغيل تعليمات الملقم البرمجية من العميل بدون تنفيذ إعادة النشر. Th هو هو ويشار إلى تنفيذ رد اتصال سحب بث إلى الملقم. في رد اتصال عميل، يقوم عميل برنامج نصي دالة بإرسال طلب غير متزامن إلى صفحة ويب الخاصة ب ASP.NET. صفحة ويب بتشغيل الإصدار معدل من دورة حياة عادية إلى عملية رد الاتصال. استخدام GetCallbackEventReferenceطريقة للحصول على مرجع إلى وظيفة عميل، عند استدعاء، يبدأ رد اتصال عميل "إلى ملقم حدث. لمزيد من المعلومات، راجع تنفيذ عمليات الاسترجاعات عميل برمجياً بدون Postbacks في صفحات ASP.NET على ويب.

ملاحظةملاحظة

لن يعمل برنامج نصي لعمليات الاستدعاء في المستعرضات الأقدم التي لا تعتمد طراز كائن مستند (DOM)، والتي تتطلب ECMAScript هو ممكن تشغيل كمبيوتر العميل. للتحقق ما إذا كان مستعرض يدعم رد الاتصال، استخدم SupportsCallbackالخاصية، التي هو الوصول إليها من خلال Browserخاصية ASP.NET مضمنة Requestالكائن.

استخدام GetPostBackEventReferenceالأسلوب و GetPostBackClientHyperlinkأسلوب إلى تعريف العميل إعادة النشر حدث. تمكين هذه الطرق النص البرمجي للكمبيوتر العميل يعمل عند استدعاء تسبب الملقم لنشر العودة إلى الصفحة. حدث إعادة النشر عميل هو يختلف رد اتصال عميل في ذلك صفحة ويب اكتمال دورة الحياة عادية لمعالجة أحداث إعادة النشر للعميل.

ملاحظةملاحظة

إذا كنت تستخدم Buttonعنصر تحكم و UseSubmitBehaviorتعيين خاصية إلى false، ثم يمكنك استخدام GetPostBackEventReferenceالأسلوب لإرجاع العميل إعادة النشر حدث Buttonعنصر تحكم.

OnClientClick خاصية Buttonعنصر التحكم، ImageButtonعنصر التحكم، و LinkButtonإمكانية استخدام عنصر التحكم بتشغيل عميل برنامج نصي.

ما يلي تعليمات برمجية يوضح المثال استخدم RegisterClientScriptBlockطريقة ClientScriptManagerفئة. الثاني العميل معرفة برامج نصية في الصفحة: PopupScript، dهوplays أي رسالة تنبيه عند الصفحة هو التم تحميله، وButtonClickScript، الذي يعرف معالج عميل لزر HTMLonClickحدث.


<%@ Page Language="C#"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  public void Page_Load(Object sender, EventArgs e)
  {
    // Define the name and type of the client scripts on the page.
    String csname1 = "PopupScript";
    String csname2 = "ButtonClickScript";
    Type cstype = this.GetType();

    // Get a ClientScriptManager reference from the Page class.
    ClientScriptManager cs = Page.ClientScript;

    // Check to see if the startup script is already registered.
    if (!cs.IsStartupScriptRegistered(cstype, csname1))
    {
      String cstext1 = "alert('Hello World');";
      cs.RegisterStartupScript(cstype, csname1, cstext1, true);
    }

    // Check to see if the client script is already registered.
    if (!cs.IsClientScriptBlockRegistered(cstype, csname2))
    {
      StringBuilder cstext2 = new StringBuilder();
      cstext2.Append("<script type=\"text/javascript\"> function DoClick() {");
      cstext2.Append("Form1.Message.value='Text from client script.'} </");
      cstext2.Append("script>");
      cs.RegisterClientScriptBlock(cstype, csname2, cstext2.ToString(), false);
    }
  }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form id="Form1"
         runat="server">
        <input type="text" id="Message" /> <input type="button" value="ClickMe" onclick="DoClick()" />
     </form>
  </body>
</html>


System.Object
  System.Web.UI.ClientScriptManager

يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في Visual Basic) من هذا النوع. لن يتم ضمان تأمين العملية الجزئية لأي عضو مثيل.

نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0
إظهار: