UpdatePanel.UpdateMode 属性

参考

定义

命名空间:: System.Web.UI

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

重要

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

获取或设置一个值，该值指示何时更新 UpdatePanel 控件的内容。

public:
 property System::Web::UI::UpdatePanelUpdateMode UpdateMode { System::Web::UI::UpdatePanelUpdateMode get(); void set(System::Web::UI::UpdatePanelUpdateMode value); };

public System.Web.UI.UpdatePanelUpdateMode UpdateMode { get; set; }

member this.UpdateMode : System.Web.UI.UpdatePanelUpdateMode with get, set

Public Property UpdateMode As UpdatePanelUpdateMode

属性值

UpdatePanelUpdateMode

UpdatePanelUpdateMode 值之一。默认值为 Always。

例外

ArgumentOutOfRangeException

指定的类型不是 UpdatePanelUpdateMode 值之一。

示例

以下示例声明两 UpdatePanel 个控件。在第一个面板中， UpdateMode 属性设置为 Conditional。第二个面板中， UpdateMode 设置为 Always。两个面板外部的按钮通过调用 RegisterAsyncPostBackControl 控件的方法 ScriptManager 注册为异步回发控件。在按钮的 Click 事件处理程序中 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>

注解

当控件不在另一个UpdatePanel UpdatePanel控件内时，面板会根据和 ChildrenAsTriggers 属性的设置UpdateMode以及触发器的集合进行更新。当控件位于另一个UpdatePanel UpdatePanel控件中时，子面板会在更新父面板时自动更新。

控件的内容 UpdatePanel 在以下情况下会更新：

UpdateMode如果属性设置为 Always，则UpdatePanel控件的内容将在来自页面上的任意位置的每次回发时更新。这包括从其他 UpdatePanel 控件中的控件进行异步回发，以及从不在控件内的控件回 UpdatePanel 发。
如果控件 UpdatePanel 嵌套在另一个 UpdatePanel 控件中，并且更新父更新面板。
如果属性 UpdateMode 设置为 Conditional，则会发生以下情况之一：
- 显式调用 Update 控件的 UpdatePanel 方法。
- 回发是由使用 Triggers 控件的属性定义为触发器的 UpdatePanel 控件引起的。在此方案中，控件会显式触发面板内容的更新。控件可以位于定义触发器的 UpdatePanel 控件内部或外部。
- 属性 ChildrenAsTriggers 设置为 true ，控件的 UpdatePanel 子控件会导致回发。嵌套控件的 UpdatePanel 子控件不会导致外部 UpdatePanel 控件的更新，除非它被显式定义为触发器。

适用于

UpdatePanel.UpdateMode 属性

定义

属性值

例外

示例

注解

适用于

另请参阅

反馈

其他资源