UpdatePanel.UpdateMode 属性
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，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, setPublic Property UpdateMode As UpdatePanelUpdateMode属性值
UpdatePanelUpdateMode 值之一。 默认值为 Always。
例外
指定的类型不是 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>
注解
当控件不在另一个UpdatePanelUpdatePanel控件内时，面板会根据 和 ChildrenAsTriggers 属性的设置UpdateMode以及触发器的集合进行更新。 当控件位于另一个UpdatePanelUpdatePanel控件中时，子面板会在更新父面板时自动更新。
控件的内容 UpdatePanel 在以下情况下会更新：
UpdateMode如果 属性设置为 Always，则UpdatePanel控件的内容将在来自页面上的任意位置的每次回发时更新。 这包括从其他 UpdatePanel 控件中的控件进行异步回发，以及从不在控件内的控件回 UpdatePanel 发。
如果控件 UpdatePanel 嵌套在另一个 UpdatePanel 控件中，并且更新父更新面板。
如果 属性 UpdateMode 设置为 Conditional，则会发生以下情况之一：
显式调用 Update 控件的 UpdatePanel 方法。
回发是由使用 Triggers 控件的 属性定义为触发器的 UpdatePanel 控件引起的。 在此方案中，控件会显式触发面板内容的更新。 控件可以位于定义触发器的 UpdatePanel 控件内部或外部。
属性 ChildrenAsTriggers 设置为
true，控件的 UpdatePanel 子控件会导致回发。 嵌套控件的 UpdatePanel 子控件不会导致外部 UpdatePanel 控件的更新，除非它被显式定义为触发器。
