Compartilhar via


UpdatePanelUpdateMode Enumeração

Definição

Representa os modos de atualização possíveis para o conteúdo em um controle UpdatePanel.

public enum class UpdatePanelUpdateMode
public enum UpdatePanelUpdateMode
type UpdatePanelUpdateMode = 
Public Enum UpdatePanelUpdateMode
Herança
UpdatePanelUpdateMode

Campos

Always 0

O conteúdo do controle UpdatePanel é atualizado para todos os postbacks que se originam da página. Isso inclui os postbacks assíncronos.

Conditional 1

Especifica um número de condições em que o conteúdo do controle UpdatePanel será atualizado. Confira a seção Comentários para obter mais informações.

Exemplos

O exemplo a seguir declara dois UpdatePanel controles. O primeiro painel define a UpdatePanel.UpdateMode propriedade como Conditional. O segundo painel foi UpdatePanel.UpdateMode definido como Always por padrão. Um botão fora de ambos os painéis é registrado como um controle de postback assíncrono usando o ScriptManager.RegisterAsyncPostBackControl método. No manipulador de eventos de clique do botão, o UpdatePanel.Update método do primeiro painel será chamado se mais de cinco segundos tiverem decorrido desde a última atualização. Nesse cenário, o conteúdo do painel será atualizado somente se a última atualização do painel tiver sido há mais de cinco segundos. O conteúdo do segundo painel é sempre atualizado.


<%@ 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>

Comentários

A UpdatePanelUpdateMode enumeração é usada pela UpdatePanel.UpdateMode propriedade e define os modos de atualização possíveis para o conteúdo de um UpdatePanel controle. O UpdatePanel controle requer que a ScriptManager.EnablePartialRendering propriedade seja true para que a renderização de página parcial ocorra.

O valor padrão da UpdatePanel.UpdateMode propriedade é Always.

Se o UpdatePanel controle estiver dentro de outro UpdatePanel controle e o painel pai for atualizado, o painel aninhado também será atualizado independentemente do valor da UpdateMode propriedade.

O Conditional valor atualiza o conteúdo do UpdatePanel controle nas seguintes condições:

  • O UpdatePanel.Update método é chamado explicitamente.

  • Um controle é definido como um gatilho usando a UpdatePanel.Triggers propriedade e causa um postback. Nesse cenário, o controle é um gatilho explícito para atualizar o conteúdo do painel. O controle de gatilho pode estar dentro ou fora do UpdatePanel controle que define o gatilho.

  • A UpdatePanel.ChildrenAsTriggers propriedade é definida como true e um controle filho do UpdatePanel controle causa um postback. Nesse cenário, os controles filho do UpdatePanel controle são gatilhos implícitos para atualizar o painel. Controles filho de controles aninhados UpdatePanel não fazem com que o controle externo UpdatePanel seja atualizado, a menos que sejam explicitamente definidos como gatilhos.

Aplica-se a

Confira também