Freigeben über


Exemplarische Vorgehensweise: Einführung in das Timer-Steuerelement

Aktualisiert: November 2007

In dieser exemplarischen Vorgehensweise aktualisieren Sie einen Teil einer Webseite in einem bestimmten zeitlichen Intervall mithilfe von drei ASP.NET-AJAX-Serversteuerelementen: dem ScriptManager-Steuerelement, dem UpdatePanel-Steuerelement und dem Timer-Steuerelement. Wenn Sie diese Steuerelemente einer Seite hinzufügen, ist es nicht erforderlich, bei jedem Postback die gesamte Seite zu aktualisieren. Nur der Inhalt des UpdatePanel-Steuerelements wird aktualisiert.

Weitere Informationen zum Teilrendering von Seiten finden Sie unter Übersicht über das Teilrendering von Seiten.

Vorbereitungsmaßnahmen

Zum Implementieren der Prozeduren in dieser exemplarischen Vorgehensweise ist Folgendes erforderlich:

  • Microsoft Visual Studio 2005 oder Visual Web Developer Express Edition.

  • Eine AJAX-fähige ASP.NET-Website.

So aktualisieren Sie ein UpdatePanel-Steuerelement in regelmäßigen Abständen

  1. Erstellen Sie in Microsoft Visual Studio 2005 oder Visual Web Developer Express Edition eine neue ASP.NET-AJAX-fähige Webseite, und wechseln Sie in die Entwurfsansicht.

  2. Wenn die Seite noch kein ScriptManager-Steuerelement enthält, doppelklicken Sie in der Toolbox auf der Registerkarte AJAX-Erweiterungen auf das ScriptManager-Steuerelement, um es der Seite hinzuzufügen.

  3. Doppelklicken Sie in der Toolbox auf das UpdatePanel-Steuerelement, um es der Seite hinzuzufügen.

  4. Klicken Sie innerhalb des UpdatePanel-Steuerelements, und doppelklicken Sie danach auf das Timer-Steuerelement, um es dem UpdatePanel-Steuerelement hinzuzufügen.

    Hinweis:

    Das Timer-Steuerelement kann sowohl innerhalb als auch außerhalb eines UpdatePanel-Steuerelements als Trigger eingesetzt werden. In diesem Beispiel wird die Verwendung des Timer-Steuerelements innerhalb eines UpdatePanel-Steuerelements dargestellt. Ein Beispiel für die Verwendung eines Timer-Steuerelements als Trigger außerhalb eines UpdatePanel-Steuerelements finden Sie unter Exemplarische Vorgehensweise: Verwenden des ASP.NET-Timer-Steuerelements mit mehreren UpdatePanel-Steuerelementen.

  5. Legen Sie die Interval-Eigenschaft des Timer-Steuerelements auf 10000 fest.

    Die Interval-Eigenschaft ist in Millisekunden definiert, sodass bei einer Einstellung der Interval-Eigenschaft auf 10.000 Millisekunden das UpdatePanel-Steuerelement alle 10 Sekunden aktualisiert wird.

    Hinweis:

    In diesem Beispiel wird das Zeitgeberintervall auf 10 Sekunden festgelegt. So werden beim Ausführen des Beispiels die Ergebnisse ohne lange Wartezeit angezeigt. Jedes Zeitgeberintervall hat jedoch ein Postback zum Server zur Folge und verursacht somit Netzwerkdatenverkehr. Aus diesem Grund sollte das Intervall in einer Produktionsanwendung auf den längsten für die Anwendung geeigneten Zeitraum festgelegt werden.

  6. Klicken Sie innerhalb des UpdatePanel-Steuerelements, und doppelklicken Sie dann in der Toolbox auf der Registerkarte Standard auf das Label-Steuerelement, um es dem UpdatePanel-Steuerelement hinzuzufügen.

    Hinweis:

    Stellen Sie sicher, dass Sie das Label-Steuerelement innerhalb des UpdatePanel-Steuerelements hinzufügen.

  7. Legen Sie die Text-Eigenschaft der Bezeichnung auf Bereich noch nicht aktualisiert fest.

  8. Klicken Sie außerhalb des UpdatePanel-Steuerelements, und doppelklicken Sie auf das Label-Steuerelement, um außerhalb des UpdatePanel-Steuerelements eine zweite Bezeichnung hinzuzufügen.

    Hinweis:

    Stellen Sie sicher, dass Sie das zweite Label-Steuerelement außerhalb des UpdatePanel-Steuerelements hinzufügen.

  9. Doppelklicken Sie auf das Timer-Steuerelement, um einen Handler für das Tick-Ereignis zu erstellen.

  10. Fügen Sie Code hinzu, in dem die Text-Eigenschaft des Label1-Steuerelements auf die aktuelle Zeit festgelegt wird.

  11. Erstellen Sie einen Page_Load-Handler, und fügen Sie Code hinzu, mit dem die Text-Eigenschaft des Label2-Steuerelements auf die Zeit festgelegt wird, zu der die Seite erstellt wird.

  12. Wechseln Sie in die Quellansicht.

    Stellen Sie sicher, dass das Markup für die Seite folgendermaßen lautet:

    Partial Class _Default
        Inherits System.Web.UI.Page
    
        Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
            Label2.Text = "Page created at: " & _
              DateTime.Now.ToLongTimeString()
        End Sub
    
        Protected Sub Timer1_Tick(ByVal sender As Object, ByVal e As System.EventArgs)
            Label1.Text = "Panel refreshed at: " & _
              DateTime.Now.ToLongTimeString()
    
        End Sub
    End Class
    
    public partial class _Default : System.Web.UI.Page 
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            Label2.Text = "Page created at: " +
              DateTime.Now.ToLongTimeString();
        }
        protected void Timer1_Tick(object sender, EventArgs e)
        {
            Label1.Text = "Panel refreshed at: " +
              DateTime.Now.ToLongTimeString();
        }
    }
    
  13. Speichern Sie die Änderungen, und drücken Sie STRG+F5, um die Seite in einem Browser anzuzeigen.

  14. Warten Sie mindestens 10 Sekunden, damit der Bereich aktualisiert wird.

    Der Text in diesem Bereich ändert sich und zeigt den Zeitpunkt an, zu dem der Inhalt des Bereichs zuletzt aktualisiert wurde. Der Text außerhalb des Bereichs wird jedoch nicht aktualisiert.

Zusammenfassung

In dieser exemplarischen Vorgehensweise wurden Grundlagen zur Verwendung eines Timer-Steuerelements und eines UpdatePanel-Steuerelements für Teilaktualisierungen von Seiten vorgestellt. Ein ScriptManager-Steuerelement muss jeder Seite hinzugefügt werden, die ein UpdatePanel-Steuerelement oder ein Timer-Steuerelement enthält. Standardmäßig bewirkt ein Timer-Steuerelement innerhalb des Bereichs, dass während eines asynchronen Postbacks nur der betreffende Bereich aktualisiert wird. Ein Timer-Steuerelement außerhalb eines Bereichs kann die Aktualisierung des UpdatePanel bewirken, wenn es für den Bereich als Trigger konfiguriert ist.

Im nächsten Schritt lernen Sie die Verwendung des Timer-Steuerelements außerhalb eines UpdatePanel-Steuerelements und die Aktualisierung von mehreren UpdatePanel-Steuerelementen mithilfe des Zeitgebers. Informationen zu diesen Aufgaben finden Sie unter Exemplarische Vorgehensweise: Verwenden des ASP.NET-Timer-Steuerelements mit mehreren UpdatePanel-Steuerelementen.

Siehe auch

Konzepte

Übersicht über das Timer-Steuerelement

Übersicht über das Teilrendering von Seiten

Referenz

Timer

UpdatePanel

ScriptManager