Esporta (0) Stampa
Espandi tutto

Metodo UpdatePanel.Update

Aggiornamento: novembre 2007

Determina un aggiornamento del contenuto di un controllo UpdatePanel.

Spazio dei nomi:  System.Web.UI
Assembly:  System.Web.Extensions (in System.Web.Extensions.dll)

public void Update()
public void Update()
public function Update()

EccezioneCondizione
InvalidOperationException

La proprietà UpdateMode è impostata su Always.

- oppure -

Il metodo Update viene chiamato durante o dopo l'evento Render della pagina.

Se la pagina è attivata per il rendering a pagina parziale, quando si richiama il metodo Update, il contenuto del controllo UpdatePanel viene aggiornato nel browser. Chiamare il metodo Update se si dispone di codice server da eseguire per determinare se un controllo UpdatePanel deve essere aggiornato. Se si intende utilizzare il metodo Update, impostare la proprietà UpdateMode su Conditional. Se si desidera che la decisione di aggiornare il pannello sia determinata nella logica del server, assicurarsi che la proprietà ChildrenAsTriggers sia false e che non siano definiti trigger espliciti per il pannello.

In uno scenario tipico di sviluppo delle pagine, se si definiscono trigger o se la proprietà ChildrenAsTriggers è true per il controllo UpdatePanel, il metodo Update viene chiamato automaticamente durante il ciclo di vita della pagina.

Se la proprietà ContentTemplate non è definita per il controllo UpdatePanel, non si verificheranno aggiornamenti del pannello.

Nell'esempio riportato di seguito viene utilizzato il metodo Update per aggiornare il contenuto di un controllo UpdatePanel quando sono trascorsi più di cinque secondi dall'ultimo aggiornamento.


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


Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

.NET Framework

Supportato in: 3.5

Aggiunte alla community

AGGIUNGI
Microsoft sta conducendo un sondaggio in linea per comprendere l'opinione degli utenti in merito al sito Web di MSDN. Se si sceglie di partecipare, quando si lascia il sito Web di MSDN verrà visualizzato il sondaggio in linea.

Si desidera partecipare?
Mostra:
© 2014 Microsoft