Compartir por


UpdateProgress Clase

Definición

Proporciona comentarios visuales en el explorador cuando se actualiza el contenido de uno o varios UpdatePanel controles.

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

Ejemplos

En los ejemplos siguientes se muestran distintas formas de usar el control para mostrar el UpdateProgress progreso durante las postbacks asincrónicas.

En el ejemplo siguiente se muestra un UpdateProgress control que muestra el estado de progreso de dos UpdatePanel controles.

<%@ 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 void Button_Click(object sender, EventArgs e)
    {
        System.Threading.Thread.Sleep(3000);
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>UpdateProgress Example</title>
    <style type="text/css">
    #UpdatePanel1, #UpdatePanel2, #UpdateProgress1 { 
      border-right: gray 1px solid; border-top: gray 1px solid; 
      border-left: gray 1px solid; border-bottom: gray 1px solid;
    }
    #UpdatePanel1, #UpdatePanel2 { 
      width:200px; height:200px; position: relative;
      float: left; margin-left: 10px; margin-top: 10px;
     }
     #UpdateProgress1 {
      width: 400px; background-color: #FFC080; 
      bottom: 0%; left: 0px; position: absolute;
     }
    </style>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    <asp:ScriptManager ID="ScriptManager1" runat="server" />
    <asp:UpdatePanel ID="UpdatePanel1" UpdateMode="Conditional" runat="server">
    <ContentTemplate>
    <%=DateTime.Now.ToString() %> <br />
    <asp:Button ID="Button1" runat="server" Text="Refresh Panel" OnClick="Button_Click" />    
    </ContentTemplate>
    </asp:UpdatePanel>
    <asp:UpdatePanel ID="UpdatePanel2" UpdateMode="Conditional" runat="server">
    <ContentTemplate>
    <%=DateTime.Now.ToString() %> <br />
    <asp:Button ID="Button2" runat="server" Text="Refresh Panel" OnClick="Button_Click"/>    
    </ContentTemplate>
    </asp:UpdatePanel>
    <asp:UpdateProgress ID="UpdateProgress1" runat="server">
    <ProgressTemplate>
      Update in progress...
    </ProgressTemplate>
    </asp:UpdateProgress>
    </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 Sub Button_Click(ByVal sender As Object, ByVal e As System.EventArgs)
        System.Threading.Thread.Sleep(3000)
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>UpdateProgress Example</title>
    <style type="text/css">
    #UpdatePanel1, #UpdatePanel2, #UpdateProgress1 { 
      border-right: gray 1px solid; border-top: gray 1px solid; 
      border-left: gray 1px solid; border-bottom: gray 1px solid;
    }
    #UpdatePanel1, #UpdatePanel2 { 
      width:200px; height:200px; position: relative;
      float: left; margin-left: 10px; margin-top: 10px;
     }
     #UpdateProgress1 {
      width: 400px; background-color: #FFC080; 
      bottom: 0%; left: 0px; position: absolute;
     }
    </style>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    <asp:ScriptManager ID="ScriptManager1" runat="server" />
    <asp:UpdatePanel ID="UpdatePanel1" UpdateMode="Conditional" runat="server">
    <ContentTemplate>
    <%=DateTime.Now.ToString() %> <br />
    <asp:Button ID="Button1" runat="server" Text="Refresh Panel" OnClick="Button_Click" />    
    </ContentTemplate>
    </asp:UpdatePanel>
    <asp:UpdatePanel ID="UpdatePanel2" UpdateMode="Conditional" runat="server">
    <ContentTemplate>
    <%=DateTime.Now.ToString() %> <br />
    <asp:Button ID="Button2" runat="server" Text="Refresh Panel" OnClick="Button_Click"/>    
    </ContentTemplate>
    </asp:UpdatePanel>
    <asp:UpdateProgress ID="UpdateProgress1" runat="server">
    <ProgressTemplate>
      Update in progress...
    </ProgressTemplate>
    </asp:UpdateProgress>
    </div>
    </form>
</body>
</html>

En este ejemplo siguiente se muestran dos UpdateProgress controles. Cada control muestra el estado de progreso de un control asociado UpdatePanel .

<%@ 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 void Button_Click(object sender, EventArgs e)
    {
        System.Threading.Thread.Sleep(3000);
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>UpdateProgress Example</title>
    <style type="text/css">
    #UpdatePanel1, #UpdatePanel2 { 
      width:200px; height:200px; position: relative;
      float: left; margin-left: 10px; margin-top: 10px;
      border-right: gray 1px solid; border-top: gray 1px solid; 
      border-left: gray 1px solid; border-bottom: gray 1px solid;
     }
     #UpdateProgress1, #UpdateProgress2 {
      width: 200px; background-color: #FFC080;
      position: absolute; bottom: 0px; left: 0px;
     }
    </style>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    <asp:ScriptManager ID="ScriptManager1" runat="server" />
    <asp:UpdatePanel ID="UpdatePanel1" UpdateMode="Conditional" runat="server">
    <ContentTemplate>
    <%=DateTime.Now.ToString() %> <br />
    <asp:Button ID="Button1" runat="server" Text="Refresh Panel" OnClick="Button_Click" />    
    <asp:UpdateProgress ID="UpdateProgress1" AssociatedUpdatePanelID="UpdatePanel1" runat="server">
    <ProgressTemplate>
      UpdatePanel1 updating...
    </ProgressTemplate>
    </asp:UpdateProgress>
    </ContentTemplate>
    </asp:UpdatePanel>
    <asp:UpdatePanel ID="UpdatePanel2" UpdateMode="Conditional" runat="server">
    <ContentTemplate>
    <%=DateTime.Now.ToString() %> <br />
    <asp:Button ID="Button2" runat="server" Text="Refresh Panel" OnClick="Button_Click"/>    
    <asp:UpdateProgress ID="UpdateProgress2" AssociatedUpdatePanelID="UpdatePanel2" runat="server">
    <ProgressTemplate>
      UpdatePanel2 updating...
    </ProgressTemplate>
    </asp:UpdateProgress>
    </ContentTemplate>
    </asp:UpdatePanel>
    </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 Sub Button_Click(ByVal sender As Object, ByVal e As System.EventArgs)
        System.Threading.Thread.Sleep(3000)
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>UpdateProgress Example</title>
    <style type="text/css">
    #UpdatePanel1, #UpdatePanel2 { 
      width:200px; height:200px; position: relative;
      float: left; margin-left: 10px; margin-top: 10px;
      border-right: gray 1px solid; border-top: gray 1px solid; 
      border-left: gray 1px solid; border-bottom: gray 1px solid;
     }
     #UpdateProgress1, #UpdateProgress2 {
      width: 200px; background-color: #FFC080;
      position: absolute; bottom: 0px; left: 0px;
     }
    </style>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    <asp:ScriptManager ID="ScriptManager1" runat="server" />
    <asp:UpdatePanel ID="UpdatePanel1" UpdateMode="Conditional" runat="server">
    <ContentTemplate>
    <%=DateTime.Now.ToString() %> <br />
    <asp:Button ID="Button1" runat="server" Text="Refresh Panel" OnClick="Button_Click" />    
    <asp:UpdateProgress ID="UpdateProgress1" AssociatedUpdatePanelID="UpdatePanel1" runat="server">
    <ProgressTemplate>
      UpdatePanel1 updating...
    </ProgressTemplate>
    </asp:UpdateProgress>
    </ContentTemplate>
    </asp:UpdatePanel>
    <asp:UpdatePanel ID="UpdatePanel2" UpdateMode="Conditional" runat="server">
    <ContentTemplate>
    <%=DateTime.Now.ToString() %> <br />
    <asp:Button ID="Button2" runat="server" Text="Refresh Panel" OnClick="Button_Click"/>    
    <asp:UpdateProgress ID="UpdateProgress2" AssociatedUpdatePanelID="UpdatePanel2" runat="server">
    <ProgressTemplate>
      UpdatePanel2 updating...
    </ProgressTemplate>
    </asp:UpdateProgress>
    </ContentTemplate>
    </asp:UpdatePanel>
    </div>
    </form>
</body>
</html>

Comentarios

En este tema:

Introducción

El UpdateProgress control permite proporcionar comentarios sobre el progreso de la representación parcial de páginas. En el caso de postbacks o representación de página inicial, UpdateProgress no se muestra el contenido del control.

La página puede contener varios UpdateProgress controles. Cada uno de ellos se puede asociar a un control diferente UpdatePanel . Como alternativa, puede usar un UpdateProgress control y asociarlo a todos los UpdatePanel controles de la página.

El UpdateProgress control representa un div elemento que se muestra u oculta en función de dónde se origina un postback y si se establece la AssociatedUpdatePanelID propiedad del UpdateProgress control.

Asociación de updateProgress con un control UpdatePanel

Para asociar UpdateProgress controles a un UpdatePanel control, establezca la AssociatedUpdatePanelID propiedad del UpdateProgress control. Cuando se origina un evento de postback desde dentro de un UpdatePanel control, se muestran todos los controles asociados UpdateProgress . Si no establece la AssociatedUpdatePanelID propiedad , el UpdateProgress control muestra el progreso de cualquier postback asincrónico que se origine desde dentro de cualquier UpdatePanel control. También se muestra para los controles que son desencadenadores para los paneles.

La AssociatedUpdatePanelID propiedad tiene el siguiente efecto en el comportamiento del UpdateProgress control:

Si la AssociatedUpdatePanelID propiedad se establece en un control que no existe, nunca se mostrará el UpdateProgress control.

Si la ChildrenAsTriggers propiedad de los UpdatePanel controles se establece false en y un postback se origina desde dentro de un UpdatePanel control, se seguirán mostrando todos los controles asociados UpdateProgress .

Especificar el contenido del control UpdateProgress

Utilice la ProgressTemplate propiedad para especificar el mensaje que muestra un UpdateProgress control. Si la ProgressTemplate propiedad está vacía, no se muestra nada cuando se muestra el UpdateProgress control.

La plantilla puede contener HTML y marcado. Por ejemplo, puede mostrar una imagen animada que notifique al usuario que el postback está procesando. También puede mostrar un botón en el que el usuario puede hacer clic para detener la actualización parcial de la página. Además, es posible que quiera evitar el resto de postbacks mientras uno está en curso. En el ejemplo siguiente se muestra el script de cliente que puede usar para realizar estas tareas.

<%@ 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 void Button_Click(object sender, EventArgs e)
    {
        System.Threading.Thread.Sleep(3000);
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>UpdateProgress Example</title>
    <style type="text/css">
    #UpdatePanel1, #UpdatePanel2, #UpdateProgress1 {
      border-right: gray 1px solid; border-top: gray 1px solid; 
      border-left: gray 1px solid; border-bottom: gray 1px solid;    
    }
    #UpdatePanel1, #UpdatePanel2 { 
      width:200px; height:200px; position: relative;
      float: left; margin-left: 10px; margin-top: 10px;
     }
     #UpdateProgress1 {
      width: 400px; background-color: #FFC080; 
      bottom: 0%; left: 0px; position: absolute;
     }
    </style>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    <asp:ScriptManager ID="ScriptManager1" runat="server" />
    <script type="text/javascript">
    var prm = Sys.WebForms.PageRequestManager.getInstance();
    prm.add_initializeRequest(InitializeRequest);
    function InitializeRequest(sender, args) {
      if (prm.get_isInAsyncPostBack())
       {
          args.set_cancel(true);
       }
    }
    function AbortPostBack() {
      if (prm.get_isInAsyncPostBack()) {
           prm.abortPostBack();
      }        
    }
    </script>
    <asp:UpdatePanel ID="UpdatePanel1" UpdateMode="Conditional" runat="server">
    <ContentTemplate>
    <%=DateTime.Now.ToString() %> <br />
    <asp:Button ID="Button1" runat="server" Text="Refresh Panel" OnClick="Button_Click" />    
    <br />
    Clicking the button while an asynchronous postback is in progress will
    cancel the new postback. New postbacks are only allowed if one is not
    already in progress.
    </ContentTemplate>
    </asp:UpdatePanel>
    <asp:UpdatePanel ID="UpdatePanel2" UpdateMode="Conditional" runat="server">
    <ContentTemplate>
    <%=DateTime.Now.ToString() %> <br />
    <asp:Button ID="Button2" runat="server" Text="Refresh Panel" OnClick="Button_Click"/>    
    </ContentTemplate>
    </asp:UpdatePanel>
    <asp:UpdateProgress ID="UpdateProgress1" runat="server">
    <ProgressTemplate>
      Update in progress...
      <input type="button" value="stop" onclick="AbortPostBack()" />
    </ProgressTemplate>
    </asp:UpdateProgress>
    </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 Sub Button_Click(ByVal sender As Object, ByVal e As System.EventArgs)
        System.Threading.Thread.Sleep(3000)
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>UpdateProgress Example</title>
    <style type="text/css">
    #UpdatePanel1, #UpdatePanel2, #UpdateProgress1 {
      border-right: gray 1px solid; border-top: gray 1px solid; 
      border-left: gray 1px solid; border-bottom: gray 1px solid;    
    }
    #UpdatePanel1, #UpdatePanel2 { 
      width:200px; height:200px; position: relative;
      float: left; margin-left: 10px; margin-top: 10px;
     }
     #UpdateProgress1 {
      width: 400px; background-color: #FFC080; 
      bottom: 0%; left: 0px; position: absolute;
     }
    </style>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    <asp:ScriptManager ID="ScriptManager1" runat="server" />
    <script type="text/javascript">
    var prm = Sys.WebForms.PageRequestManager.getInstance();
    prm.add_initializeRequest(InitializeRequest);
    function InitializeRequest(sender, args) {
      if (prm.get_isInAsyncPostBack())
       {
          args.set_cancel(true);
       }
    }
    function AbortPostBack() {
      if (prm.get_isInAsyncPostBack()) {
           prm.abortPostBack();
      }        
    }
    </script>
    <asp:UpdatePanel ID="UpdatePanel1" UpdateMode="Conditional" runat="server">
    <ContentTemplate>
    <%=DateTime.Now.ToString() %> <br />
    <asp:Button ID="Button1" runat="server" Text="Refresh Panel" OnClick="Button_Click" />    
    <br />
    Clicking the button while an asynchronous postback is in progress will
    cancel the new postback. New postbacks are only allowed if one is not
    already in progress.
    </ContentTemplate>
    </asp:UpdatePanel>
    <asp:UpdatePanel ID="UpdatePanel2" UpdateMode="Conditional" runat="server">
    <ContentTemplate>
    <%=DateTime.Now.ToString() %> <br />
    <asp:Button ID="Button2" runat="server" Text="Refresh Panel" OnClick="Button_Click"/>    
    </ContentTemplate>
    </asp:UpdatePanel>
    <asp:UpdateProgress ID="UpdateProgress1" runat="server">
    <ProgressTemplate>
      Update in progress...
      <input type="button" value="stop" onclick="AbortPostBack()" />
    </ProgressTemplate>
    </asp:UpdateProgress>
    </div>
    </form>
</body>
</html>

Puede usar el código de ejemplo estableciendo el onClick atributo de un HtmlButton control en "AbortPostBack()".

Colocar controles UpdateProgress en la página

UpdateProgress los controles pueden estar dentro o fuera de otros UpdatePanel controles. La presentación de la UpdateProgress plantilla del control no depende de dónde se encuentra el UpdateProgress control. En un control anidado UpdatePanel , un panel secundario está dentro de un panel primario. En ese caso, un postback que se origina desde dentro del panel secundario hace que se muestren todos los UpdateProgress controles asociados al panel secundario y al panel primario. Si un postback se origina en un control secundario inmediato del panel primario, solo se muestran los UpdateProgress controles asociados al panel primario.

Personalización cuando se muestran los controles UpdateProgress

De forma predeterminada, el UpdateProgress control espera 0,5 segundos (500 milisegundos) antes de que muestre su contenido. Esto ayuda a evitar que el control parpadee si una postback asincrónica es muy rápida. Puede especificar el retraso estableciendo la DisplayAfter propiedad .

Si necesita un control más preciso sobre cuándo se muestra un UpdateProgress control, puede proporcionar un script de cliente para los beginRequest eventos y endRequest de la PageRequestManager clase . En el beginRequest controlador de eventos, puede mostrar el elemento DOM que representa el UpdateProgress control. En el endRequest controlador de eventos, puede ocultarlo.

Debe proporcionar un script de cliente para mostrar un UpdateProgress control cuando se actualiza un control de destino UpdatePanel en las siguientes circunstancias:

  • Cuando un postback de un control se registra como un desencadenador de postback asincrónico para el panel y hay un UpdateProgress control en la página. Sin embargo, la AssociatedUpdatePanelID propiedad no está establecida en el identificador del panel.

  • Cuando los postbacks de los controles se registran como controles de postback asincrónicos mediante el RegisterAsyncPostBackControl método del ScriptManager control.

Aplicación de estilos CSS

El UpdateProgress control acepta atributos expando. Esto permite establecer una clase CSS en los elementos HTML que representan los controles. Por ejemplo, puede crear el marcado que se muestra en el ejemplo siguiente:

<asp:UpdateProgress runat="server" class="myStyle">
</asp: UpdateProgress>

El marcado del ejemplo anterior representa HTML similar al siguiente cuando se ejecuta la página:

<div id="ctl00_MainContent_UpdateProgress1" class="myStyle">
</div>

Sintaxis declarativa

<asp:UpdateProgress
    AssociatedUpdatePanelID="string"
    DisplayAfter="integer"
    DynamicLayout="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    ID="string"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    runat="server"
    SkinID="string"
    Visible="True|False"
>
        <ProgressTemplate>
            <!-- child controls -->
        </ProgressTemplate>
</asp:UpdateProgress>

Constructores

Nombre Description
UpdateProgress()

Inicializa una nueva instancia de la clase UpdateProgress.

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)
AssociatedUpdatePanelID

Obtiene o establece el identificador del control para el UpdatePanel que el UpdateProgress control muestra el estado.

Attributes

Obtiene o establece los atributos de hoja de estilos en cascada (CSS) del UpdateProgress 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 del UpdateProgress 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)
DisplayAfter

Obtiene o establece el valor en milisegundos antes de que se muestre el UpdateProgress control.

DynamicLayout

Obtiene o establece un valor que determina si la plantilla de progreso se representa dinámicamente.

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)
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)
ProgressTemplate

Obtiene o establece la plantilla que define el contenido del UpdateProgress 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

Obtiene o establece un valor que indica si un control de servidor se representa como interfaz de usuario en la página.

(Heredado de Control)

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()

Se llama para crear los controles secundarios que el UpdateProgress control contiene como preparación para la contabilización o representación.

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 UpdateProgress control y a todos sus controles secundarios.

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()

Devuelve una lista de componentes, comportamientos y controles de cliente necesarios para la UpdateProgress funcionalidad del cliente del control.

GetScriptReferences()

Devuelve una lista de dependencias de la biblioteca de scripts de cliente para el UpdateProgress 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 evento PreRender.

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)
RemovedControl(Control)

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

(Heredado de Control)
Render(HtmlTextWriter)

Escribe el contenido representado del UpdateProgress control en el explorador mediante el objeto proporcionado 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)
Unload

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

(Heredado de Control)

Implementaciones de interfaz explícitas

Nombre Description
IAttributeAccessor.GetAttribute(String)

Devuelve un atributo de un control Web mediante el nombre especificado.

IAttributeAccessor.SetAttribute(String, String)

Establece el valor del atributo user-control especificado.

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)
IScriptControl.GetScriptDescriptors()

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

IScriptControl.GetScriptReferences()

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

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

Consulte también