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 値のいずれか 1 つ。 既定値は、Always です。
例外
指定した型が、UpdatePanelUpdateMode 値ではありません。
例
次の例では、2 つの UpdatePanel コントロールを宣言します。 最初のパネルでは、 UpdateMode プロパティが に Conditional設定されています。 2 番目のパネルでは、 UpdateMode が に Always設定されています。 両方のパネルの外側にあるボタンは、 コントロールの ScriptManager メソッドを呼び出RegisterAsyncPostBackControlすことによって非同期ポストバック コントロールとして登録されます。 ボタンの Click イベント ハンドラーでは、 Update 前回の更新から 5 秒以上経過した場合、最初のパネルの メソッドが呼び出されます。 このシナリオでは、パネルの内容は、最後のパネルの更新が 5 秒以上前の場合にのみ更新されます。 2 番目のパネルの内容は常に更新されます。
<%@ 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 にAlwaysUpdatePanel設定されている場合、ページ上の任意の場所から発生するすべてのポストバックで、コントロールのコンテンツが更新されます。 これには、他 UpdatePanel のコントロール内のコントロールからの非同期ポストバックと、コントロール内 UpdatePanel にないコントロールからのポストバックが含まれます。
コントロールが別UpdatePanelのUpdatePanelコントロール内に入れ子になっていて、親の更新パネルが更新された場合。
プロパティが UpdateMode に Conditional設定されている場合、次のいずれかの条件が発生します。
コントロールの メソッドを Update 明示的に UpdatePanel 呼び出します。
ポストバックは、コントロールの プロパティを使用 Triggers してトリガーとして定義されたコントロールによって発生します UpdatePanel 。 このシナリオでは、コントロールによってパネル コンテンツの更新が明示的にトリガーされます。 コントロールは、トリガーを定義するコントロールの UpdatePanel 内側または外側に配置できます。
ChildrenAsTriggersプロパティが に
true設定され、コントロールの子コントロールによってUpdatePanelポストバックが発生します。 入れ子になった UpdatePanel コントロールの子コントロールは、トリガーとして明示的に定義されていない限り、外部 UpdatePanel コントロールを更新しません。
適用対象
こちらもご覧ください
.NET