UpdatePanelUpdateMode 枚举

参考

定义

命名空间:: System.Web.UI

程序集:: System.Web.Extensions.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

表示 UpdatePanel 控件中内容可能的更新模式。

public enum class UpdatePanelUpdateMode

public enum UpdatePanelUpdateMode

type UpdatePanelUpdateMode =

Public Enum UpdatePanelUpdateMode

继承: Object

ValueType

Enum
UpdatePanelUpdateMode

字段

Always	0	对于源于页面的所有回发，UpdatePanel 控件的内容都会进行更新。其中也包括异步回发。
Conditional	1	指定了更新 UpdatePanel 控件内容的若干条件；有关信息信息，请参阅“备注”部分。

示例

以下示例声明两个 UpdatePanel 控件。第一个面板将 UpdatePanel.UpdateMode 属性设置为 Conditional。 The second panel has UpdatePanel.UpdateMode set to Always by default. 这两个面板外的按钮使用 ScriptManager.RegisterAsyncPostBackControl 该方法注册为异步回发控件。在按钮的单击事件处理程序中， UpdatePanel.Update 如果自上次更新以来超过 5 秒，将调用第一个面板的方法。在此方案中，仅当上次面板更新超过五秒时，面板的内容才会更新。第二个面板的内容始终更新。


<%@ 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 DateTime LastUpdate
    {
        get
        {
            return (DateTime)(ViewState["LastUpdate"] ?? DateTime.Now);
        }
        set
        {
            ViewState["LastUpdate"] = value;
        }
    }

    protected void Button1_Click(object sender, EventArgs e)
    {
        if (LastUpdate.AddSeconds(5.0) < DateTime.Now)
        {
            UpdatePanel1.Update();
            LastUpdate = DateTime.Now;
        }
    }

    protected void Page_Load(object sender, EventArgs e)
    {

        ScriptManager1.RegisterAsyncPostBackControl(Button1);   
        if (!IsPostBack)
        {
            LastUpdate = DateTime.Now;
        }
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>UpdatePanelUpdateMode Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1"
                               runat="server" />
            <asp:Panel ID="Panel1"
                       GroupingText="UpdatePanel1"
                       runat="server">
                <asp:UpdatePanel ID="UpdatePanel1"
                                 UpdateMode="Conditional"
                                 runat="server">
                    <ContentTemplate>
                        <p>
                            The content in this UpdatePanel only refreshes if five or more
                            seconds have passed since the last refresh and the button in
                            UpdatePanel2 was clicked. The time is checked
                            server-side and the UpdatePanel.Update() method is called. Last
                            updated: <strong>
                                <%= LastUpdate.ToString() %>
                            </strong>
                        </p>
                    </ContentTemplate>
                </asp:UpdatePanel>
            </asp:Panel>
            <asp:Panel ID="Panel2"
                       GroupingText="UpdatePanel2"
                       runat="server">
                <asp:UpdatePanel ID="UpdatePanel2"
                                 runat="server">
                    <ContentTemplate>
                        <p>
                            This UpdatePanel always refreshes if the button is clicked.
                            Last updated: <strong>
                                <%= DateTime.Now.ToString() %>
                            </strong>
                        </p>
                    </ContentTemplate>
                </asp:UpdatePanel>
            </asp:Panel>
            <asp:Button ID="Button1" Text="Button1" runat="server" OnClick="Button1_Click" />
        </div>
    </form>
</body>
</html>


<%@ Page Language="VB" %>

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

<script runat="server">
    Protected Property LastUpdate() As DateTime
        Get
            If ViewState("LastUpdate") IsNot Nothing Then
                Return ViewState("LastUpdate")
            Else : Return DateTime.Now()
            End If
        End Get
        Set(ByVal Value As DateTime)
            ViewState("LastUpdate") = Value
        End Set
    End Property

    Protected Sub Button1_Click(ByVal Sender As Object, ByVal E As EventArgs)
        If (LastUpdate.AddSeconds(5.0) < DateTime.Now) Then
            UpdatePanel1.Update()
            LastUpdate = DateTime.Now
        End If
    End Sub

    Protected Sub Page_Load(ByVal Sender As Object, ByVal E As EventArgs)
        ScriptManager1.RegisterAsyncPostBackControl(Button1)
        If Not IsPostBack Then
            LastUpdate = DateTime.Now
        End If
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>UpdatePanelUpdateMode Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1"
                               runat="server" />
            <asp:Panel ID="Panel1"
                       GroupingText="UpdatePanel1"
                       runat="server">
                <asp:UpdatePanel ID="UpdatePanel1"
                                   runat="server"
                                   UpdateMode="Conditional">
                    <ContentTemplate>
                        <p>
                            The content in this UpdatePanel only refreshes if five or more
                            seconds have passed since the last refresh and the button in
                            UpdatePanel2 was clicked. The time is checked
                            server-side and the UpdatePanel.Update() method is called. Last
                            updated: <strong>
                                <%= LastUpdate.ToString() %>
                            </strong>
                        </p>
                    </ContentTemplate>
                </asp:UpdatePanel>
            </asp:Panel>
            <asp:Panel ID="Panel2"
                       GroupingText="UpdatePanel2"
                       runat="server">
                <asp:UpdatePanel ID="UpdatePanel2"
                                 runat="server">
                    <ContentTemplate>
                        <p>
                            This UpdatePanel always refreshes if the button is clicked.
                            Last updated: <strong>
                                <%= DateTime.Now.ToString() %>
                            </strong>
                        </p>
                    </ContentTemplate>
                </asp:UpdatePanel>
            </asp:Panel>
            <asp:Button ID="Button1" Text="Button1" runat="server" OnClick="Button1_Click" />
        </div>
    </form>
</body>
</html>

注解

该 UpdatePanelUpdateMode 枚举由 UpdatePanel.UpdateMode 属性使用，并定义控件内容的 UpdatePanel 可能更新模式。该 UpdatePanel 控件要求 ScriptManager.EnablePartialRendering 该属性用于 true 进行分页呈现。

属性的 UpdatePanel.UpdateMode 默认值为 Always.

UpdatePanel如果控件位于另一个UpdatePanel控件中，并且父面板已更新，则无论属性值如何UpdateMode，嵌套面板也将更新。

该值 Conditional 在以下条件下更新控件的内容 UpdatePanel ：

该方法 UpdatePanel.Update 是显式调用的。
控件使用属性定义为触发器 UpdatePanel.Triggers ，并导致回发。在此方案中，控件是用于更新面板内容的显式触发器。触发器控件可以位于定义触发器的控件内部或外部 UpdatePanel 。
该 UpdatePanel.ChildrenAsTriggers 属性设置为 true 该属性，并且控件的 UpdatePanel 子控件会导致回发。在此方案中，控件的子控件是用于更新面板的 UpdatePanel 隐式触发器。嵌套 UpdatePanel 控件的子控件不会导致外部 UpdatePanel 控件更新，除非显式定义为触发器。

适用于

UpdatePanelUpdateMode 枚举

定义

字段

示例

注解

适用于

另请参阅

其他资源