UpdatePanelUpdateMode UpdatePanelUpdateMode UpdatePanelUpdateMode UpdatePanelUpdateMode Enum

Definition

Stellt den möglichen Aktualisierungsmodus in einem UpdatePanel-Steuerelement dar.Represents the possible update modes for the content in an UpdatePanel control.

public enum class UpdatePanelUpdateMode
public enum UpdatePanelUpdateMode
type UpdatePanelUpdateMode = 
Public Enum UpdatePanelUpdateMode
Vererbung
UpdatePanelUpdateModeUpdatePanelUpdateModeUpdatePanelUpdateModeUpdatePanelUpdateMode

Felder

Always Always Always Always 0

Der Inhalt des UpdatePanel-Steuerelements wird für alle Postbacks aktualisiert, die aus der Seite stammen.The content of the UpdatePanel control is updated for all postbacks that originate from the page. Dazu gehören asynchrone Postbacks.This includes asynchronous postbacks.

Conditional Conditional Conditional Conditional 1

Gibt eine Reihe von Bedingungen an, unter denen der Inhalt des UpdatePanel-Steuerelements aktualisiert wird; weitere Informationen finden Sie im Abschnitt „Hinweis“.Specifies a number of conditions under which the content of the UpdatePanel control is updated; see the Remarks section for more information.

Beispiele

Das folgende Beispiel deklariert zwei UpdateMode Steuerelemente.The following example declares two UpdateMode controls. Im ersten Bereich wird die UpdateMode Eigenschaft eine UpdateMode Steuerelement hodnotu Conditional.The first panel sets the UpdateMode property of an UpdateMode control to Conditional. Im zweiten Bereich wird UpdateMode immer standardmäßig festgelegt.The second panel has UpdateMode set to Always by default. Eine Schaltfläche außerhalb beider Bereiche wird als Steuerelement für asynchrone Postbacks registriert, mit der RegisterAsyncPostBackControl Methode der ScriptManager Steuerelement.A button outside both panels is registered as an asynchronous postback control by using the RegisterAsyncPostBackControl method of the ScriptManager control. Klicken Sie in der Schaltfläche auf-Ereignishandler der Update Methode des ersten Bereichs wird immer dann aufgerufen, wenn mehr als fünf Sekunden seit der letzten Aktualisierung vergangen sind.In the button's click event handler, the Update method of the first panel is called if more than five seconds have elapsed since its last update. In diesem Szenario wird der Inhalt des Bereichs nur aktualisiert, wenn das letzte Update für den Bereich vor mehr als fünf Sekunden wurde.In this scenario, the panel's content is updated only if the last panel update was more than five seconds ago. Der Inhalt des zweiten Bereichs wird immer aktualisiert.The second panel's content is always updated.


<%@ 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 Not ViewState("LastUpdate") Is 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>

Hinweise

Die UpdatePanelUpdateMode Enumeration wird verwendet, indem die UpdatePanel.UpdateMode Eigenschaft und den möglichen Aktualisierungsmodus für den Inhalt des definiert ein UpdatePanel Steuerelement.The UpdatePanelUpdateMode enumeration is used by the UpdatePanel.UpdateMode property and defines the possible update modes for the content of an UpdatePanel control. Die UpdatePanel Steuerelement erfordert, dass die ScriptManager.EnablePartialRendering Eigenschaft true Partial-Page Rendering auftreten.The UpdatePanel control requires that the ScriptManager.EnablePartialRendering property be true for partial-page rendering to occur.

Der Standardwert der UpdatePanel.UpdateMode Eigenschaft Always.The default value of the UpdatePanel.UpdateMode property is Always.

Wenn die UpdatePanel Steuerelement ist in einem anderen UpdatePanel -Steuerelement und dem übergeordneten Bereich aktualisiert wird, das geschachtelte Panel wird auch aktualisiert werden, unabhängig von der UpdateMode -Eigenschaftswert.If the UpdatePanel control is inside another UpdatePanel control and the parent panel is updated, the nested panel will also be updated regardless of the UpdateMode property value.

Die Conditional Wert aktualisiert den Inhalt der UpdatePanel Steuerelement unter den folgenden Bedingungen:The Conditional value updates the content of the UpdatePanel control under the following conditions:

  • Die UpdatePanel.Update Methode explizit aufgerufen wird.The UpdatePanel.Update method is called explicitly.

  • Ein Steuerelement als ein Trigger definiert ist, mithilfe der UpdatePanel.Triggers Eigenschaft und bewirkt, dass einen Postback.A control is defined as a trigger by using the UpdatePanel.Triggers property and causes a postback. In diesem Szenario ist das Steuerelement ein expliziter Trigger für die Aktualisierung des Inhalts des Bereichs.In this scenario, the control is an explicit trigger for updating the panel content. Das Trigger-Steuerelement kann sein, entweder innerhalb oder außerhalb der UpdatePanel -Steuerelement, das den Trigger definiert.The trigger control can be either inside or outside the UpdatePanel control that defines the trigger.

  • Die UpdatePanel.ChildrenAsTriggers -Eigenschaftensatz auf true und ein untergeordnetes Steuerelement von der UpdatePanel Steuerelement ein Postback auslöst.The UpdatePanel.ChildrenAsTriggers property is set to true and a child control of the UpdatePanel control causes a postback. In diesem Szenario der untergeordneten Steuerelemente von der UpdatePanel sind implizite Trigger für die Aktualisierung des Bereichs.In this scenario, child controls of the UpdatePanel control are implicit triggers for updating the panel. Untergeordnete Steuerelemente von geschachtelten UpdatePanel Steuerelemente führen nicht dazu, dass die äußere UpdatePanel Steuerelement aktualisiert werden, es sei denn, sie sind explizit als Trigger definiert.Child controls of nested UpdatePanel controls do not cause the outer UpdatePanel control to be updated unless they are explicitly defined as triggers.

Gilt für:

Siehe auch