Compartir vía


Timer Clase

Definición

Realiza postbacks de página web asincrónicas o sincrónicas en un intervalo definido.

public ref class Timer : System::Web::UI::Control, System::Web::UI::IPostBackEventHandler, System::Web::UI::IScriptControl
[System.Drawing.ToolboxBitmap(typeof(EmbeddedResourceFinder), "System.Web.Resources.Timer.bmp")]
public class Timer : System.Web.UI.Control, System.Web.UI.IPostBackEventHandler, System.Web.UI.IScriptControl
[<System.Drawing.ToolboxBitmap(typeof(EmbeddedResourceFinder), "System.Web.Resources.Timer.bmp")>]
type Timer = class
    inherit Control
    interface IPostBackEventHandler
    interface IScriptControl
Public Class Timer
Inherits Control
Implements IPostBackEventHandler, IScriptControl
Herencia
Timer
Atributos
Implementaciones

Ejemplos

En el ejemplo siguiente se muestra un UpdatePanel control que muestra un precio de acción generado aleatoriamente y la hora en que se generó el precio de las acciones. El Timer control actualiza el contenido del UpdatePanel control cada 10 segundos.

Nota:

En este ejemplo, el intervalo del temporizador se establece en 10 segundos para que, al ejecutar el ejemplo, no tenga que esperar mucho tiempo para ver los resultados. Dado que cada intervalo de temporizador provoca un postback que provoca el tráfico de red, en una aplicación de producción debe establecer el intervalo en el tiempo más largo que sigue siendo práctico para la aplicación.

<%@ Page Language="C#" AutoEventWireup="true" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>Timer Example Page</title>
    <script runat="server">
        protected void Page_Load(object sender, EventArgs e)
        {
            OriginalTime.Text = DateTime.Now.ToLongTimeString();
        }

        protected void Timer1_Tick(object sender, EventArgs e)
        {
            StockPrice.Text = GetStockPrice();
            TimeOfPrice.Text = DateTime.Now.ToLongTimeString();
        }

        private string GetStockPrice()
        {
            double randomStockPrice = 50 + new Random().NextDouble();
            return randomStockPrice.ToString("C");
        }
    </script>
</head>
<body>
    <form id="form1" runat="server">
        <asp:ScriptManager ID="ScriptManager1" runat="server" />
        <asp:Timer ID="Timer1" OnTick="Timer1_Tick" runat="server" Interval="10000" />
      
        <asp:UpdatePanel ID="StockPricePanel" runat="server" UpdateMode="Conditional">
        <Triggers>
            <asp:AsyncPostBackTrigger ControlID="Timer1" />
        </Triggers>
        <ContentTemplate>
            Stock price is <asp:Label id="StockPrice" runat="server"></asp:Label><BR />
            as of <asp:Label id="TimeOfPrice" runat="server"></asp:Label>  
        </ContentTemplate>
        </asp:UpdatePanel>
        <div>
        Page originally created at <asp:Label ID="OriginalTime" runat="server"></asp:Label>
        </div>
    </form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="true" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Timer Example Page</title>
    <script runat="server">
        Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
            OriginalTime.Text = DateTime.Now.ToLongTimeString()
        End Sub

        Protected Sub Timer1_Tick(ByVal sender As Object, ByVal e As EventArgs)
            StockPrice.Text = GetStockPrice()
            TimeOfPrice.Text = DateTime.Now.ToLongTimeString()
        End Sub

        Private Function GetStockPrice() As String
            Dim randomStockPrice As Double = 50 + New Random().NextDouble()
            Return randomStockPrice.ToString("C")
        End Function
            
    </script>
</head>
<body>
    <form id="form1" runat="server">
    <asp:ScriptManager ID="ScriptManager1" runat="server" />
        <asp:Timer ID="Timer1" OnTick="Timer1_Tick" runat="server" Interval="10000" />
      
        <asp:UpdatePanel ID="StockPricePanel" runat="server" UpdateMode="Conditional">
        <Triggers>
            <asp:AsyncPostBackTrigger ControlID="Timer1" />
        </Triggers>
        <ContentTemplate>
            Stock price is <asp:Label id="StockPrice" runat="server"></asp:Label><BR />
            as of <asp:Label id="TimeOfPrice" runat="server"></asp:Label>  
        </ContentTemplate>
        </asp:UpdatePanel>
        <div>
        Page originally created at <asp:Label ID="OriginalTime" runat="server"></asp:Label>
        </div>
    </form>
</body>
</html>

Comentarios

En este tema:

Introducción

El Timer control permite realizar postbacks en un intervalo especificado. Cuando se usa el Timer control como desencadenador para un UpdatePanel control, el UpdatePanel control se actualiza mediante una actualización asincrónica de página parcial. Debe incluir un ScriptManager objeto en una página web para usar el Timer control .

El control se usa Timer para actualizar un UpdatePanel control mediante la inclusión del temporizador dentro del UpdatePanel control. Como alternativa, puede colocar el temporizador fuera del UpdatePanel control y establecer el temporizador como desencadenador.

También puede iniciar la postback completa de una página web completa si incluye el Timer control en la página web y no lo establece como desencadenador para un UpdatePanel control.

Puede ejecutar código de servidor cuando haya transcurrido el intervalo del temporizador mediante la creación de un controlador de eventos para el Tick evento. En el controlador de eventos, puede incluir código que ajuste dinámicamente el comportamiento del Timer control.

Establezca la Interval propiedad para especificar la frecuencia con la que se producirán los postbacks. Establezca la Enabled propiedad para activar Timer o desactivar.

Nota:

La precisión de cuando el Timer control vuelve a conectarse al servidor web depende de la precisión de la función ECMAScript (JavaScript) window.setTimeout que se ejecuta en el explorador.

La Interval propiedad se define en milisegundos. Debe establecer la Interval propiedad en un valor que permita que se complete al menos una postback asincrónica antes de que se inicie la siguiente devolución. Cuando el Timer control está fuera de un UpdatePanel control, el temporizador continúa ejecutándose mientras se actualiza el contenido del UpdatePanel control. Si se inicia una nueva postback mientras se procesa una postback anterior, se cancelará la primera devolución. El valor predeterminado es 60 000 milisegundos (60 segundos).

Nota:

Agregar un Timer control con un valor pequeño en la Interval propiedad puede generar tráfico significativo hacia y desde el servidor web. Use el Timer control para actualizar el contenido solo con la frecuencia necesaria.

Sintaxis declarativa

<asp:Timer
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    ID="string"
    Interval="integer"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnTick="Tick event handler"
    OnUnload="Unload handler"
    runat="server"
    SkinID="string"
    Visible="True|False"
/>

Constructores

Nombre Description
Timer()

Inicializa una nueva instancia de la clase Timer.

Propiedades

Nombre Description
Adapter

Obtiene el adaptador específico del explorador para el control .

(Heredado de Control)
AppRelativeTemplateSourceDirectory

Obtiene o establece el directorio virtual relativo a la Page aplicación del objeto o UserControl que contiene este control.

(Heredado de Control)
BindingContainer

Obtiene el control que contiene el enlace de datos de este control.

(Heredado de Control)
ChildControlsCreated

Obtiene un valor que indica si se han creado los controles secundarios del control de servidor.

(Heredado de Control)
ClientID

Obtiene el identificador de control para el marcado HTML generado por ASP.NET.

(Heredado de Control)
ClientIDMode

Obtiene o establece el algoritmo que se usa para generar el valor de la ClientID propiedad .

(Heredado de Control)
ClientIDSeparator

Obtiene un valor de carácter que representa el carácter separador utilizado en la ClientID propiedad .

(Heredado de Control)
Context

Obtiene el HttpContext objeto asociado al control de servidor para la solicitud web actual.

(Heredado de Control)
Controls

Obtiene un ControlCollection objeto que representa los controles secundarios de un control de servidor especificado en la jerarquía de la interfaz de usuario.

(Heredado de Control)
DataItemContainer

Obtiene una referencia al contenedor de nomenclatura si el contenedor de nomenclatura implementa IDataItemContainer.

(Heredado de Control)
DataKeysContainer

Obtiene una referencia al contenedor de nomenclatura si el contenedor de nomenclatura implementa IDataKeysControl.

(Heredado de Control)
DesignMode

Obtiene un valor que indica si se usa un control en una superficie de diseño.

(Heredado de Control)
Enabled

Obtiene o establece un valor que indica si el Timer control inicia un postback en el servidor después de que haya transcurrido el número de milisegundos especificados en la Interval propiedad.

EnableTheming

Obtiene o establece un valor que indica si los temas se aplican a este control.

(Heredado de Control)
EnableViewState

Obtiene o establece un valor que indica si el control de servidor conserva su estado de vista y el estado de vista de los controles secundarios que contiene, al cliente solicitante.

(Heredado de Control)
Events

Obtiene una lista de delegados del controlador de eventos para el control . Esta propiedad es de solo lectura.

(Heredado de Control)
HasChildViewState

Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen cualquier configuración de estado de vista guardada.

(Heredado de Control)
ID

Obtiene o establece el identificador de programación asignado al control de servidor.

(Heredado de Control)
IdSeparator

Obtiene el carácter usado para separar los identificadores de control.

(Heredado de Control)
Interval

Obtiene o establece el número de milisegundos que se van a esperar antes de iniciar un postback.

IsChildControlStateCleared

Obtiene un valor que indica si los controles contenidos en este control tienen estado de control.

(Heredado de Control)
IsTrackingViewState

Obtiene un valor que indica si el control de servidor guarda los cambios en su estado de vista.

(Heredado de Control)
IsViewStateEnabled

Obtiene un valor que indica si el estado de vista está habilitado para este control.

(Heredado de Control)
LoadViewStateByID

Obtiene un valor que indica si el control participa en la carga de su estado de vista en ID lugar del índice.

(Heredado de Control)
NamingContainer

Obtiene una referencia al contenedor de nomenclatura del control de servidor, que crea un espacio de nombres único para diferenciar entre los controles de servidor con el mismo ID valor de propiedad.

(Heredado de Control)
Page

Obtiene una referencia a la Page instancia que contiene el control de servidor.

(Heredado de Control)
Parent

Obtiene una referencia al control primario del control de servidor en la jerarquía de controles de página.

(Heredado de Control)
RenderingCompatibility

Obtiene un valor que especifica la versión de ASP.NET con la que se representará HTML.

(Heredado de Control)
Site

Obtiene información sobre el contenedor que hospeda el control actual cuando se representa en una superficie de diseño.

(Heredado de Control)
SkinID

Obtiene o establece la máscara que se va a aplicar al control.

(Heredado de Control)
TemplateControl

Obtiene o establece una referencia a la plantilla que contiene este control.

(Heredado de Control)
TemplateSourceDirectory

Obtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual.

(Heredado de Control)
UniqueID

Obtiene el identificador único calificado jerárquicamente para el control de servidor.

(Heredado de Control)
ValidateRequestMode

Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el explorador para detectar valores potencialmente peligrosos.

(Heredado de Control)
ViewState

Obtiene un diccionario de información de estado que permite guardar y restaurar el estado de vista de un control de servidor en varias solicitudes para la misma página.

(Heredado de Control)
ViewStateIgnoresCase

Obtiene un valor que indica si el StateBag objeto no distingue mayúsculas de minúsculas.

(Heredado de Control)
ViewStateMode

Obtiene o establece el modo de estado de vista de este control.

(Heredado de Control)
Visible

Invalida la Visible propiedad de la Control clase para evitar que se establezca este valor.

Métodos

Nombre Description
AddedControl(Control, Int32)

Se llama después de agregar un control secundario a la Controls colección del Control objeto .

(Heredado de Control)
AddParsedSubObject(Object)

Notifica al control de servidor que se ha analizado un elemento, ya sea XML o HTML, y agrega el elemento al objeto del control de ControlCollection servidor.

(Heredado de Control)
ApplyStyleSheetSkin(Page)

Aplica las propiedades de estilo definidas en la hoja de estilos de página al control .

(Heredado de Control)
BeginRenderTracing(TextWriter, Object)

Comienza el seguimiento en tiempo de diseño de los datos de representación.

(Heredado de Control)
BuildProfileTree(String, Boolean)

Recopila información sobre el control de servidor y la entrega a la Trace propiedad que se va a mostrar cuando el seguimiento está habilitado para la página.

(Heredado de Control)
ClearCachedClientID()

Establece el valor nullalmacenado en caché en ClientID .

(Heredado de Control)
ClearChildControlState()

Elimina la información de estado de control de los controles secundarios del control de servidor.

(Heredado de Control)
ClearChildState()

Elimina la información de estado de vista y estado de control de todos los controles secundarios del control de servidor.

(Heredado de Control)
ClearChildViewState()

Elimina la información de estado de vista de todos los controles secundarios del control de servidor.

(Heredado de Control)
ClearEffectiveClientIDMode()

Establece la ClientIDMode propiedad de la instancia de control actual y de cualquier control secundario en Inherit.

(Heredado de Control)
CreateChildControls()

Llamado por el marco de ASP.NET página para notificar a los controles de servidor que usan la implementación basada en composición para crear los controles secundarios que contengan como preparación para la publicación o representación.

(Heredado de Control)
CreateControlCollection()

Crea un nuevo ControlCollection objeto para contener los controles secundarios (literal y servidor) del control de servidor.

(Heredado de Control)
DataBind()

Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios.

(Heredado de Control)
DataBind(Boolean)

Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios con una opción para generar el DataBinding evento.

(Heredado de Control)
DataBindChildren()

Enlaza un origen de datos a los controles secundarios del control de servidor.

(Heredado de Control)
Dispose()

Permite que un control de servidor realice la limpieza final antes de liberarse de la memoria.

(Heredado de Control)
EndRenderTracing(TextWriter, Object)

Finaliza el seguimiento en tiempo de diseño de los datos de representación.

(Heredado de Control)
EnsureChildControls()

Determina si el control de servidor contiene controles secundarios. Si no es así, crea controles secundarios.

(Heredado de Control)
EnsureID()

Crea un identificador para los controles que no tienen asignado un identificador.

(Heredado de Control)
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
FindControl(String, Int32)

Busca en el contenedor de nomenclatura actual un control de servidor con el especificado id y un entero, especificado en el pathOffset parámetro , que ayuda en la búsqueda. No debe invalidar esta versión del FindControl método.

(Heredado de Control)
FindControl(String)

Busca en el contenedor de nomenclatura actual un control de servidor con el parámetro especificado id .

(Heredado de Control)
Focus()

Establece el foco de entrada en un control.

(Heredado de Control)
GetDesignModeState()

Obtiene los datos en tiempo de diseño de un control.

(Heredado de Control)
GetHashCode()

Actúa como función hash predeterminada.

(Heredado de Object)
GetRouteUrl(Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.

(Heredado de Control)
GetRouteUrl(RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.

(Heredado de Control)
GetRouteUrl(String, Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.

(Heredado de Control)
GetRouteUrl(String, RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.

(Heredado de Control)
GetScriptDescriptors()

Recupera las propiedades de un Timer objeto que se pasa al componente de cliente que implementa la lógica del temporizador en el explorador.

GetScriptReferences()

Recupera el script de cliente para el Timer control .

GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
GetUniqueIDRelativeTo(Control)

Devuelve la parte prefijo de la UniqueID propiedad del control especificado.

(Heredado de Control)
HasControls()

Determina si el control de servidor contiene controles secundarios.

(Heredado de Control)
HasEvents()

Devuelve un valor que indica si los eventos están registrados para el control o para los controles secundarios.

(Heredado de Control)
IsLiteralContent()

Determina si el control de servidor contiene solo contenido literal.

(Heredado de Control)
LoadControlState(Object)

Restaura la información de estado de control de una solicitud de página anterior guardada por el SaveControlState() método .

(Heredado de Control)
LoadViewState(Object)

Restaura la información de estado de vista de una solicitud de página anterior guardada por el SaveViewState() método .

(Heredado de Control)
MapPathSecure(String)

Recupera la ruta de acceso física a la que se asigna una ruta de acceso virtual, absoluta o relativa.

(Heredado de Control)
MemberwiseClone()

Crea una copia superficial del Objectactual.

(Heredado de Object)
OnBubbleEvent(Object, EventArgs)

Determina si el evento del control de servidor se pasa a la jerarquía de controles de servidor de interfaz de usuario de la página.

(Heredado de Control)
OnDataBinding(EventArgs)

Genera el evento DataBinding.

(Heredado de Control)
OnInit(EventArgs)

Genera el evento Init.

(Heredado de Control)
OnLoad(EventArgs)

Genera el evento Load.

(Heredado de Control)
OnPreRender(EventArgs)

Genera el PreRender evento del Timer control .

OnTick(EventArgs)

Genera el Tick evento del Timer control .

OnUnload(EventArgs)

Genera el evento Unload.

(Heredado de Control)
OpenFile(String)

Obtiene un objeto Stream que se usa para leer un archivo.

(Heredado de Control)
RaiseBubbleEvent(Object, EventArgs)

Asigna cualquier origen del evento y su información al elemento primario del control.

(Heredado de Control)
RaisePostBackEvent(String)

Permite que un Timer control genere el Tick evento cuando se publique una página en el servidor.

RemovedControl(Control)

Se llama después de quitar un control secundario de la Controls colección del Control objeto .

(Heredado de Control)
Render(HtmlTextWriter)

Representa el contenido del Timer control en el explorador mediante el objeto especificado HtmlTextWriter .

RenderChildren(HtmlTextWriter)

Genera el contenido de los elementos secundarios de un control de servidor en un objeto proporcionado HtmlTextWriter , que escribe el contenido que se va a representar en el cliente.

(Heredado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Genera contenido de control de servidor en un objeto proporcionado HtmlTextWriter mediante un objeto proporcionado ControlAdapter .

(Heredado de Control)
RenderControl(HtmlTextWriter)

Genera contenido de control de servidor en un objeto proporcionado HtmlTextWriter y almacena información de seguimiento sobre el control si el seguimiento está habilitado.

(Heredado de Control)
ResolveAdapter()

Obtiene el adaptador de control responsable de representar el control especificado.

(Heredado de Control)
ResolveClientUrl(String)

Obtiene una dirección URL que el explorador puede usar.

(Heredado de Control)
ResolveUrl(String)

Convierte una dirección URL en una que se pueda usar en el cliente solicitante.

(Heredado de Control)
SaveControlState()

Guarda los cambios de estado de control de servidor que se han producido desde el momento en que se devolvió la página al servidor.

(Heredado de Control)
SaveViewState()

Guarda los cambios de estado de vista de control de servidor que se han producido desde el momento en que la página se devolvió al servidor.

(Heredado de Control)
SetDesignModeState(IDictionary)

Establece los datos en tiempo de diseño de un control.

(Heredado de Control)
SetRenderMethodDelegate(RenderMethod)

Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en su control primario.

(Heredado de Control)
SetTraceData(Object, Object, Object)

Establece los datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, mediante el objeto rastreado, la clave de datos de seguimiento y el valor de los datos de seguimiento.

(Heredado de Control)
SetTraceData(Object, Object)

Establece los datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, mediante la clave de datos de seguimiento y el valor de los datos de seguimiento.

(Heredado de Control)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
TrackViewState()

Provoca el seguimiento de los cambios de estado de vista en el control de servidor para que se puedan almacenar en el objeto del control de StateBag servidor. Este objeto es accesible a través de la ViewState propiedad .

(Heredado de Control)

Eventos

Nombre Description
DataBinding

Se produce cuando el control de servidor se enlaza a un origen de datos.

(Heredado de Control)
Disposed

Se produce cuando se libera un control de servidor de la memoria, que es la última fase del ciclo de vida del control de servidor cuando se solicita una página de ASP.NET.

(Heredado de Control)
Init

Se produce cuando se inicializa el control de servidor, que es el primer paso de su ciclo de vida.

(Heredado de Control)
Load

Se produce cuando el control de servidor se carga en el Page objeto .

(Heredado de Control)
PreRender

Se produce después de cargar el Control objeto, pero antes de la representación.

(Heredado de Control)
Tick

Se produce cuando ha transcurrido el número de milisegundos especificados en la Interval propiedad y la página se publica en el servidor.

Unload

Se produce cuando el control de servidor se descarga de la memoria.

(Heredado de Control)

Implementaciones de interfaz explícitas

Nombre Description
IControlBuilderAccessor.ControlBuilder

Para obtener una descripción de este miembro, vea ControlBuilder.

(Heredado de Control)
IControlDesignerAccessor.GetDesignModeState()

Para obtener una descripción de este miembro, vea GetDesignModeState().

(Heredado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para obtener una descripción de este miembro, vea SetDesignModeState(IDictionary).

(Heredado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Para obtener una descripción de este miembro, vea SetOwnerControl(Control).

(Heredado de Control)
IControlDesignerAccessor.UserData

Para obtener una descripción de este miembro, vea UserData.

(Heredado de Control)
IDataBindingsAccessor.DataBindings

Para obtener una descripción de este miembro, vea DataBindings.

(Heredado de Control)
IDataBindingsAccessor.HasDataBindings

Para obtener una descripción de este miembro, vea HasDataBindings.

(Heredado de Control)
IExpressionsAccessor.Expressions

Para obtener una descripción de este miembro, vea Expressions.

(Heredado de Control)
IExpressionsAccessor.HasExpressions

Para obtener una descripción de este miembro, vea HasExpressions.

(Heredado de Control)
IParserAccessor.AddParsedSubObject(Object)

Para obtener una descripción de este miembro, vea AddParsedSubObject(Object).

(Heredado de Control)
IPostBackEventHandler.RaisePostBackEvent(String)

Genera el Tick evento cuando se publica una página en el servidor.

IScriptControl.GetScriptDescriptors()

Recupera las propiedades de un Timer objeto que se pasa al componente de cliente.

IScriptControl.GetScriptReferences()

Recupera el script de cliente para el Timer control .

Métodos de extensión

Nombre Description
FindDataSourceControl(Control)

Devuelve el origen de datos asociado al control de datos para el control especificado.

FindFieldTemplate(Control, String)

Devuelve la plantilla de campo de la columna especificada en el contenedor de nomenclatura del control especificado.

FindMetaTable(Control)

Devuelve el objeto de metatable para el control de datos contenedor.

Se aplica a