ScriptManager ScriptManager ScriptManager ScriptManager Class

Definición

Administra las bibliotecas de scripts y los archivos de script AJAX de ASP.NET, la representación parcial de página y la generación de la clase de proxy de cliente para los servicios Web y de aplicación.Manages ASP.NET Ajax script libraries and script files, partial-page rendering, and client proxy class generation for Web and application services.

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

Ejemplos

Los ejemplos siguientes muestran distintos escenarios para usar el ScriptManager control.The following examples show different scenarios for using the ScriptManager control.

Habilitar actualizaciones parciales de páginaEnabling Partial-Page Updates

El ejemplo siguiente muestra cómo usar el ScriptManager control para habilitar las actualizaciones parciales de página.The following example shows how to use the ScriptManager control to enable partial-page updates. En este ejemplo, un Calendar y un DropDownList control están dentro de un UpdatePanel control.In this example, a Calendar and a DropDownList control are inside an UpdatePanel control. De forma predeterminada, el valor de la UpdateMode propiedad es Alwaysy el valor de la ChildrenAsTriggers propiedad es true.By default, the value of the UpdateMode property is Always, and the value of the ChildrenAsTriggers property is true. Por lo tanto, los controles secundarios del panel de provocan un postback asincrónico.Therefore, child controls of the panel cause an asynchronous postback.


<%@ 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">
    void DropDownSelection_Change(Object sender, EventArgs e)
    {
        Calendar1.DayStyle.BackColor =
            System.Drawing.Color.FromName(ColorList.SelectedItem.Value);
    }

    protected void Calendar1_SelectionChanged(object sender, EventArgs e)
    {
        SelectedDate.Text = 
            Calendar1.SelectedDate.ToString();
    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>UpdatePanel Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1" 
                               runat="server" />
            <asp:UpdatePanel ID="UpdatePanel1"
                             runat="server">
                <ContentTemplate>
                    <asp:Calendar ID="Calendar1" 
                                  ShowTitle="True"
                                  OnSelectionChanged="Calendar1_SelectionChanged"
                                  runat="server" />
                    <div>
                        Background:
                        <br />
                        <asp:DropDownList ID="ColorList" 
                                          AutoPostBack="True" 
                                          OnSelectedIndexChanged="DropDownSelection_Change"
                                          runat="server">
                            <asp:ListItem Selected="True" Value="White"> 
                            White </asp:ListItem>
                            <asp:ListItem Value="Silver"> 
                            Silver </asp:ListItem>
                            <asp:ListItem Value="DarkGray"> 
                            Dark Gray </asp:ListItem>
                            <asp:ListItem Value="Khaki"> 
                            Khaki </asp:ListItem>
                            <asp:ListItem Value="DarkKhaki"> D
                            ark Khaki </asp:ListItem>
                        </asp:DropDownList>
                    </div>
                    <br />
                    Selected date:
                    <asp:Label ID="SelectedDate" 
                               runat="server">None.</asp:Label>
                </ContentTemplate>
            </asp:UpdatePanel>
            <br />
        </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">
    Sub DropDownSelection_Change(ByVal Sender As Object, ByVal E As EventArgs)
        Calendar1.DayStyle.BackColor = _
        System.Drawing.Color.FromName(ColorList.SelectedItem.Value)
    End Sub

    Protected Sub Calendar1_SelectionChanged(ByVal Sender As Object, ByVal E As EventArgs)
        SelectedDate.Text = Calendar1.SelectedDate.ToString()
    End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>UpdatePanel Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1" 
                               runat="server" />
            <asp:UpdatePanel ID="UpdatePanel1"
                             runat="server">
                <ContentTemplate>
                    <asp:Calendar ID="Calendar1" 
                                  ShowTitle="True"
                                  OnSelectionChanged="Calendar1_SelectionChanged"
                                  runat="server" />
                    <div>
                        Background:
                        <br />
                        <asp:DropDownList ID="ColorList" 
                                          AutoPostBack="True" 
                                          OnSelectedIndexChanged="DropDownSelection_Change"
                                          runat="server">
                            <asp:ListItem Selected="True" Value="White"> 
                            White </asp:ListItem>
                            <asp:ListItem Value="Silver"> 
                            Silver </asp:ListItem>
                            <asp:ListItem Value="DarkGray"> 
                            Dark Gray </asp:ListItem>
                            <asp:ListItem Value="Khaki"> 
                            Khaki </asp:ListItem>
                            <asp:ListItem Value="DarkKhaki"> D
                            ark Khaki </asp:ListItem>
                        </asp:DropDownList>
                    </div>
                    <br />
                    Selected date:
                    <asp:Label ID="SelectedDate" 
                               runat="server">None.</asp:Label>
                </ContentTemplate>
            </asp:UpdatePanel>
            <br />
        </div>
    </form>
</body>
</html>

Control de errores de actualización parcial de página y registrar el ScriptHandling Partial-Page Update Errors and Registering Script

El ejemplo siguiente muestra cómo proporcionar control durante las actualizaciones parciales de página de errores personalizada.The following example shows how to provide custom error handling during partial-page updates. De forma predeterminada, cuando se produce un error durante las actualizaciones parciales de página, se muestra un cuadro de mensaje de JavaScript.By default, when an error occurs during partial-page updates, a JavaScript message box is displayed. Este ejemplo muestra cómo usar los errores personalizados proporcionando un controlador para el AsyncPostBackError eventos y estableciendo el AsyncPostBackErrorMessage propiedad en el controlador de eventos.This example demonstrates how to use custom error handling by providing a handler for the AsyncPostBackError event, and by setting the AsyncPostBackErrorMessage property in the event handler. También puede establecer el AllowCustomErrorsRedirect propiedad para especificar cómo se usa la sección de errores personalizados del archivo Web.config cuando se produce un error durante las actualizaciones parciales de página.You can also set the AllowCustomErrorsRedirect property to specify how the custom errors section of the Web.config file is used when an error occurs during partial-page updates. En este ejemplo, el valor predeterminado de la AllowCustomErrorsRedirect se utiliza la propiedad.In this example, the default value of the AllowCustomErrorsRedirect property is used. Esto significa que si el archivo Web.config que contiene el archivo una customErrors , ese elemento determina cómo se muestran los errores.This means that if the Web.config file contains a customErrors element, that element determines how errors are displayed. Para obtener más información, consulte customErrors Element (ASP.NET Settings Schema).For more information, see customErrors Element (ASP.NET Settings Schema).

<%@ 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 Button1_Click(object sender, EventArgs e)
    {
        try
        {
            int a = Int32.Parse(TextBox1.Text);
            int b = Int32.Parse(TextBox2.Text);
            int res = a / b;
            Label1.Text = res.ToString();
        }
        catch (Exception ex)
        {
            if (TextBox1.Text.Length > 0 && TextBox2.Text.Length > 0)
            {
                ex.Data["ExtraInfo"] = " You can't divide " +
                    TextBox1.Text + " by " + TextBox2.Text + ".";
            }
            throw ex;
        }
    }

    protected void ScriptManager1_AsyncPostBackError(object sender, AsyncPostBackErrorEventArgs e)
    {
        if (e.Exception.Data["ExtraInfo"] != null)
        {
            ScriptManager1.AsyncPostBackErrorMessage =
                e.Exception.Message +
                e.Exception.Data["ExtraInfo"].ToString();
        }
        else
        {
            ScriptManager1.AsyncPostBackErrorMessage =
                "An unspecified error occurred.";
        }
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>UpdatePanel Error Handling Example</title>
    <style type="text/css">
    #UpdatePanel1 {
      width: 200px; height: 50px;
      border: solid 1px gray;
    }
    #AlertDiv{
    left: 40%; top: 40%;
    position: absolute; width: 200px;
    padding: 12px; 
    border: #000000 1px solid;
    background-color: white; 
    text-align: left;
    visibility: hidden;
    z-index: 99;
    }
    #AlertButtons{
    position: absolute; right: 5%; bottom: 5%;
    }
    </style>
</head>
<body id="bodytag">
    <form id="form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1" 
            OnAsyncPostBackError="ScriptManager1_AsyncPostBackError" runat="server" >
            <Scripts>
            <asp:ScriptReference Path="ErrorHandling.js" />
            </Scripts>
            </asp:ScriptManager>
            <asp:UpdatePanel ID="UpdatePanel1" runat="server">
                <ContentTemplate>
                    <asp:TextBox ID="TextBox1" runat="server" Width="39px"></asp:TextBox>
                    /
                    <asp:TextBox ID="TextBox2" runat="server" Width="39px"></asp:TextBox>
                    =
                    <asp:Label ID="Label1" runat="server"></asp:Label><br />
                    <asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="calculate" />
                </ContentTemplate>
            </asp:UpdatePanel>
            <div id="AlertDiv">
                <div id="AlertMessage">
                </div>
                <br />
                <div id="AlertButtons">
                    <input id="OKButton" type="button" value="OK" runat="server" onclick="ClearErrorState()" />
                </div>
            </div>
        </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 Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)
        Try
            Dim a As Int32
            a = Int32.Parse(TextBox1.Text)
            Dim b As Int32
            b = Int32.Parse(TextBox2.Text)
            Dim res As Int32 = a / b
            Label1.Text = res.ToString()
        Catch ex As Exception
            If (TextBox1.Text.Length > 0 AndAlso TextBox2.Text.Length > 0) Then
                ex.Data("ExtraInfo") = " You can't divide " & _
                  TextBox1.Text & " by " & TextBox2.Text & "."
            End If
            Throw ex
        End Try

    End Sub
    Protected Sub ScriptManager1_AsyncPostBackError(ByVal sender As Object, ByVal e As System.Web.UI.AsyncPostBackErrorEventArgs)
        If (e.Exception.Data("ExtraInfo") <> Nothing) Then
            ScriptManager1.AsyncPostBackErrorMessage = _
               e.Exception.Message & _
               e.Exception.Data("ExtraInfo").ToString()
        Else
            ScriptManager1.AsyncPostBackErrorMessage = _
               "An unspecified error occurred."
        End If
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>UpdatePanel Error Handling Example</title>
    <style type="text/css">
    #UpdatePanel1 {
      width: 200px; height: 50px;
      border: solid 1px gray;
    }
    #AlertDiv{
    left: 40%; top: 40%;
    position: absolute; width: 200px;
    padding: 12px; 
    border: #000000 1px solid;
    background-color: white; 
    text-align: left;
    visibility: hidden;
    z-index: 99;
    }
    #AlertButtons{
    position: absolute; right: 5%; bottom: 5%;
    }
    </style>
</head>
<body id="bodytag">
    <form id="form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1" 
            OnAsyncPostBackError="ScriptManager1_AsyncPostBackError" runat="server" >
            <Scripts>
            <asp:ScriptReference Path="ErrorHandling.js" />
            </Scripts>
            </asp:ScriptManager>

            <asp:UpdatePanel ID="UpdatePanel1" runat="server">
                <ContentTemplate>
                    <asp:TextBox ID="TextBox1" runat="server" Width="39px"></asp:TextBox>
                    /
                    <asp:TextBox ID="TextBox2" runat="server" Width="39px"></asp:TextBox>
                    =
                    <asp:Label ID="Label1" runat="server"></asp:Label><br />
                    <asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="calculate" />
                </ContentTemplate>
            </asp:UpdatePanel>
            <div id="AlertDiv">
                <div id="AlertMessage">
                </div>
                <br />
                <div id="AlertButtons">
                    <input id="OKButton" type="button" value="OK" runat="server" onclick="ClearErrorState()" />
                </div>
            </div>
        </div>
    </form>
</body>
</html>

Globalizar la fecha y hora que se muestran en el exploradorGlobalizing the Date and Time That Are Displayed in the Browser

El ejemplo siguiente muestra cómo establecer el EnableScriptGlobalization propiedad para ese script de cliente pueda mostrar una fecha específica de la referencia cultural y la hora en el explorador.The following example shows how to set the EnableScriptGlobalization property so that client script can display a culture-specific date and time in the browser. En el ejemplo, el Culture atributo de la @ Page directiva está establecida en auto.In the example, the Culture attribute of the @ Page directive is set to auto. Como resultado, el primer idioma que se especifica en la configuración actual del explorador determina la referencia cultural y la referencia cultural de interfaz de usuario para la página.As a result, the first language that is specified in the current browser settings determines the culture and UI culture for the page. Para obtener más información, vea Cómo: Establecer la referencia cultural y la referencia cultural de interfaz de usuario para la globalización de páginas Web ASP.NET.For more information, see How to: Set the Culture and UI Culture for ASP.NET Web Page Globalization.

<%@ Page Language="C#" Culture="auto" %>

<!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 id="Head1" runat="server">
    <title>Globalization Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <asp:ScriptManager ID="ScriptManager1" EnableScriptGlobalization="true" runat="server">
        </asp:ScriptManager>
        <script type="text/javascript">
        function pageLoad() {
          Sys.UI.DomEvent.addHandler($get("Button1"), "click", formatDate);
        }
        function formatDate() {
          var d = new Date();
          try {
            $get('Label1').innerHTML = d.localeFormat("dddd, dd MMMM yyyy HH:mm:ss");
          }
          catch(e) {
            alert("Error:" + e.message);
          }
        }
        </script>
        <asp:UpdatePanel ID="UpdatePanel1" runat="server" ChildrenAsTriggers="False" UpdateMode="Conditional">
        <ContentTemplate>
        <asp:Panel ID="Panel1" runat="server" GroupingText="Update Panel">
        <asp:Button ID="Button1" runat="server" Text="Display Date" />

        <br />

        <asp:Label ID="Label1" runat="server"></asp:Label>
        </asp:Panel>
        </ContentTemplate>
        </asp:UpdatePanel>
    </form>
</body>
</html>
<%@ Page Language="VB" Culture="auto" %>

<!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 id="Head1" runat="server">
    <title>Globalization Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <asp:ScriptManager ID="ScriptManager1" EnableScriptGlobalization="true" runat="server">
        </asp:ScriptManager>
        <script type="text/javascript">
        function pageLoad() {
          Sys.UI.DomEvent.addHandler($get("Button1"), "click", formatDate);
        }
        function formatDate() {
          var d = new Date();
          try {
            $get('Label1').innerHTML = d.localeFormat("dddd, dd MMMM yyyy HH:mm:ss");
          }
          catch(e) {
            alert("Error:" + e.message);
          }
        }
        </script>
        <asp:UpdatePanel ID="UpdatePanel1" runat="server" ChildrenAsTriggers="False" UpdateMode="Conditional">
        <ContentTemplate>
        <asp:Panel ID="Panel1" runat="server" GroupingText="Update Panel">
        <asp:Button ID="Button1" runat="server" Text="Display Date" />

        <br />

        <asp:Label ID="Label1" runat="server"></asp:Label>
        </asp:Panel>
        </ContentTemplate>
        </asp:UpdatePanel>
    </form>
</body>
</html>

Comentarios

En este tema:In this topic:

IntroducciónIntroduction

El ScriptManager control es fundamental para la funcionalidad de Ajax en ASP.NET.The ScriptManager control is central to Ajax functionality in ASP.NET. El control administra todos los recursos de ASP.NET Ajax en una página.The control manages all ASP.NET Ajax resources on a page. Esto incluye la descarga de scripts de Microsoft Ajax Library en el explorador y coordinar las actualizaciones parciales de página que se habilitan empleando UpdatePanel controles.This includes downloading Microsoft Ajax Library scripts to the browser and coordinating partial-page updates that are enabled by using UpdatePanel controls. Además, el ScriptManager control le permite hacer lo siguiente:In addition, the ScriptManager control enables you to do the following:

  • Script de registro que es compatible con las actualizaciones parciales de página.Register script that is compatible with partial-page updates. Para administrar las dependencias entre la secuencia de comandos y la biblioteca principal, cualquier script que registre se carga después de la secuencia de comandos de Microsoft Ajax Library.In order to manage dependencies between your script and the core library, any script that you register is loaded after the Microsoft Ajax Library script.

  • Especifique si la versión o scripts de depuración se envían al explorador.Specify whether release or debug scripts are sent to the browser.

  • Proporcionar acceso a métodos de servicio Web desde el script mediante el registro de servicios Web con el ScriptManager control.Provide access to Web service methods from script by registering Web services with the ScriptManager control.

  • Proporcionar servicios de aplicaciones de script de cliente de acceso a la autenticación, roles y perfil ASP.NET mediante el registro de estos servicios con el ScriptManager control.Provide access to ASP.NET authentication, role, and profile application services from client script by registering these services with the ScriptManager control.

  • Habilitar la visualización de la referencia cultural específica de ECMAScript (JavaScript), y cadena funciones en el explorador.Enable culture-specific display of ECMAScript (JavaScript) , , and String functions in the browser.

  • Obtener acceso a los recursos de localización para los archivos de script incrustados o para archivos de script independientes mediante la ResourceUICultures propiedad de la ScriptReference control.Access localization resources for embedded script files or for stand-alone script files by using the ResourceUICultures property of the ScriptReference control.

  • Registrar controles de servidor que implementan la IExtenderControl o IScriptControl interactúa con el ScriptManager para que se represente el script requerido por los componentes de cliente y los comportamientos de control.Register server controls that implement the IExtenderControl or IScriptControl interfaces with the ScriptManager control so that script required by client components and behaviors is rendered.

Representación parcial de páginaPartial-Page Rendering

La capacidad de una página ASP.NET para admitir la representación parcial de página se controla mediante los siguientes factores:The ability of an ASP.NET page to support partial-page rendering is controlled by the following factors:

Puede invalidar el valor de la EnablePartialRendering propiedad en tiempo de ejecución durante o antes de la página Init eventos.You can override the value of the EnablePartialRendering property at run time during or before the page's Init event. Si intenta cambiar esta propiedad después de la página Init se ha producido el evento, un InvalidOperationException es una excepción.If you try to change this property after the page's Init event has occurred, an InvalidOperationException exception is thrown.

Cuando se admite la representación parcial de página, el ScriptManager control representa el script para habilitar los postbacks asincrónicos y las actualizaciones parciales de página.When partial-page rendering is supported, the ScriptManager control renders script to enable asynchronous postbacks and partial-page updates. Las regiones de la página para actualizarse se designan mediante el uso de UpdatePanel controles.The regions of the page to be updated are designated by using UpdatePanel controls. El ScriptManager control controla los postbacks asincrónicos y actualiza únicamente las regiones de la página que tengan que actualizarse.The ScriptManager control handles the asynchronous postbacks and refreshes only the regions of the page that have to be updated. Para obtener más información acerca de la representación parcial de página, vea Introducción a la representación parcial de página.For more information about partial-page rendering, see Partial-Page Rendering Overview. Para obtener más información acerca de las condiciones que provocan una actualización, consulte información general del Control UpdatePanel.For more information about the conditions that cause an update, see UpdatePanel Control Overview.

Usar el Control ScriptManager con páginas maestras, controles de usuario y otros componentes secundariosUsing the ScriptManager Control with Master Pages, User Controls, and Other Child Components

Una página puede contener sólo un ScriptManager control en su jerarquía.A page can contain only one ScriptManager control in its hierarchy. Para registrar los servicios y scripts de páginas anidadas, controles de usuario o componentes cuando la página primaria tiene ya un ScriptManager controlar, use el ScriptManagerProxy control.To register services and scripts for nested pages, user controls, or components when the parent page already has a ScriptManager control, use the ScriptManagerProxy control. Para obtener más información, consulte mediante el UpdatePanel Control con páginas maestrasFor more information, see Using the UpdatePanel Control with Master Pages

Secuencia de comandos administración y registroScript Management and Registration

El ScriptManager control permite registrar la secuencia de comandos que, a continuación, se representa como parte de la página.The ScriptManager control enables you to register script that is then rendered as part of the page. El ScriptManager métodos de registro de control se pueden dividir en las tres categorías siguientes:The ScriptManager control registration methods can be broken into the following three categories:

  • Métodos de registro que garantizan que se mantienen las dependencias de secuencia de comandos de Microsoft Ajax Library.Registration methods that guarantee that script dependencies on the Microsoft Ajax Library are maintained.

  • Los métodos de registro que no son dependientes de Microsoft Ajax Library, pero que son compatibles con UpdatePanel controles.Registration methods that are not dependent on the Microsoft Ajax Library, but that are compatible with UpdatePanel controls.

  • Los métodos de registro que permiten trabajar con UpdatePanel controles.Registration methods that support working with UpdatePanel controls.

Para obtener más información acerca de cómo crear y usar el script de Ajax en ASP.NET, vea crear Script de cliente personalizado mediante el uso de Microsoft Ajax Library.For more information about how to create and use Ajax script in ASP.NET, see Creating Custom Client Script by Using the Microsoft Ajax Library.

Registra el Script que depende de la biblioteca de Microsoft AjaxRegistering Script That Is Dependent on the Microsoft Ajax Library

Puede usar los métodos siguientes para registrar los archivos de script de forma que garantiza que se mantienen las dependencias de Microsoft Ajax Library.You can use the following methods to register script files in a way that guarantees that any dependencies on the Microsoft Ajax Library are maintained.

MétodoMethod DefiniciónDefinition
RegisterScriptControl Registra un control de servidor que implementa el IScriptControl interfaz que se utiliza para definir un Sys.Component objeto de cliente.Registers a server control that implements the IScriptControl interface that is used to define a Sys.Component client object. El ScriptManager control procesa la secuencia de comandos que admite el objeto de cliente.The ScriptManager control renders script that supports the client object.
RegisterExtenderControl Registra un control de servidor que implementa el IExtenderControl interfaz que se utiliza para definir un Sys.Component objeto de cliente.Registers a server control that implements the IExtenderControl interface that is used to define a Sys.Component client object. El ScriptManager control procesa la secuencia de comandos que admite el objeto de cliente.The ScriptManager control renders script that supports the client object.

Registrar scripts compatibles con las actualizaciones parciales de páginaRegistering Partial-Page Update Compatible Scripts

Puede usar los métodos siguientes para registrar los archivos de script que no dependen de Microsoft Ajax Library pero que son compatibles con UpdatePanel controles.You can use the following methods to register script files that are not dependent on the Microsoft Ajax Library but that are compatible with UpdatePanel controls. Estos métodos se corresponden con métodos similares de la ClientScriptManager control.These methods correspond to similar methods of the ClientScriptManager control. Si es un script de representación para su uso dentro de un UpdatePanel control, asegúrese de que llama a los métodos de la ScriptManager control.If you are rendering script for use inside an UpdatePanel control, make sure that you call the methods of the ScriptManager control.

MétodoMethod DefiniciónDefinition
RegisterArrayDeclaration Agrega un valor a una matriz de JavaScript.Adds a value to a JavaScript array. Si la matriz no existe, se crea.If the array does not exist, it is created.
RegisterClientScriptBlock Representa un script elemento después de abrir la página <form> etiqueta.Renders a script element after the page's opening <form> tag. El script se especifica como un parámetro de cadena.The script is specified as a string parameter.
RegisterClientScriptInclude Representa un script elemento después de abrir la página <form> etiqueta.Renders a script element after the page's opening <form> tag. El contenido del script se especifica estableciendo el src atributo a una dirección URL que apunta a un archivo de script.The script content is specified by setting the src attribute to a URL that points to a script file.
RegisterClientScriptResource Representa un script elemento después de abrir la página <form> etiqueta.Renders a script element after the page's opening <form> tag. El contenido del script se especifica con un nombre de recurso en un ensamblado.The script content is specified with a resource name in an assembly. El src atributo se rellena automáticamente con una dirección URL mediante una llamada a un controlador HTTP que recupera la secuencia de comandos con nombre desde el ensamblado.The src attribute is automatically populated with a URL by a call to an HTTP handler that retrieves the named script from the assembly.
RegisterExpandoAttribute Representa un par de atributo de nombre/valor personalizado (expando) en el marcado para un control especificado.Renders a custom name/value attribute pair (an expando) in the markup for a specified control.
RegisterHiddenField Representa un campo oculto.Renders a hidden field.
RegisterOnSubmitStatement Registra un script que se ejecuta en respuesta a la form del elemento submit eventos.Registers a script that is executed in response to the form element's submit event. El onSubmit atributo hace referencia a la secuencia de comandos especificado.The onSubmit attribute references the specified script.
RegisterStartupScript Representa un bloque de script de inicio justo antes de cerrar la página </form> etiqueta.Renders a startup script block just before the page's closing </form> tag. Para representar la secuencia de comandos se especifica como un parámetro de cadena.The script to render is specified as a string parameter.

Al registrar los métodos, especifique un par de clave del tipo para ese script.When you register methods, you specify a type/key pair for that script. Si ya está registrado un script con el mismo par de clave del tipo, una nueva secuencia de comandos no está registrado.If a script with the same type/key pair is already registered, a new script is not registered. De forma similar, si registra un script con un par de nombre de tipo o recurso que ya existe, el script no se agrega el elemento que hace referencia al recurso nuevo.Similarly, if you register a script with a type/resource name pair that already exists, the script element that references the resource is not added again. Al registrar un atributo expando de un atributo previamente registrado, se produce una excepción.When you register an expando attribute of a previously registered attribute, an exception is thrown. Se permite el registro duplicado de valores de la matriz.Duplicate registration of array values is allowed.

Cuando se llama a la RegisterClientScriptInclude o RegisterClientScriptResource método, evite registrar script que ejecuta las funciones insertadas.When you call the RegisterClientScriptInclude or the RegisterClientScriptResource method, avoid registering script that executes inline functions. En su lugar, registre un script que contiene las definiciones de función como controladores de eventos o definiciones de clase personalizada para su aplicación.Instead, register script that contains function definitions like event handlers or custom class definitions for your application.

Métodos de registro para los controles UpdatePanelRegistration Methods for UpdatePanel Controls

Puede usar los métodos siguientes para personalizar las actualizaciones parciales de página cuando se usa UpdatePanel controles.You can use the following methods to customize partial-page updates when you use UpdatePanel controls.

MétodoMethod de esquema JSONDefinition
RegisterAsyncPostBackControl Registra un control como desencadenador de postbacks asincrónicos.Registers a control as a trigger for asynchronous postbacks.
RegisterDataItem Envía datos personalizados a los controles durante la representación parcial de la página.Sends custom data to controls during partial-page rendering.
RegisterDispose Registra un script de eliminación para un control que está dentro de un UpdatePanel control.Registers a dispose script for a control that is inside an UpdatePanel control. Se ejecuta el script cuando el control UpdatePanel se actualiza o elimina.The script is executed when the UpdatePanel control is updated or deleted. El método dispose se utiliza para los componentes que forman parte de Microsoft Ajax Library y que tienen que liberar recursos cuando ya no se utiliza un componente de cliente.The dispose method is used for client components that are part of the Microsoft Ajax Library and that have to free resources when a component is no longer used.
RegisterPostBackControl Registra un control como desencadenador de una devolución completa.Registers a control as a trigger for a full postback. Este método se utiliza para los controles dentro de un UpdatePanel control que en caso contrario, realizarían postbacks asincrónicos.This method is used for controls inside an UpdatePanel control that would otherwise perform asynchronous postbacks.

Referencias de servicio WebWeb Service References

Puede registrar un servicio Web que se llame desde el script de cliente mediante la creación de un ServiceReference objeto y agregarla a la Services colección de los ScriptManager control.You can register a Web service to be called from client script by creating a ServiceReference object and adding it to the Services collection of the ScriptManager control. ASP.NET genera un objeto de proxy de cliente para cada ServiceReference objeto en el Services colección.ASP.NET generates a client proxy object for each ServiceReference object in the Services collection. Se puede agregar mediante programación ServiceReference objetos a la Services colección para registrar los servicios Web en tiempo de ejecución.You can programmatically add ServiceReference objects to the Services collection to register Web services at run time.

Para obtener más información acerca de cómo obtener acceso a servicios Web en la secuencia de comandos, consulte exponer servicios Web en el Script de cliente AJAX de ASP.NET y llamar a servicios Web desde el Script de cliente de AJAX de ASP.NET.For more information about how to access Web services in script, see Exposing Web Services to Client Script in ASP.NET AJAX and Calling Web Services from Client Script in ASP.NET AJAX.

LocalizaciónLocalization

El ScriptManager control genera referencias en la página representada que señalan a los archivos de script localizados adecuado, que son ambos archivos de script incrustados en ensamblados o archivos de script independientes.The ScriptManager control generates references in the rendered page that point to the appropriate localized script files, which are either script files embedded in assemblies or stand-alone script files.

Cuando el EnableScriptLocalization propiedad está establecida en true, el ScriptManager control recupera los recursos localizados (por ejemplo, las cadenas localizadas) para la referencia cultural actual, si existen.When the EnableScriptLocalization property is set to true, the ScriptManager control retrieves localized resources (such as localized strings) for the current culture, if they exist. El ScriptManager control proporciona la siguiente funcionalidad para el uso de recursos localizados:The ScriptManager control provides the following functionality for using localized resources:

  • Archivos de script que se incrustan en un ensamblado.Script files that are embedded in an assembly. El ScriptManager control determina qué archivo de script específicos de referencias culturales o cultural de reserva para enviar al explorador.The ScriptManager control determines which culture-specific or fallback-culture script file to send to the browser. Hace esto mediante el uso de la referencia cultural específica NeutralResourcesLanguageAttribute atributo de ensamblado, los recursos empaquetados con el ensamblado y la referencia cultural de interfaz de usuario del explorador (si existe).It does this by using the culture-specific NeutralResourcesLanguageAttribute assembly attribute, the resources packaged with the assembly, and the UI culture of the browser (if any).

  • Archivos de script independientes.Stand-alone script files. El ScriptManager control define la lista de referencias culturales de interfaz de usuario que se admiten mediante el ResourceUICultures propiedad de la ScriptReference objeto.The ScriptManager control defines the list of UI cultures that are supported by using the ResourceUICultures property of the ScriptReference object.

  • En modo de depuración.In debug mode. El ScriptManager control intenta procesar un archivo de script de la referencia cultural específica que contiene información de depuración.The ScriptManager control tries to render a culture-specific script file that contains debug information. Por ejemplo, si la página está en modo de depuración y la referencia cultural actual se establece como en-MX, el control representa un archivo de script que tiene un nombre como scriptname.en-MX.debug.js, si existe el archivo.For example, if the page is in debug mode and the current culture is set to en-MX, the control renders a script file that has a name such as scriptname.en-MX.debug.js, if the file exists. Si el archivo no existe, se procesa el archivo de depuración para la referencia cultural de reserva adecuadaIf the file does not exist, the debug file for the appropriate fallback culture is rendered

Para obtener más información sobre cómo localizar recursos, consulte localizar recursos de información general de las bibliotecas del componente.For more information about how to localize resources, see Localizing Resources for Component Libraries Overview.

Control de erroresError Handling

Cuando se produce un error de página durante las devoluciones asincrónicas, el AsyncPostBackError provoca el evento.When a page error occurs during asynchronous postbacks, the AsyncPostBackError event is raised. La manera en que se envían los errores en el servidor al cliente depende del AllowCustomErrorsRedirect propiedad, el AsyncPostBackErrorMessage propiedad y la sección de errores personalizados del archivo Web.config.The way in which errors on the server are sent to the client depends on the AllowCustomErrorsRedirect property, the AsyncPostBackErrorMessage property, and the custom errors section of the Web.config file. Para obtener más información, consulte personalizar el control de errores para los controles UpdatePanel.For more information, see Customizing Error Handling for UpdatePanel Controls.

Sintaxis declarativaDeclarative Syntax

<asp:ScriptManager  
    AllowCustomErrorsRedirect="True|False"  
    AsyncPostBackErrorMessage="string"  
    AsyncPostBackTimeout="integer"  
    AuthenticationService-Path="uri"  
    EnablePageMethods="True|False"  
    EnablePartialRendering="True|False"  
    EnableScriptGlobalization="True|False"  
    EnableScriptLocalization="True|False"  
    EnableTheming="True|False"  
    EnableViewState="True|False"  
    ID="string"  
    LoadScriptsBeforeUI="True|False"  
    OnAsyncPostBackError="AsyncPostBackError event handler"  
    OnDataBinding="DataBinding event handler"  
    OnDisposed="Disposed event handler"  
    OnInit="Init event handler"  
    OnLoad="Load event handler"  
    OnPreRender="PreRender event handler"  
    OnResolveScriptReference="ResolveScriptReference event handler"  
    OnUnload="Unload event handler"  
    ProfileService-LoadProperties="string"  
    ProfileService-Path="uri"  
    RoleService-LoadRoles="True|False"  
    RoleService-Path="uri"  
    runat="server"  
    ScriptMode="Auto|Inherit|Debug|Release"  
    ScriptPath="string"  
    SkinID="string"  
    SupportsPartialRendering="True|False"  
    Visible="True|False"  
>  
        <AuthenticationService  
            Path="uri"  
        />  
        <ProfileService  
            LoadProperties="string"  
            Path="uri"  
        />  
        <RoleService  
            LoadRoles="True|False"  
            Path="uri"  
        />  
        <Scripts>  
            <asp:ScriptReference  
                Assembly="string"  
                IgnoreScriptPath="True|False"  
                Name="string"  
                NotifyScriptLoaded="True|False"  
                Path="string"  
                ResourceUICultures="string"  
                ScriptMode="Auto|Debug|Inherit|Release"  
            />  
        </Scripts>  
        <Services>  
            <asp:ServiceReference  
                InlineScript="True|False"  
                Path="string"  
            />  
        </Services>  
</asp:ScriptManager>  

Constructores

ScriptManager() ScriptManager() ScriptManager() ScriptManager()

Inicializa una nueva instancia de la clase ScriptManager.Initializes a new instance of the ScriptManager class.

Propiedades

Adapter Adapter Adapter Adapter

Obtiene el adaptador específico del explorador para el control.Gets the browser-specific adapter for the control.

(Inherited from Control)
AjaxFrameworkAssembly AjaxFrameworkAssembly AjaxFrameworkAssembly AjaxFrameworkAssembly

Obtiene el ensamblado de marco de Ajax que usan los componentes de la página.Gets the Ajax framework assembly that components on the page use.

AjaxFrameworkMode AjaxFrameworkMode AjaxFrameworkMode AjaxFrameworkMode

Obtiene o establece un valor que especifica cómo se incluirán en el cliente los scripts de cliente de la biblioteca de cliente de Microsoft Ajax.Gets or sets a value that specifies how client scripts of the Microsoft Ajax client library will be included on the client.

AllowCustomErrorsRedirect AllowCustomErrorsRedirect AllowCustomErrorsRedirect AllowCustomErrorsRedirect

Obtiene o establece un valor que determina si se usa la sección de errores personalizados del archivo Web.config durante un error en un postback asincrónico.Gets or sets a value that determines whether the custom errors section of the Web.config file is used during an error in an asynchronous postback.

AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory

Obtiene o establece el directorio virtual relativo a la aplicación del objeto Page o el objeto UserControl que contiene este control.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Inherited from Control)
AsyncPostBackErrorMessage AsyncPostBackErrorMessage AsyncPostBackErrorMessage AsyncPostBackErrorMessage

Obtiene o establece el mensaje de error que se envía al cliente cuando se produce una excepción de servidor no controlada durante un postback asincrónico.Gets or sets the error message that is sent to the client when an unhandled server exception occurs during an asynchronous postback.

AsyncPostBackSourceElementID AsyncPostBackSourceElementID AsyncPostBackSourceElementID AsyncPostBackSourceElementID

Obtiene el identificador único del control que produjo el postback asincrónico.Gets the unique ID of the control that caused the asynchronous postback.

AsyncPostBackTimeout AsyncPostBackTimeout AsyncPostBackTimeout AsyncPostBackTimeout

Obtiene o establece un valor que indica el tiempo, en segundos, que transcurrirá antes de que se agote el tiempo de espera de postbacks asincrónicos si no se recibe ninguna respuesta.Gets or sets a value that indicates the time, in seconds, before asynchronous postbacks time out if no response is received.

AuthenticationService AuthenticationService AuthenticationService AuthenticationService

Obtiene el objeto AuthenticationServiceManager asociado a la instancia de ScriptManager actual.Gets the AuthenticationServiceManager object that is associated with the current ScriptManager instance.

BindingContainer BindingContainer BindingContainer BindingContainer

Obtiene el control que contiene el enlace de datos de este control.Gets the control that contains this control's data binding.

(Inherited from Control)
ChildControlsCreated ChildControlsCreated ChildControlsCreated ChildControlsCreated

Obtiene un valor que indica si se han creado controles secundarios del control de servidor.Gets a value that indicates whether the server control's child controls have been created.

(Inherited from Control)
ClientID ClientID ClientID ClientID

Obtiene el id. de control para marcado HTML que se genera por ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Inherited from Control)
ClientIDMode ClientIDMode ClientIDMode ClientIDMode

Obtiene o establece el algoritmo que se utiliza para generar el valor de la propiedad ClientID.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Inherited from Control)
ClientIDSeparator ClientIDSeparator ClientIDSeparator ClientIDSeparator

Obtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID.Gets a character value representing the separator character used in the ClientID property.

(Inherited from Control)
ClientNavigateHandler ClientNavigateHandler ClientNavigateHandler ClientNavigateHandler

Obtiene o establece el nombre del método que controla el evento Sys.Application.navigate en el cliente.Gets or sets the name of the method that handles the Sys.Application.navigate event on the client.

CompositeScript CompositeScript CompositeScript CompositeScript

Obtiene una referencia al script compuesto que admite la página web.Gets a reference to the composite script that supports the Web page.

Context Context Context Context

Obtiene el objeto HttpContext asociado al control de servidor para la solicitud Web actual.Gets the HttpContext object associated with the server control for the current Web request.

(Inherited from Control)
Controls Controls Controls Controls

Obtiene un objeto ControlCollection que representa los controles secundarios de un control de servidor especificado en la jerarquía de la interfaz de usuario.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

(Inherited from Control)
DataItemContainer DataItemContainer DataItemContainer DataItemContainer

Obtiene una referencia al contenedor de nomenclatura si este implementa IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Inherited from Control)
DataKeysContainer DataKeysContainer DataKeysContainer DataKeysContainer

Obtiene una referencia al contenedor de nomenclatura si este implementa IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Inherited from Control)
DesignMode DesignMode DesignMode DesignMode

Obtiene un valor que indica si se está utilizando un control en una superficie de diseño.Gets a value indicating whether a control is being used on a design surface.

(Inherited from Control)
EmptyPageUrl EmptyPageUrl EmptyPageUrl EmptyPageUrl

Obtiene o establece una dirección URL en una página web en blanco.Gets or sets a URL to a blank Web page.

EnableCdn EnableCdn EnableCdn EnableCdn

Determina si la página actual carga referencias de script de cliente desde rutas de acceso CDN (Content Delivery Network).Determines whether the current page loads client script references from CDN (Content Delivery Network) paths.

EnableCdnFallback EnableCdnFallback EnableCdnFallback EnableCdnFallback

Habilita la copia local de un script para cargar en caso que el CDN (red de entrega de contenido) no esté disponible.Enables local copy of a script to load in the event that the CDN (Content Delivery Network) is unavailable.

EnableHistory EnableHistory EnableHistory EnableHistory

Obtiene o establece un valor que indica si la página web admite la administración de los puntos de historial.Gets or sets a value that indicates whether the Web page supports history point management.

EnablePageMethods EnablePageMethods EnablePageMethods EnablePageMethods

Obtiene o establece un valor que indica si se puede llamar desde script de cliente a los métodos de página estáticos públicos de una página ASP.NET.Gets or sets a value that indicates whether public static page methods in an ASP.NET page can be called from client script.

EnablePartialRendering EnablePartialRendering EnablePartialRendering EnablePartialRendering

Obtiene o establece un valor que habilita la representación parcial de una página, que, a su vez, permite actualizar regiones de la página individualmente mediante el uso de controles UpdatePanel.Gets or sets a value that enables partial rendering of a page, which in turn enables you to update regions of the page individually by using UpdatePanel controls.

EnableScriptGlobalization EnableScriptGlobalization EnableScriptGlobalization EnableScriptGlobalization

Obtiene o establece un valor que indica si el control ScriptManager representa script que admite que se analice y se aplique formato a la información específica de la referencia cultural.Gets or sets a value that indicates whether the ScriptManager control renders script that supports parsing and formatting of culture-specific information.

EnableScriptLocalization EnableScriptLocalization EnableScriptLocalization EnableScriptLocalization

Obtiene o establece un valor que indica si el control ScriptManager representa versiones localizadas de archivos de script.Gets or sets a value that indicates whether the ScriptManager control renders localized versions of script files.

EnableSecureHistoryState EnableSecureHistoryState EnableSecureHistoryState EnableSecureHistoryState

Obtiene o establece un valor que indica si se debe cifrar la cadena de estado del historial.Gets or sets a value that indicates whether to encrypt the history state string.

EnableTheming EnableTheming EnableTheming EnableTheming

Obtiene o establece un valor que indica si los temas se aplican a este control.Gets or sets a value indicating whether themes apply to this control.

(Inherited from Control)
EnableViewState EnableViewState EnableViewState EnableViewState

Obtiene o establece un valor que indica si el control de servidor conserva su estado de vista, así como el estado de vista de los controles secundarios que contiene, al cliente solicitante.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Inherited from Control)
Events Events Events Events

Obtiene una lista de delegados de controladores de eventos del control.Gets a list of event handler delegates for the control. Esta propiedad es de sólo lectura.This property is read-only.

(Inherited from Control)
HasChildViewState HasChildViewState HasChildViewState HasChildViewState

Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen guardada alguna configuración del estado de vista.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Inherited from Control)
IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder

Para obtener una descripción de este miembro, vea ControlBuilder.For a description of this member, see ControlBuilder.

(Inherited from Control)
IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData

Para una descripción de este miembro, vea UserData.For a description of this member, see UserData.

(Inherited from Control)
ID ID ID ID

Obtiene o establece el identificador de programación asignado al control de servidor.Gets or sets the programmatic identifier assigned to the server control.

(Inherited from Control)
IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings

Para obtener una descripción de este miembro, vea DataBindings.For a description of this member, see DataBindings.

(Inherited from Control)
IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings

Para una descripción de este miembro, vea HasDataBindings.For a description of this member, see HasDataBindings.

(Inherited from Control)
IdSeparator IdSeparator IdSeparator IdSeparator

Obtiene el carácter utilizado para separar los identificadores de control.Gets the character used to separate control identifiers.

(Inherited from Control)
IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions

Para una descripción de este miembro, vea Expressions.For a description of this member, see Expressions.

(Inherited from Control)
IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions

Para obtener una descripción de este miembro, vea HasExpressions.For a description of this member, see HasExpressions.

(Inherited from Control)
IsChildControlStateCleared IsChildControlStateCleared IsChildControlStateCleared IsChildControlStateCleared

Obtiene un valor que indica si los controles que se encuentran en este control tienen estado de control.Gets a value indicating whether controls contained within this control have control state.

(Inherited from Control)
IsDebuggingEnabled IsDebuggingEnabled IsDebuggingEnabled IsDebuggingEnabled

Obtiene un valor que indica si se representarán las versiones de depuración de las bibliotecas de scripts de cliente.Gets a value that indicates whether the debug versions of client script libraries will be rendered.

IsInAsyncPostBack IsInAsyncPostBack IsInAsyncPostBack IsInAsyncPostBack

Obtiene un valor que indica si el postback actual se ejecuta en modo de representación parcial.Gets a value that indicates whether the current postback is being executed in partial-rendering mode.

IsNavigating IsNavigating IsNavigating IsNavigating

Obtiene un valor que indica actualmente se controla un evento Navigate.Gets a value that indicates whether a Navigate event is currently being handled.

IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Obtiene un valor que indica si el control de servidor está guardando los cambios realizados en su estado de vista.Gets a value that indicates whether the server control is saving changes to its view state.

(Inherited from Control)
IsViewStateEnabled IsViewStateEnabled IsViewStateEnabled IsViewStateEnabled

Obtiene un valor que indica si el estado de vista está habilitado para este control.Gets a value indicating whether view state is enabled for this control.

(Inherited from Control)
LoadScriptsBeforeUI LoadScriptsBeforeUI LoadScriptsBeforeUI LoadScriptsBeforeUI

Obtiene o establece un valor que indica si los scripts se cargan antes o después de cargar el marcado de la interfaz de usuario de la página.Gets or sets a value that indicates whether scripts are loaded before or after markup for the page UI is loaded.

LoadViewStateByID LoadViewStateByID LoadViewStateByID LoadViewStateByID

Obtiene un valor que indica si el control participa en la carga de su estado de vista mediante ID en lugar de índice.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Inherited from Control)
NamingContainer NamingContainer NamingContainer NamingContainer

Obtiene una referencia al contenedor de nomenclatura del control de servidor, que crea un espacio de nombres único para diferenciar los distintos controles de servidor que tienen el mismo valor para la propiedad ID.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Inherited from Control)
Page Page Page Page

Obtiene una referencia a la instancia Page que contiene el control de servidor.Gets a reference to the Page instance that contains the server control.

(Inherited from Control)
Parent Parent Parent Parent

Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página.Gets a reference to the server control's parent control in the page control hierarchy.

(Inherited from Control)
ProfileService ProfileService ProfileService ProfileService

Obtiene el objeto ProfileServiceManager asociado a la instancia de ScriptManager actual.Gets the ProfileServiceManager object that is associated with the current ScriptManager instance.

RenderingCompatibility RenderingCompatibility RenderingCompatibility RenderingCompatibility

Obtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Inherited from Control)
RoleService RoleService RoleService RoleService

Obtiene el objeto RoleServiceManager asociado a la instancia de ScriptManager actual.Gets the RoleServiceManager object that is associated with the current ScriptManager instance.

ScriptMode ScriptMode ScriptMode ScriptMode

Obtiene o establece un valor que especifica si se representan las versiones de depuración o lanzamiento de las bibliotecas de scripts de cliente.Gets or sets a value that specifies whether debug or release versions of client script libraries are rendered.

ScriptPath ScriptPath ScriptPath ScriptPath

Obtiene o establece la ruta de acceso raíz de la ubicación que se utiliza para compilar las rutas de acceso a los archivos de script personalizados y archivos de script Ajax de ASP.NET.Gets or sets the root path of the location that is used to build the paths to ASP.NET Ajax and custom script files.

ScriptResourceMapping ScriptResourceMapping ScriptResourceMapping ScriptResourceMapping

Obtiene un objeto ScriptResourceMapping.Gets a ScriptResourceMapping object.

Scripts Scripts Scripts Scripts

Obtiene un objeto ScriptReferenceCollection que contiene los objetos ScriptReference, cada uno de los cuales representa un archivo de script representado en el cliente.Gets a ScriptReferenceCollection object that contains the ScriptReference objects, each of which represents a script file rendered to the client.

Services Services Services Services

Obtiene un objeto ServiceReferenceCollection que contiene un objeto ServiceReference para cada servicio Web que ASP.NET expone en el cliente para la funcionalidad de Ajax.Gets a ServiceReferenceCollection object that contains a ServiceReference object for each Web service that ASP.NET exposes on the client for Ajax functionality.

Site Site Site Site

Obtiene información sobre el contenedor en que se encuentra el control actual cuando se representa en una superficie de diseño.Gets information about the container that hosts the current control when rendered on a design surface.

(Inherited from Control)
SkinID SkinID SkinID SkinID

Obtiene o establece la máscara que se aplica al control.Gets or sets the skin to apply to the control.

(Inherited from Control)
SupportsPartialRendering SupportsPartialRendering SupportsPartialRendering SupportsPartialRendering

Obtiene un valor que indica si el cliente admite la representación parcial de página.Gets a value that indicates whether the client supports partial-page rendering.

TemplateControl TemplateControl TemplateControl TemplateControl

Obtiene o establece una referencia a la plantilla que contiene este control.Gets or sets a reference to the template that contains this control.

(Inherited from Control)
TemplateSourceDirectory TemplateSourceDirectory TemplateSourceDirectory TemplateSourceDirectory

Obtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Inherited from Control)
UniqueID UniqueID UniqueID UniqueID

Obtiene el identificador único calificado jerárquicamente para el control de servidor.Gets the unique, hierarchically qualified identifier for the server control.

(Inherited from Control)
ValidateRequestMode ValidateRequestMode ValidateRequestMode ValidateRequestMode

Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el explorador para valores potencialmente peligrosos.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Inherited from Control)
ViewState ViewState ViewState ViewState

Obtiene un diccionario con información de estado que le permite guardar y restaurar el estado de vista de un control de servidor en las distintas solicitudes de la misma página.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Inherited from Control)
ViewStateIgnoresCase ViewStateIgnoresCase ViewStateIgnoresCase ViewStateIgnoresCase

Obtiene un valor que indica si el objeto StateBag no distingue mayúsculas de minúsculas.Gets a value that indicates whether the StateBag object is case-insensitive.

(Inherited from Control)
ViewStateMode ViewStateMode ViewStateMode ViewStateMode

Obtiene o establece el modo del estado de vista de este control.Gets or sets the view-state mode of this control.

(Inherited from Control)
Visible Visible Visible Visible

Invalida la propiedad Visible heredada de la clase Control base para evitar establecer este valor.Overrides the Visible property that is inherited from the base Control class to prevent setting this value.

Métodos

AddedControl(Control, Int32) AddedControl(Control, Int32) AddedControl(Control, Int32) AddedControl(Control, Int32)

Se llama después de agregar un control secundario a la colección Controls del objeto Control.Called after a child control is added to the Controls collection of the Control object.

(Inherited from Control)
AddHistoryPoint(NameValueCollection, String) AddHistoryPoint(NameValueCollection, String) AddHistoryPoint(NameValueCollection, String) AddHistoryPoint(NameValueCollection, String)

Crea un punto del historial y lo agrega a la pila del historial del explorador mediante la recolección de datos de estado y el título de estado que se especificaron.Creates a history point and adds it to the browser's history stack, using the specified state data collection and state title.

AddHistoryPoint(String, String) AddHistoryPoint(String, String) AddHistoryPoint(String, String) AddHistoryPoint(String, String)

Crea un punto del historial y lo agrega a la pila del historial del explorador mediante la clave de estado y el valor de estado especificados.Creates a history point and adds it to the browser's history stack, using the specified state key and state value.

AddHistoryPoint(String, String, String) AddHistoryPoint(String, String, String) AddHistoryPoint(String, String, String) AddHistoryPoint(String, String, String)

Crea un punto del historial y lo agrega a la pila del historial del explorador mediante la clave de estado, el valor de estado y el título de estado especificados.Creates a history point and adds it to the browser's history stack, using the specified state key, state value, and state title.

AddParsedSubObject(Object) AddParsedSubObject(Object) AddParsedSubObject(Object) AddParsedSubObject(Object)

Notifica al control de servidor que se analizó un elemento, ya sea XML o HTML, y agrega el elemento al objeto ControlCollection del control del servidor.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Inherited from Control)
ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page)

Aplica al control las propiedades de estilo definidas en la hoja de estilos de la página.Applies the style properties defined in the page style sheet to the control.

(Inherited from Control)
BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object)

Comienza el seguimiento en tiempo de diseño de los datos de representación.Begins design-time tracing of rendering data.

(Inherited from Control)
BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean)

Recopila información sobre el control de servidor y la pasa a la propiedad Trace para que se muestre cuando está habilitada la traza de la página.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Inherited from Control)
ClearCachedClientID() ClearCachedClientID() ClearCachedClientID() ClearCachedClientID()

Establece en null el valor de ClientID almacenado en caché.Sets the cached ClientID value to null.

(Inherited from Control)
ClearChildControlState() ClearChildControlState() ClearChildControlState() ClearChildControlState()

Elimina la información sobre el estado de control de los controles secundarios del control de servidor.Deletes the control-state information for the server control's child controls.

(Inherited from Control)
ClearChildState() ClearChildState() ClearChildState() ClearChildState()

Elimina la información sobre el estado de vista y el estado de control de los controles secundarios del control de servidor.Deletes the view-state and control-state information for all the server control's child controls.

(Inherited from Control)
ClearChildViewState() ClearChildViewState() ClearChildViewState() ClearChildViewState()

Elimina la información sobre el estado de vista de todos los controles secundarios del control de servidor.Deletes the view-state information for all the server control's child controls.

(Inherited from Control)
ClearEffectiveClientIDMode() ClearEffectiveClientIDMode() ClearEffectiveClientIDMode() ClearEffectiveClientIDMode()

Establece la propiedad ClientIDMode de la instancia del control actual y de cualquier control secundario en Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Inherited from Control)
CreateChildControls() CreateChildControls() CreateChildControls() CreateChildControls()

Lo llama el marco de páginas ASP.NET para indicar a los controles de servidor que usan la implementación basada en composición que creen los controles secundarios que contengan como forma de preparar la devolución o representación de los datos.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

(Inherited from Control)
CreateControlCollection() CreateControlCollection() CreateControlCollection() CreateControlCollection()

Crea un nuevo objeto ControlCollection que contendrá los controles secundarios (de literal y servidor) del control de servidor.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(Inherited from Control)
DataBind() DataBind() DataBind() DataBind()

Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios.Binds a data source to the invoked server control and all its child controls.

(Inherited from Control)
DataBind(Boolean) DataBind(Boolean) DataBind(Boolean) DataBind(Boolean)

Enlaza un origen de datos al control de servidor que se ha invocado y a todos sus controles secundarios con una opción para generar el evento DataBinding.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Inherited from Control)
DataBindChildren() DataBindChildren() DataBindChildren() DataBindChildren()

Enlaza un origen de datos a los controles secundarios del control de servidor.Binds a data source to the server control's child controls.

(Inherited from Control)
Dispose() Dispose() Dispose() Dispose()

Habilita un control de servidor para que realice la limpieza final antes de que se libere de la memoria.Enables a server control to perform final clean up before it is released from memory.

(Inherited from Control)
EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object)

Finaliza el seguimiento en tiempo de diseño de los datos de representación.Ends design-time tracing of rendering data.

(Inherited from Control)
EnsureChildControls() EnsureChildControls() EnsureChildControls() EnsureChildControls()

Determina si el control de servidor contiene controles secundarios.Determines whether the server control contains child controls. Si no tiene controles secundarios, los crea.If it does not, it creates child controls.

(Inherited from Control)
EnsureID() EnsureID() EnsureID() EnsureID()

Crea un identificador para controles que no tiene un identificador asignado.Creates an identifier for controls that do not have an identifier assigned.

(Inherited from Control)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindControl(String) FindControl(String) FindControl(String) FindControl(String)

Busca un control de servidor con el parámetro id especificado en el contenedor de nomenclatura actual.Searches the current naming container for a server control with the specified id parameter.

(Inherited from Control)
FindControl(String, Int32) FindControl(String, Int32) FindControl(String, Int32) FindControl(String, Int32)

Busca el contenedor de nomenclatura actual para un control de servidor con el id especificado y un entero, que se especifica en el parámetro pathOffset, que ayuda a realizar la búsqueda.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Esta versión del método FindControl no se debe reemplazar.You should not override this version of the FindControl method.

(Inherited from Control)
Focus() Focus() Focus() Focus()

Establece el foco de entrada en un control.Sets input focus to a control.

(Inherited from Control)
GetCurrent(Page) GetCurrent(Page) GetCurrent(Page) GetCurrent(Page)

Obtiene la instancia de ScriptManager para un objeto Page dado.Gets the ScriptManager instance for a given Page object.

GetDesignModeState() GetDesignModeState() GetDesignModeState() GetDesignModeState()

Obtiene datos en tiempo de diseño para un control.Gets design-time data for a control.

(Inherited from Control)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetRegisteredArrayDeclarations() GetRegisteredArrayDeclarations() GetRegisteredArrayDeclarations() GetRegisteredArrayDeclarations()

Recupera una colección de sólo lectura de las declaraciones de matriz de ECMAScript (JavaScript) que se registraron anteriormente con el objeto Page.Retrieves a read-only collection of ECMAScript (JavaScript) array declarations that were previously registered with the Page object.

GetRegisteredClientScriptBlocks() GetRegisteredClientScriptBlocks() GetRegisteredClientScriptBlocks() GetRegisteredClientScriptBlocks()

Recupera una colección de sólo lectura de los bloques de script de cliente que se registraron anteriormente con el control ScriptManager.Retrieves a read-only collection of client script blocks that were previously registered with the ScriptManager control.

GetRegisteredDisposeScripts() GetRegisteredDisposeScripts() GetRegisteredDisposeScripts() GetRegisteredDisposeScripts()

Recupera una colección de sólo lectura de los scripts dispose que se registraron anteriormente con el objeto Page.Retrieves a read-only collection of dispose scripts that were previously registered with the Page object.

GetRegisteredExpandoAttributes() GetRegisteredExpandoAttributes() GetRegisteredExpandoAttributes() GetRegisteredExpandoAttributes()

Recupera una colección de sólo lectura de atributos personalizados (Expando) que se registraron anteriormente con el objeto Page.Retrieves a read-only collection of custom (expando) attributes that were previously registered with the Page object.

GetRegisteredHiddenFields() GetRegisteredHiddenFields() GetRegisteredHiddenFields() GetRegisteredHiddenFields()

Recupera una colección de sólo lectura de los campos ocultos que se registraron anteriormente con el objeto Page.Retrieves a read-only collection of hidden fields that were previously registered with the Page object.

GetRegisteredOnSubmitStatements() GetRegisteredOnSubmitStatements() GetRegisteredOnSubmitStatements() GetRegisteredOnSubmitStatements()

Recupera una colección de sólo lectura de las instrucciones onsubmit que se registraron anteriormente con el objeto Page.Retrieves a read-only collection of onsubmit statements that were previously registered with the Page object.

GetRegisteredStartupScripts() GetRegisteredStartupScripts() GetRegisteredStartupScripts() GetRegisteredStartupScripts()

Recupera una colección de solo lectura de los scripts de inicio que se registraron anteriormente con el objeto Page.Retrieves a read-only collection of startup scripts that were previously registered with the Page object.

GetRouteUrl(Object) GetRouteUrl(Object) GetRouteUrl(Object) GetRouteUrl(Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.Gets the URL that corresponds to a set of route parameters.

(Inherited from Control)
GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.Gets the URL that corresponds to a set of route parameters.

(Inherited from Control)
GetRouteUrl(String, Object) GetRouteUrl(String, Object) GetRouteUrl(String, Object) GetRouteUrl(String, Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.Gets the URL that corresponds to a set of route parameters and a route name.

(Inherited from Control)
GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.Gets the URL that corresponds to a set of route parameters and a route name.

(Inherited from Control)
GetStateString() GetStateString() GetStateString() GetStateString()

Recupera una cadena que contiene pares clave-valor que representan el estado de la página web.Retrieves a string that contains key/value pairs that represent the state of the Web page.

GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control)

Devuelve la parte correspondiente al prefijo de la propiedad UniqueID del control especificado.Returns the prefixed portion of the UniqueID property of the specified control.

(Inherited from Control)
HasControls() HasControls() HasControls() HasControls()

Determina si el control de servidor contiene controles secundarios.Determines if the server control contains any child controls.

(Inherited from Control)
HasEvents() HasEvents() HasEvents() HasEvents()

Devuelve un valor que indica si se registran eventos para el control o los controles secundarios.Returns a value indicating whether events are registered for the control or any child controls.

(Inherited from Control)
IsLiteralContent() IsLiteralContent() IsLiteralContent() IsLiteralContent()

Determina si el control de servidor alberga únicamente contenido literal.Determines if the server control holds only literal content.

(Inherited from Control)
LoadControlState(Object) LoadControlState(Object) LoadControlState(Object) LoadControlState(Object)

Restaura información de estado de control de una solicitud de página anterior guardada por el método SaveControlState().Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(Inherited from Control)
LoadPostData(String, NameValueCollection) LoadPostData(String, NameValueCollection) LoadPostData(String, NameValueCollection) LoadPostData(String, NameValueCollection)

Lee los datos de formulario que se exponen en el servidor desde el explorador y determina el origen del postback asincrónico.Reads form data that is posted from the browser to the server, and determines the source of the asynchronous postback.

LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

Restaura la información sobre el estado de vista de una solicitud de página anterior guardada por el método SaveViewState().Restores view-state information from a previous page request that was saved by the SaveViewState() method.

(Inherited from Control)
MapPathSecure(String) MapPathSecure(String) MapPathSecure(String) MapPathSecure(String)

Recupera la ruta de acceso física a la que se asigna una ruta de acceso virtual, absoluta o relativa.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Inherited from Control)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
OnAsyncPostBackError(AsyncPostBackErrorEventArgs) OnAsyncPostBackError(AsyncPostBackErrorEventArgs) OnAsyncPostBackError(AsyncPostBackErrorEventArgs) OnAsyncPostBackError(AsyncPostBackErrorEventArgs)

Genera el evento AsyncPostBackError.Raises the AsyncPostBackError event.

OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs)

Determina si el evento del control de servidor se pasa a la jerarquía de control de servidor de la interfaz de usuario (UI) de la página.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Inherited from Control)
OnDataBinding(EventArgs) OnDataBinding(EventArgs) OnDataBinding(EventArgs) OnDataBinding(EventArgs)

Genera el evento DataBinding.Raises the DataBinding event.

(Inherited from Control)
OnInit(EventArgs) OnInit(EventArgs) OnInit(EventArgs) OnInit(EventArgs)

Provoca el evento Init y comprueba que haya tan solo un control ScriptManager en la página.Raises the Init event and makes sure that only one ScriptManager control exists on the page.

OnLoad(EventArgs) OnLoad(EventArgs) OnLoad(EventArgs) OnLoad(EventArgs)

Genera el evento Load.Raises the Load event.

(Inherited from Control)
OnPreRender(EventArgs) OnPreRender(EventArgs) OnPreRender(EventArgs) OnPreRender(EventArgs)

Provoca el evento PreRender y registra los archivos y servicios de script para las actualizaciones parciales de página.Raises the PreRender event, and registers script files and services for partial-page updates.

OnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs) OnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs) OnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs) OnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs)

Genera el evento ResolveCompositeScriptReference.Raises the ResolveCompositeScriptReference event.

OnResolveScriptReference(ScriptReferenceEventArgs) OnResolveScriptReference(ScriptReferenceEventArgs) OnResolveScriptReference(ScriptReferenceEventArgs) OnResolveScriptReference(ScriptReferenceEventArgs)

Provoca el evento ResolveScriptReference para cada referencia de script administrada por el control ScriptManager.Raises the ResolveScriptReference event for each script reference that is managed by the ScriptManager control.

OnUnload(EventArgs) OnUnload(EventArgs) OnUnload(EventArgs) OnUnload(EventArgs)

Genera el evento Unload.Raises the Unload event.

(Inherited from Control)
OpenFile(String) OpenFile(String) OpenFile(String) OpenFile(String)

Obtiene un objeto Stream utilizado para leer un archivo.Gets a Stream used to read a file.

(Inherited from Control)
RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs)

Asigna los orígenes del evento y su información al control principal del control.Assigns any sources of the event and its information to the control's parent.

(Inherited from Control)
RaisePostBackEvent(String) RaisePostBackEvent(String) RaisePostBackEvent(String) RaisePostBackEvent(String)

Procesa un evento de postback que genera el control ScriptManager y carga el estado del historial de la página web.Processes a postback event raised by the ScriptManager control and loads the history state of the Web page.

RaisePostDataChangedEvent() RaisePostDataChangedEvent() RaisePostDataChangedEvent() RaisePostDataChangedEvent()

Provoca los eventos para el control ScriptManager cuando envía datos al servidor.Raises events for the ScriptManager control when it posts back to the server.

RegisterArrayDeclaration(Control, String, String) RegisterArrayDeclaration(Control, String, String) RegisterArrayDeclaration(Control, String, String) RegisterArrayDeclaration(Control, String, String)

Registra una declaración de matriz de ECMAScript (JavaScript) con el control ScriptManager para usarlo con un control que está dentro de un control UpdatePanel y, a continuación, agrega la matriz a la página.Registers an ECMAScript (JavaScript) array declaration with the ScriptManager control for use with a control that is inside an UpdatePanel control, and adds the array to the page.

RegisterArrayDeclaration(Page, String, String) RegisterArrayDeclaration(Page, String, String) RegisterArrayDeclaration(Page, String, String) RegisterArrayDeclaration(Page, String, String)

Registra una declaración de matriz de ECMAScript (JavaScript) con el control ScriptManager para usarlo con un control que está dentro de un control UpdatePanel y, a continuación, agrega la matriz a la página.Registers an ECMAScript (JavaScript) array declaration with the ScriptManager control for use with a control that is inside an UpdatePanel control, and adds the array to the page.

RegisterAsyncPostBackControl(Control) RegisterAsyncPostBackControl(Control) RegisterAsyncPostBackControl(Control) RegisterAsyncPostBackControl(Control)

Registra un control como desencadenador de postbacks asincrónicos.Registers a control as a trigger for asynchronous postbacks.

RegisterClientScriptBlock(Control, Type, String, String, Boolean) RegisterClientScriptBlock(Control, Type, String, String, Boolean) RegisterClientScriptBlock(Control, Type, String, String, Boolean) RegisterClientScriptBlock(Control, Type, String, String, Boolean)

Registra un bloque de script de cliente con el control ScriptManager para usarlo con un control que está dentro de un control UpdatePanel y, a continuación, agrega el bloque de script a la página.Registers a client script block with the ScriptManager control for use with a control that is inside an UpdatePanel control, and then adds the script block to the page.

RegisterClientScriptBlock(Page, Type, String, String, Boolean) RegisterClientScriptBlock(Page, Type, String, String, Boolean) RegisterClientScriptBlock(Page, Type, String, String, Boolean) RegisterClientScriptBlock(Page, Type, String, String, Boolean)

Registra un bloque de script de cliente con el control ScriptManager para usarlo con un control que está dentro de un control UpdatePanel y, a continuación, agrega el bloque de script a la página.Registers a client script block with the ScriptManager control for use with a control that is inside an UpdatePanel control, and then adds the script block to the page.

RegisterClientScriptInclude(Control, Type, String, String) RegisterClientScriptInclude(Control, Type, String, String) RegisterClientScriptInclude(Control, Type, String, String) RegisterClientScriptInclude(Control, Type, String, String)

Registra un archivo script de cliente con el control ScriptManager para el uso con un control que está dentro de un control UpdatePanel y, a continuación, agrega una referencia del archivo de script a la página.Registers a client script file with the ScriptManager control for use with a control that is inside an UpdatePanel control, and then adds a script file reference to the page.

RegisterClientScriptInclude(Page, Type, String, String) RegisterClientScriptInclude(Page, Type, String, String) RegisterClientScriptInclude(Page, Type, String, String) RegisterClientScriptInclude(Page, Type, String, String)

Registra el script de cliente con el control ScriptManager cada vez que se produce un postback asincrónico y, a continuación, agrega una referencia del archivo de script a la página.Registers client script with the ScriptManager control every time that an asynchronous postback occurs, and then adds a script file reference to the page.

RegisterClientScriptResource(Control, Type, String) RegisterClientScriptResource(Control, Type, String) RegisterClientScriptResource(Control, Type, String) RegisterClientScriptResource(Control, Type, String)

Registra el script de cliente que está incrustado en un ensamblado con el control ScriptManager para su uso con un control que participa en la representación parcial de página.Registers the client script that is embedded in an assembly with the ScriptManager control for use with a control that is participating in partial-page rendering.

RegisterClientScriptResource(Page, Type, String) RegisterClientScriptResource(Page, Type, String) RegisterClientScriptResource(Page, Type, String) RegisterClientScriptResource(Page, Type, String)

Registra un archivo de script de cliente que se incrusta en un ensamblado con el control ScriptManager cada vez que se produce un postback.Registers a client script file that is embedded in an assembly with the ScriptManager control every time that a postback occurs.

RegisterDataItem(Control, String) RegisterDataItem(Control, String) RegisterDataItem(Control, String) RegisterDataItem(Control, String)

Envía datos personalizados a un control durante la representación parcial de la página.Sends custom data to a control during partial-page rendering.

RegisterDataItem(Control, String, Boolean) RegisterDataItem(Control, String, Boolean) RegisterDataItem(Control, String, Boolean) RegisterDataItem(Control, String, Boolean)

Envía datos personalizados a un control durante la representación parcial de la página e indica si los datos están en formato JavaScript Object Notation (JSON).Sends custom data to a control during partial-page rendering, and indicates whether the data is in JavaScript Object Notation (JSON) format.

RegisterDispose(Control, String) RegisterDispose(Control, String) RegisterDispose(Control, String) RegisterDispose(Control, String)

Registra un script dispose para un control que está dentro de un control UpdatePanel.Registers a dispose script for a control that is inside an UpdatePanel control. Se ejecuta el script cuando el control UpdatePanel se actualiza o elimina.The script is executed when the UpdatePanel control is updated or deleted.

RegisterExpandoAttribute(Control, String, String, String, Boolean) RegisterExpandoAttribute(Control, String, String, String, Boolean) RegisterExpandoAttribute(Control, String, String, String, Boolean) RegisterExpandoAttribute(Control, String, String, String, Boolean)

Registra un par de nombre y valor con el control ScriptManager como atributo personalizado (expando) de un control especificado.Registers a name/value pair with the ScriptManager control as a custom (expando) attribute of a specified control.

RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control) RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control) RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control) RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control)

Registra un control extensor con la instancia de ScriptManager actual.Registers an extender control with the current ScriptManager instance.

RegisterHiddenField(Control, String, String) RegisterHiddenField(Control, String, String) RegisterHiddenField(Control, String, String) RegisterHiddenField(Control, String, String)

Registra un campo oculto con el control ScriptManager para un control que está dentro de un control UpdatePanel.Registers a hidden field with the ScriptManager control for a control that is inside an UpdatePanel control.

RegisterHiddenField(Page, String, String) RegisterHiddenField(Page, String, String) RegisterHiddenField(Page, String, String) RegisterHiddenField(Page, String, String)

Registra un campo oculto con el control ScriptManager durante cada postback asincrónico.Registers a hidden field with the ScriptManager control during every asynchronous postback.

RegisterNamedClientScriptResource(Control, String) RegisterNamedClientScriptResource(Control, String) RegisterNamedClientScriptResource(Control, String) RegisterNamedClientScriptResource(Control, String)

Registra scripts por nombre de recurso de cliente incrustados en ensamblados con el control ScriptManager para su uso con un control que participa en la representación parcial de página.Registers client script by resource name that is embedded in an assembly with the ScriptManager control for use with a control that is participating in partial-page rendering.

RegisterNamedClientScriptResource(Page, String) RegisterNamedClientScriptResource(Page, String) RegisterNamedClientScriptResource(Page, String) RegisterNamedClientScriptResource(Page, String)

Registra scripts por nombre de recurso de cliente incrustados en ensamblados con el control ScriptManager para su uso con un control que participa en la representación parcial de página.Registers client script by resource name that is embedded in an assembly with the ScriptManager control for use with a control that is participating in partial-page rendering.

RegisterOnSubmitStatement(Control, Type, String, String) RegisterOnSubmitStatement(Control, Type, String, String) RegisterOnSubmitStatement(Control, Type, String, String) RegisterOnSubmitStatement(Control, Type, String, String)

Registra código ECMAScript (JavaScript) con el control ScriptManager para un control que se utiliza con un control UpdatePanel que se ejecuta cuando se envía el formulario.Registers ECMAScript (JavaScript) code with the ScriptManager control for a control that is used with an UpdatePanel control that is executed when the form is submitted.

RegisterOnSubmitStatement(Page, Type, String, String) RegisterOnSubmitStatement(Page, Type, String, String) RegisterOnSubmitStatement(Page, Type, String, String) RegisterOnSubmitStatement(Page, Type, String, String)

Registra código ECMAScript (JavaScript) con el control ScriptManager para un control que se utiliza con un control UpdatePanel que se ejecuta cuando se envía el formulario.Registers ECMAScript (JavaScript) code with the ScriptManager control for a control that is used with an UpdatePanel control that is executed when the form is submitted.

RegisterPostBackControl(Control) RegisterPostBackControl(Control) RegisterPostBackControl(Control) RegisterPostBackControl(Control)

Registra un control como desencadenador de un postback.Registers a control as a trigger for a postback. Este método se utiliza para configurar controles de postback que se encuentran dentro de un control UpdatePanel y que, de otro modo, realizarían postbacks asincrónicos.This method is used to configure postback controls inside an UpdatePanel control that would otherwise perform asynchronous postbacks.

RegisterScriptControl<TScriptControl>(TScriptControl) RegisterScriptControl<TScriptControl>(TScriptControl) RegisterScriptControl<TScriptControl>(TScriptControl) RegisterScriptControl<TScriptControl>(TScriptControl)

Registra un control de script con la instancia de ScriptManager actual.Registers a script control with the current ScriptManager instance.

RegisterScriptDescriptors(IExtenderControl) RegisterScriptDescriptors(IExtenderControl) RegisterScriptDescriptors(IExtenderControl) RegisterScriptDescriptors(IExtenderControl)

Vuelve a llamar a una clase ExtenderControl para que se devuelvan los scripts de instancia que se deben representar para admitir el objeto de cliente que representa un componente, comportamiento o control de cliente.Calls back to an ExtenderControl class to return instance scripts that must be rendered to support the client object that represents a client control, component, or behavior.

RegisterScriptDescriptors(IScriptControl) RegisterScriptDescriptors(IScriptControl) RegisterScriptDescriptors(IScriptControl) RegisterScriptDescriptors(IScriptControl)

Llama a una clase ScriptControl para que se devuelvan los scripts de instancia que se deben representar para admitir el objeto de cliente que representa un componente, comportamiento o control de cliente.Calls a ScriptControl class to return instance scripts that must be rendered to support the client object that represents a client control, component, or behavior.

RegisterStartupScript(Control, Type, String, String, Boolean) RegisterStartupScript(Control, Type, String, String, Boolean) RegisterStartupScript(Control, Type, String, String, Boolean) RegisterStartupScript(Control, Type, String, String, Boolean)

Registra un bloque de script de inicio para un control que está dentro de UpdatePanel con el control ScriptManager y agrega el bloque de script a la página.Registers a startup script block for a control that is inside an UpdatePanel by using the ScriptManager control, and adds the script block to the page.

RegisterStartupScript(Page, Type, String, String, Boolean) RegisterStartupScript(Page, Type, String, String, Boolean) RegisterStartupScript(Page, Type, String, String, Boolean) RegisterStartupScript(Page, Type, String, String, Boolean)

Registra un bloque de script de inicio para cada postback asincrónico con el control ScriptManager y agrega el bloque de script a la página.Registers a startup script block for every asynchronous postback with the ScriptManager control and adds the script block to the page.

RemovedControl(Control) RemovedControl(Control) RemovedControl(Control) RemovedControl(Control)

Se llama después de quitar un control secundario de la colección Controls del objeto Control.Called after a child control is removed from the Controls collection of the Control object.

(Inherited from Control)
Render(HtmlTextWriter) Render(HtmlTextWriter) Render(HtmlTextWriter) Render(HtmlTextWriter)

Representa el contenido del control ScriptManager en el explorador con el objeto HtmlTextWriter especificado.Renders the ScriptManager control's content to the browser by using the specified HtmlTextWriter object.

RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter)

Envía el contenido del control secundario del control de servidor a un objeto HtmlTextWriter suministrado, que escribe el contenido que se va a representar en el cliente.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Inherited from Control)
RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter)

Envía el contenido de control del servidor a un objeto HtmlTextWriter proporcionado y almacena información de seguimiento sobre el control si está habilitado el seguimiento.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Inherited from Control)
RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter)

Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Inherited from Control)
ResolveAdapter() ResolveAdapter() ResolveAdapter() ResolveAdapter()

Obtiene el adaptador de controles que se encarga de representar el control especificado.Gets the control adapter responsible for rendering the specified control.

(Inherited from Control)
ResolveClientUrl(String) ResolveClientUrl(String) ResolveClientUrl(String) ResolveClientUrl(String)

Obtiene una dirección URL que el explorador puede utilizar.Gets a URL that can be used by the browser.

(Inherited from Control)
ResolveUrl(String) ResolveUrl(String) ResolveUrl(String) ResolveUrl(String)

Convierte una dirección URL en una que el cliente solicitante pueda utilizar.Converts a URL into one that is usable on the requesting client.

(Inherited from Control)
SaveControlState() SaveControlState() SaveControlState() SaveControlState()

Guarda los cambios de estado del control de servidor que se produjeron desde la hora en que la página volvió a publicarse en el servidor.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(Inherited from Control)
SaveViewState() SaveViewState() SaveViewState() SaveViewState()

Guarda los cambios realizados en el estado de vista del control de servidor desde que la página volvió a publicarse en el servidor.Saves any server control view-state changes that have occurred since the time the page was posted back to the server.

(Inherited from Control)
SetDesignModeState(IDictionary) SetDesignModeState(IDictionary) SetDesignModeState(IDictionary) SetDesignModeState(IDictionary)

Establece los datos en tiempo de diseño para un control.Sets design-time data for a control.

(Inherited from Control)
SetFocus(Control) SetFocus(Control) SetFocus(Control) SetFocus(Control)

Establece el foco del explorador en el control especificado.Sets the browser focus to the specified control.

SetFocus(String) SetFocus(String) SetFocus(String) SetFocus(String)

Establece el foco del explorador en el control especificado mediante identificador.Sets the browser focus to the control specified by ID.

SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod)

Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal.Assigns an event handler delegate to render the server control and its content into its parent control.

(Inherited from Control)
SetTraceData(Object, Object) SetTraceData(Object, Object) SetTraceData(Object, Object) SetTraceData(Object, Object)

Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa la clave y el valor de los datos de seguimiento.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Inherited from Control)
SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object)

Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa el objeto del que se ha realizado seguimiento, así como la clave y el valor de los datos de seguimiento.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Inherited from Control)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)
TrackViewState() TrackViewState() TrackViewState() TrackViewState()

Origina el seguimiento de los cambios del estado de vista del control de servidor de manera que se puedan almacenar en el objeto StateBag del control de servidor.Causes tracking of view-state changes to the server control so they can be stored in the server control's StateBag object. Este objeto es accesible a través de la propiedad ViewState.This object is accessible through the ViewState property.

(Inherited from Control)

Eventos

AsyncPostBackError AsyncPostBackError AsyncPostBackError AsyncPostBackError

Se produce cuando hay un error de página durante un postback asincrónico.Occurs when there is a page error during an asynchronous postback.

DataBinding DataBinding DataBinding DataBinding

Se produce cuando el control de servidor se enlaza a un origen de datos.Occurs when the server control binds to a data source.

(Inherited from Control)
Disposed Disposed Disposed Disposed

Se produce cuando un control de servidor se libera de la memoria, lo que constituye la última fase del período de duración de un control de servidor cuando se solicita una página ASP.NET.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Inherited from Control)
Init Init Init Init

Tiene lugar al inicializar el control de servidor, que es el primer paso en su ciclo de vida.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Inherited from Control)
Load Load Load Load

Se produce cuando el control de servidor se carga en el objeto Page.Occurs when the server control is loaded into the Page object.

(Inherited from Control)
Navigate Navigate Navigate Navigate

Se produce cuando el usuario hace clic en el botón Atrás o Adelante del explorador.Occurs when the user clicks the browser's Back or Forward button.

PreRender PreRender PreRender PreRender

Se produce una vez que se carga el objeto Control, pero antes de su representación.Occurs after the Control object is loaded but prior to rendering.

(Inherited from Control)
ResolveCompositeScriptReference ResolveCompositeScriptReference ResolveCompositeScriptReference ResolveCompositeScriptReference

Se provoca cuando un script compuesto se registra con el control ScriptManager.Occurs when a composite script is registered with the ScriptManager control.

ResolveScriptReference ResolveScriptReference ResolveScriptReference ResolveScriptReference

Se produce cuando un miembro de la colección Scripts se registra con el control ScriptManager.Occurs when a member of the Scripts collection is registered with the ScriptManager control.

Unload Unload Unload Unload

Se produce cuando el control de servidor se descarga de la memoria.Occurs when the server control is unloaded from memory.

(Inherited from Control)

Implementaciones de interfaz explícitas

IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState()

Para una descripción de este miembro, vea GetDesignModeState().For a description of this member, see GetDesignModeState().

(Inherited from Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para una descripción de este miembro, vea SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Inherited from Control)
IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control)

Para obtener una descripción de este miembro, vea SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Inherited from Control)
IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object)

Para obtener una descripción de este miembro, vea AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Inherited from Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection) IPostBackDataHandler.LoadPostData(String, NameValueCollection) IPostBackDataHandler.LoadPostData(String, NameValueCollection) IPostBackDataHandler.LoadPostData(String, NameValueCollection)

Para obtener una descripción de este miembro, vea LoadPostData(String, NameValueCollection).For a description of this member, see LoadPostData(String, NameValueCollection).

IPostBackDataHandler.RaisePostDataChangedEvent() IPostBackDataHandler.RaisePostDataChangedEvent() IPostBackDataHandler.RaisePostDataChangedEvent() IPostBackDataHandler.RaisePostDataChangedEvent()

Para obtener una descripción de este miembro, vea RaisePostDataChangedEvent().For a description of this member, see RaisePostDataChangedEvent().

IPostBackEventHandler.RaisePostBackEvent(String) IPostBackEventHandler.RaisePostBackEvent(String) IPostBackEventHandler.RaisePostBackEvent(String) IPostBackEventHandler.RaisePostBackEvent(String)

Habilita el control ScriptManager para procesar un evento de postback y cargar el estado del historial de la página web.Enables the ScriptManager control to process a postback event and load the history state of the Web page.

IScriptManager.IsSecureConnection IScriptManager.IsSecureConnection IScriptManager.IsSecureConnection IScriptManager.IsSecureConnection
IScriptManager.RegisterArrayDeclaration(Control, String, String) IScriptManager.RegisterArrayDeclaration(Control, String, String) IScriptManager.RegisterArrayDeclaration(Control, String, String) IScriptManager.RegisterArrayDeclaration(Control, String, String)
IScriptManager.RegisterClientScriptBlock(Control, Type, String, String, Boolean) IScriptManager.RegisterClientScriptBlock(Control, Type, String, String, Boolean) IScriptManager.RegisterClientScriptBlock(Control, Type, String, String, Boolean) IScriptManager.RegisterClientScriptBlock(Control, Type, String, String, Boolean)
IScriptManager.RegisterClientScriptInclude(Control, Type, String, String) IScriptManager.RegisterClientScriptInclude(Control, Type, String, String) IScriptManager.RegisterClientScriptInclude(Control, Type, String, String) IScriptManager.RegisterClientScriptInclude(Control, Type, String, String)
IScriptManager.RegisterClientScriptResource(Control, Type, String) IScriptManager.RegisterClientScriptResource(Control, Type, String) IScriptManager.RegisterClientScriptResource(Control, Type, String) IScriptManager.RegisterClientScriptResource(Control, Type, String)
IScriptManager.RegisterDispose(Control, String) IScriptManager.RegisterDispose(Control, String) IScriptManager.RegisterDispose(Control, String) IScriptManager.RegisterDispose(Control, String)
IScriptManager.RegisterExpandoAttribute(Control, String, String, String, Boolean) IScriptManager.RegisterExpandoAttribute(Control, String, String, String, Boolean) IScriptManager.RegisterExpandoAttribute(Control, String, String, String, Boolean) IScriptManager.RegisterExpandoAttribute(Control, String, String, String, Boolean)
IScriptManager.RegisterHiddenField(Control, String, String) IScriptManager.RegisterHiddenField(Control, String, String) IScriptManager.RegisterHiddenField(Control, String, String) IScriptManager.RegisterHiddenField(Control, String, String)
IScriptManager.RegisterOnSubmitStatement(Control, Type, String, String) IScriptManager.RegisterOnSubmitStatement(Control, Type, String, String) IScriptManager.RegisterOnSubmitStatement(Control, Type, String, String) IScriptManager.RegisterOnSubmitStatement(Control, Type, String, String)
IScriptManager.RegisterPostBackControl(Control) IScriptManager.RegisterPostBackControl(Control) IScriptManager.RegisterPostBackControl(Control) IScriptManager.RegisterPostBackControl(Control)
IScriptManager.RegisterStartupScript(Control, Type, String, String, Boolean) IScriptManager.RegisterStartupScript(Control, Type, String, String, Boolean) IScriptManager.RegisterStartupScript(Control, Type, String, String, Boolean) IScriptManager.RegisterStartupScript(Control, Type, String, String, Boolean)
IScriptManager.SetFocusInternal(String) IScriptManager.SetFocusInternal(String) IScriptManager.SetFocusInternal(String) IScriptManager.SetFocusInternal(String)

Extension Methods

FindDataSourceControl(Control) FindDataSourceControl(Control) FindDataSourceControl(Control) FindDataSourceControl(Control)

Devuelve el origen de datos que está asociado al control de datos del control especificado.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String) FindFieldTemplate(Control, String) FindFieldTemplate(Control, String) FindFieldTemplate(Control, String)

Devuelve la plantilla de campo para la columna especificada en el contenedor de nomenclatura del control especificado.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control) FindMetaTable(Control) FindMetaTable(Control) FindMetaTable(Control)

Devuelve el objeto de metatabla para el control de datos contenedor.Returns the metatable object for the containing data control.

Se aplica a

Consulte también: