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.

ScriptManager.RegisterAsyncPostBackControl أسلوب

Visual Studio 2010

تسجيل عنصر تحكم كمشغل ل غير متزامن postbacks.

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

public void RegisterAsyncPostBackControl(
	Control control
)

المعلمات

control
النوع: System.Web.UI.Control
التحكم التسجيل في غير متزامن postbacks.

استثناء:شرط
ArgumentNullException

control هو null.

ArgumentException

يتم مسجَّل الصفحة غير متزامن إعادة النشر عنصر التحكم.

ArgumentException

المسجلة عنصر تحكم لا تطبق INamingContainer، IPostBackDataHandler، أو IPostBackEventHandlerالواجهات.

RegisterAsyncPostBackControl الأسلوب من إلى تسجيل عناصر تحكم الخادم ويب مشغلات وبالتالي القيام إعادة النشر غير متزامن بدلاً من إعادة النشر المتزامن. عند ChildrenAsTriggersخاصية UpdatePanelيتم تعيين عنصر التحكم إلى true(which هو the الافتراضي)، عناصر تحكم إعادة النشر داخل UpdatePanelيتم مسجَّل عنصر التحكم تلقائياً ك غير متزامن إعادة النشر عناصر التحكم.

استخدام RegisterAsyncPostBackControlأسلوب تسجيل عنصر تحكم s خارج UpdatePanelعنصر تحكم كما يقوم بتشغيل postbacks غير متزامنة، ومن المحتمل أن يكون تحديث محتوى على لوحة التحديث. إلى تحديث UpdatePanelعنصر تحكم برمجياً، قم باستدعاء Updateالأسلوب.

يمكنك إضافة يشغّل بشكل إلزامي باستخدام Triggersعنصر UpdatePanelعنصر تحكم. في Visual Studio 2010، المصمم باستخدام محرر مجموعة UpdatePanelTrigger صندوق الحوار.

يظهر المثال التالي كيفية استدعاء RegisterAsyncPostBackControlأسلوب تسجيل Buttonعنصر تحكم حيث يؤدي تحديث من UpdatePanelعنصر تحكم للمحتوى. Button عنصر التحكم غير الداخلية UpdatePanelعنصر التحكم. يتم إظهار زرين: Button1 وButton2 Button1 refreshes the محتوى of the لوحة, و Button2 refreshes the الصفحة بأكملها.


<%@ 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">

    protected void Page_Load(object sender, EventArgs e)
    {
        ScriptManager1.RegisterAsyncPostBackControl(Button1);
    }

    protected void Button1_Click(object sender, EventArgs e)
    {
        Label1.Text = "Panel refreshed at " + DateTime.Now.ToString();
    }
    protected void Button2_Click(object sender, EventArgs e)
    {
        Label1.Text = "Page refreshed.";
    }
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>ScriptManager RegisterAsyncPostBackControl Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <div>
        <asp:ScriptManager ID="ScriptManager1" runat="server"/>
        <asp:UpdatePanel ID="UpdatePanel1" runat="server">
        <ContentTemplate>
        <fieldset>
        <legend>Update Panel</legend>
        <asp:Label ID="Label1" runat="server">Initial postback occurred.</asp:Label>
        </fieldset>
        </ContentTemplate>
        </asp:UpdatePanel>
        <asp:Button ID="Button1" runat="server" Text="Update Panel" OnClick="Button1_Click" />
        <asp:Button ID="Button2" runat="server" Text="Refresh Page" OnClick="Button2_Click" />
        </div>
    </form>
</body>
</html>


The following مثال shows how إلى يتصل the RegisterAsyncPostBackControl أسلوب إلى register a مستخدم عنصر تحكم so that it causes an تحديث of an UpdatePanel عنصر تحكم's محتوى. يظهر المثال أول الصفحة استخدام عنصر تحكم مستخدم. يظهر المثال الثاني مستخدم عنصر تحكم.



<%@ Page Language="C#" %>

<%@ Register Src="Controls/WebUserControl.ascx" TagName="WebUserControl"
	TagPrefix="uc1" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    protected void Page_Load(object sender, EventArgs e)
    {
        ScriptManager1.RegisterAsyncPostBackControl(WebUserControl1);
    }

    protected void Button1_Click(object sender, EventArgs e)
    {
        Label1.Text = "Panel refreshed at " + DateTime.Now.ToString();
    }

    protected void WebUserControl1_Click(object sender, EventArgs e)
    {
        Label1.Text = "Panel refreshed at " + DateTime.Now.ToString() +
            ".  Welcome " + WebUserControl1.Name + ". ";
    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>ScriptManager RegisterAsyncPostBackControl Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1" runat="server" />
            <asp:UpdatePanel ID="UpdatePanel1" runat="server">
                <ContentTemplate>
                    <fieldset>
                        <legend>Update Panel</legend>
                        <asp:Label ID="Label1" runat="server">Initial postback occurred.</asp:Label>
                    </fieldset>
                </ContentTemplate>
            </asp:UpdatePanel>
            <asp:Button ID="Button1" runat="server" Text="Update Panel" OnClick="Button1_Click" />
            <uc1:webusercontrol id="WebUserControl1" runat="server" oninnerclick="WebUserControl1_Click" />
        </div>
    </form>
</body>
</html>



<%@ Control Language="C#" ClassName="WebUserControl" %>

<script runat="server">
    public event EventHandler InnerClick
    {
        add
        {
            UCButton1.Click += value;
        }
        remove
        {
            UCButton1.Click -= value;
        }
    }
    public String Name
    {
        get
        {
            return UCTextBox1.Text;
        }
    }
</script>

<asp:Panel ID="UCPanel1" runat="server" GroupingText="User Control">
    Enter your name:
    <asp:TextBox ID="UCTextBox1" runat="server"></asp:TextBox>
    <br />
    <asp:Button ID="UCButton1" runat="server" Text="Submit" />
</asp:Panel>


نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008, نظام التشغيل Windows Server 2003

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

.NET Framework

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