ScriptManager Clase

Referencia

Definición

Espacio de nombres:: System.Web.UI

Ensamblado:: System.Web.Extensions.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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.

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

[<System.Drawing.ToolboxBitmap(typeof(EmbeddedResourceFinder), "System.Web.Resources.ScriptManager.bmp")>]
type ScriptManager = class
    inherit Control
    interface IPostBackDataHandler
    interface IPostBackEventHandler

Public Class ScriptManager
Inherits Control
Implements IPostBackDataHandler, IPostBackEventHandler

Herencia: Object

Control
ScriptManager

Atributos: ToolboxBitmapAttribute

Implementaciones: IPostBackDataHandler IPostBackEventHandler

Ejemplos

En los ejemplos siguientes se muestran diferentes escenarios para usar el ScriptManager control .

Habilitación de actualizaciones de Partial-Page

En el ejemplo siguiente se muestra cómo usar el ScriptManager control para habilitar las actualizaciones parciales de páginas. En este ejemplo, un Calendar control y DropDownList están dentro de un UpdatePanel control . De forma predeterminada, el valor de la UpdateMode propiedad es Alwaysy el valor de la ChildrenAsTriggers propiedad es true. Por lo tanto, los controles secundarios del panel provocan un postback asincrónico.


<%@ 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 Partial-Page y registro de scripts

En el ejemplo siguiente se muestra cómo proporcionar un control de errores personalizado durante las actualizaciones parciales de páginas. De forma predeterminada, cuando se produce un error durante las actualizaciones parciales de la página, se muestra un cuadro de mensaje de JavaScript. En este ejemplo se muestra cómo usar el control de errores personalizado proporcionando un controlador para el AsyncPostBackError evento y estableciendo la AsyncPostBackErrorMessage propiedad en el controlador de eventos. También puede establecer la 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 la página. En este ejemplo, se usa el valor predeterminado de la AllowCustomErrorsRedirect propiedad . Esto significa que si el archivo Web.config contiene un elemento customErrors , ese elemento determina cómo se muestran los errores. Para obtener más información, vea 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>

Globalización de la fecha y hora que se muestran en el explorador

En el ejemplo siguiente se muestra cómo establecer la propiedad para que el EnableScriptGlobalization script de cliente pueda mostrar una fecha y hora específicas de la referencia cultural en el explorador. En el ejemplo, el Culture atributo de la directiva @ Page se establece en auto. Como resultado, el primer idioma especificado en la configuración actual del explorador determina la referencia cultural y la referencia cultural de la interfaz de usuario de la página. Para obtener más información, vea 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:

Introducción
Representación parcial de páginas
Usar el control ScriptManager con páginas maestras, controles de usuario y otros componentes secundarios
Administración y registro de scripts
Referencias de servicio web
Localización
Tratamiento de errores
Sintaxis declarativa

Introducción

El ScriptManager control es fundamental para la funcionalidad de Ajax en ASP.NET. El control administra todos los recursos de ASP.NET Ajax en una página. Esto incluye la descarga de scripts de la biblioteca de Microsoft Ajax en el explorador y la coordinación de actualizaciones parciales de páginas habilitadas mediante UpdatePanel controles. Además, el ScriptManager control le permite hacer lo siguiente:

Registre el script compatible con las actualizaciones parciales de páginas. Para administrar las dependencias entre el script y la biblioteca principal, cualquier script que registre se carga después del script de biblioteca de Microsoft Ajax.
Especifique si los scripts de versión o depuración se envían al explorador.
Proporcione acceso a los métodos de servicio web desde el script mediante el registro de servicios web con el ScriptManager control .
Proporcione acceso a los servicios de aplicación de perfil, rol y autenticación ASP.NET desde el script de cliente mediante el registro de estos servicios con el ScriptManager control .
Habilite la presentación específica de la referencia cultural de las funciones Date, Number y String de ECMAScript (JavaScript) en el explorador.
Acceda a los recursos de localización para archivos de script incrustados o para archivos de script independientes mediante la ResourceUICultures propiedad del ScriptReference control .
Registre los controles de servidor que implementan las IExtenderControl interfaces o IScriptControl con el ScriptManager control para que se represente el script requerido por los componentes y comportamientos del cliente.

representación de Partial-Page

La capacidad de una página de ASP.NET para admitir la representación parcial de página se controla mediante los siguientes factores:

La ScriptManager propiedad del EnablePartialRendering control debe ser true (el valor predeterminado).
Debe haber al menos un UpdatePanel control en la página.
La SupportsPartialRendering propiedad debe ser true (el valor predeterminado). Si la SupportsPartialRendering propiedad no se establece explícitamente, su valor se basa en las funcionalidades del explorador.

Puede invalidar el valor de la EnablePartialRendering propiedad en tiempo de ejecución durante o antes del evento de Init la página. Si intenta cambiar esta propiedad después de que se haya producido el evento de Init la página, se producirá una InvalidOperationException excepción.

Cuando se admite la representación parcial de páginas, el control representa el ScriptManager script para habilitar postbacks asincrónicos y actualizaciones parciales de páginas. Las regiones de la página que se van a actualizar se designan mediante UpdatePanel controles . El ScriptManager control controla los postbacks asincrónicos y actualiza solo las regiones de la página que deben actualizarse. Para obtener más información sobre la representación parcial de páginas, consulte Información general sobre la representación de página parcial. Para obtener más información sobre las condiciones que provocan una actualización, vea UpdatePanel Control Overview.

Usar el control ScriptManager con páginas maestras, controles de usuario y otros componentes secundarios

Una página solo puede contener un ScriptManager control en su jerarquía. Para registrar servicios y scripts para páginas anidadas, controles de usuario o componentes cuando la página principal ya tiene un ScriptManager control, use el ScriptManagerProxy control . Para obtener más información, vea Usar el control UpdatePanel con páginas maestras.

Administración y registro de scripts

El ScriptManager control permite registrar el script que se representa como parte de la página. Los ScriptManager métodos de registro de control se pueden dividir en las tres categorías siguientes:

Métodos de registro que garantizan que se mantienen las dependencias de script en la biblioteca de Microsoft Ajax.
Métodos de registro que no dependen de la biblioteca de Microsoft Ajax, pero que son compatibles con UpdatePanel los controles.
Métodos de registro que admiten el trabajo con UpdatePanel controles.

Para obtener más información sobre cómo crear y usar un script de Ajax en ASP.NET, vea Crear script de cliente personalizado mediante la biblioteca de Microsoft Ajax.

Registro de script que depende de la biblioteca de Microsoft Ajax

Puede usar los métodos siguientes para registrar archivos de script de una manera que garantice que se mantienen las dependencias de la biblioteca de Microsoft Ajax.

Método	Definición
RegisterScriptControl	Registra un control de servidor que implementa la IScriptControl interfaz que se usa para definir un objeto de cliente Sys.Component . El ScriptManager control representa el script que admite el objeto de cliente.
RegisterExtenderControl	Registra un control de servidor que implementa la IExtenderControl interfaz que se usa para definir un objeto de cliente Sys.Component . El ScriptManager control representa el script que admite el objeto de cliente.

Registro de scripts compatibles Partial-Page Update

Puede usar los métodos siguientes para registrar archivos de script que no dependen de la biblioteca de Microsoft Ajax, pero que son compatibles con UpdatePanel los controles. Estos métodos corresponden a métodos similares del ClientScriptManager control. Si va a representar el script para su uso dentro de un UpdatePanel control, asegúrese de llamar a los métodos del ScriptManager control.

Método	Definición
RegisterArrayDeclaration	Agrega un valor a una matriz de JavaScript. Si la matriz no existe, se crea.
RegisterClientScriptBlock	Representa un `script` elemento después de la etiqueta de apertura `<form>` de la página. El script se especifica como un parámetro de cadena.
RegisterClientScriptInclude	Representa un `script` elemento después de la etiqueta de apertura `<form>` de la página. El contenido del script se especifica estableciendo el `src` atributo en una dirección URL que apunta a un archivo de script.
RegisterClientScriptResource	Representa un `script` elemento después de la etiqueta de apertura `<form>` de la página. El contenido del script se especifica con un nombre de recurso en un ensamblado. El `src` atributo se rellena automáticamente con una dirección URL mediante una llamada a un controlador HTTP que recupera el script con nombre del ensamblado.
RegisterExpandoAttribute	Representa un par de atributos de nombre/valor personalizado (un expando) en el marcado de un control especificado.
RegisterHiddenField	Representa un campo oculto.
RegisterOnSubmitStatement	Registra un script que se ejecuta en respuesta al `form` evento del `submit` elemento. El `onSubmit` atributo hace referencia al script especificado.
RegisterStartupScript	Representa un bloque de script de inicio justo antes de la etiqueta de cierre `</form>` de la página. El script que se va a representar se especifica como un parámetro de cadena.

Al registrar métodos, se especifica un par de tipos y claves para ese script. Si ya se ha registrado un script con el mismo tipo o par de claves, no se registra un nuevo script. Del mismo modo, si registra un script con un par de nombre de recurso o tipo que ya existe, el script elemento que hace referencia al recurso no se vuelve a agregar. Al registrar un atributo expando de un atributo registrado anteriormente, se produce una excepción. Se permite el registro duplicado de valores de matriz.

Al llamar al RegisterClientScriptInclude método o RegisterClientScriptResource , evite registrar el script que ejecuta funciones insertadas. En su lugar, registre el script que contiene definiciones de función como controladores de eventos o definiciones de clase personalizadas para la aplicación.

Métodos de registro para controles UpdatePanel

Puede usar los métodos siguientes para personalizar las actualizaciones parciales de página al usar UpdatePanel controles.

Método	Definición
RegisterAsyncPostBackControl	Registra un control como desencadenador de postbacks asincrónicos.
RegisterDataItem	Envía datos personalizados a los controles durante la representación parcial de la página.
RegisterDispose	Registra un script dispose para un control que está dentro de un UpdatePanel control . Se ejecuta el script cuando el control UpdatePanel se actualiza o elimina. El método dispose se usa para los componentes cliente que forman parte de la biblioteca de Microsoft Ajax y que tienen que liberar recursos cuando ya no se usa un componente.
RegisterPostBackControl	Registra un control como desencadenador para un postback completo. Este método se usa para los controles dentro de un UpdatePanel control que, de lo contrario, realizaría postbacks asincrónicos.

Referencias de servicio web

Puede registrar un servicio web al que se va a llamar desde el script de cliente creando un ServiceReference objeto y agregándolo a la Services colección del ScriptManager control. ASP.NET genera un objeto proxy de cliente para cada ServiceReference objeto de la Services colección. Puede agregar ServiceReference objetos a la Services colección mediante programación para registrar servicios web en tiempo de ejecución.

Para obtener más información sobre cómo acceder a los servicios web en el script, vea Exposing Web Services to Client Script in ASP.NET AJAX and Calling Web Services from Client Script in ASP.NET AJAX.

Localización

El ScriptManager control genera referencias en la página representada que apuntan a los archivos de script localizados adecuados, que son archivos de script incrustados en ensamblados o archivos de script independientes.

Cuando la EnableScriptLocalization propiedad se establece trueen , el ScriptManager control recupera recursos localizados (como cadenas localizadas) para la referencia cultural actual, si existen. El ScriptManager control proporciona la siguiente funcionalidad para usar recursos localizados:

Archivos de script incrustados en un ensamblado. El ScriptManager control determina qué archivo de script de referencia cultural o de reserva específica de la referencia cultural se va a enviar al explorador. Para ello, se usa el atributo de ensamblado específico NeutralResourcesLanguageAttribute de la referencia cultural, los recursos empaquetados con el ensamblado y la referencia cultural de la interfaz de usuario del explorador (si existe).
Archivos de script independientes. El ScriptManager control define la lista de referencias culturales de la interfaz de usuario que se admiten mediante la ResourceUICultures propiedad del ScriptReference objeto .
En modo de depuración. El ScriptManager control intenta representar un archivo de script específico de la referencia cultural que contiene información de depuración. Por ejemplo, si la página está en modo de depuración y la referencia cultural actual se establece en en-MX, el control representa un archivo de script que tiene un nombre como scriptname.en-MX.debug.js, si el archivo existe. Si el archivo no existe, se representa el archivo de depuración de la referencia cultural de reserva adecuada.

Para obtener más información sobre cómo localizar recursos, vea Información general sobre la localización de recursos para bibliotecas de componentes.

Tratamiento de errores

Cuando se produce un error de página durante los postbacks asincrónicos, se genera el AsyncPostBackError evento . La forma en que se envían errores en el servidor al cliente depende de la AllowCustomErrorsRedirect propiedad, la AsyncPostBackErrorMessage propiedad y la sección de errores personalizados del archivo Web.config. Para obtener más información, vea Customizing Error Handling for UpdatePanel Controls.

Sintaxis declarativa

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

Inicializa una nueva instancia de la clase ScriptManager.

Propiedades

Adapter	Obtiene el adaptador específico del explorador para el control. (Heredado de Control)
AjaxFrameworkAssembly	Obtiene el ensamblado de marco de Ajax que usan los componentes de la página.
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.
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.
AppRelativeTemplateSourceDirectory	Obtiene o establece el directorio virtual relativo a la aplicación del objeto Page o el objeto UserControl que contiene este control. (Heredado de Control)
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.
AsyncPostBackSourceElementID	Obtiene el identificador único del control que produjo el postback asincrónico.
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.
AuthenticationService	Obtiene el objeto AuthenticationServiceManager asociado a la instancia de ScriptManager actual.
BindingContainer	Obtiene el control que contiene el enlace de datos de este control. (Heredado de Control)
ChildControlsCreated	Obtiene un valor que indica si se han creado controles secundarios del control de servidor. (Heredado de Control)
ClientID	Obtiene el id. de control para marcado HTML que se genera por ASP.NET. (Heredado de Control)
ClientIDMode	Obtiene o establece el algoritmo que se utiliza para generar el valor de la propiedad ClientID. (Heredado de Control)
ClientIDSeparator	Obtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID. (Heredado de Control)
ClientNavigateHandler	Obtiene o establece el nombre del método que controla el evento Sys.Application.navigate en el cliente.
CompositeScript	Obtiene una referencia al script compuesto que admite la página web.
Context	Obtiene el objeto HttpContext asociado al control de servidor para la solicitud Web actual. (Heredado de Control)
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. (Heredado de Control)
DataItemContainer	Obtiene una referencia al contenedor de nomenclatura si este implementa IDataItemContainer. (Heredado de Control)
DataKeysContainer	Obtiene una referencia al contenedor de nomenclatura si este implementa IDataKeysControl. (Heredado de Control)
DesignMode	Obtiene un valor que indica si se está utilizando un control en una superficie de diseño. (Heredado de Control)
EmptyPageUrl	Obtiene o establece una dirección URL en una página web en blanco.
EnableCdn	Determina si la página actual carga referencias de script de cliente desde rutas de acceso CDN (Content Delivery Network).
EnableCdnFallback	Habilita la copia local de un script para cargar en caso de que la CDN (Red de entrega de contenido) no esté disponible.
EnableHistory	Obtiene o establece un valor que indica si la página web admite la administración de los puntos de historial.
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.
EnablePartialRendering	Obtiene o establece un valor que habilita la representación parcial de una página, lo que, a su vez, permite actualizar regiones de la página individualmente mediante el uso de controles UpdatePanel.
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.
EnableScriptLocalization	Obtiene o establece un valor que indica si el control ScriptManager representa versiones localizadas de archivos de script.
EnableSecureHistoryState	Obtiene o establece un valor que indica si se debe cifrar la cadena de estado del historial.
EnableTheming	Obtiene o establece un valor que indica si los temas se aplican a este control. (Heredado de Control)
EnableViewState	Obtiene o establece un valor que indica si el control de servidor conserva su estado de vista, así como el estado de vista de los controles secundarios que contiene, al cliente solicitante. (Heredado de Control)
Events	Obtiene una lista de delegados de controladores de eventos del control. Esta propiedad es de sólo lectura. (Heredado de Control)
HasChildViewState	Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen guardada alguna configuración del estado de vista. (Heredado de Control)
ID	Obtiene o establece el identificador de programación asignado al control de servidor. (Heredado de Control)
IdSeparator	Obtiene el carácter utilizado para separar los identificadores de control. (Heredado de Control)
IsChildControlStateCleared	Obtiene un valor que indica si los controles que se encuentran en este control tienen estado de control. (Heredado de Control)
IsDebuggingEnabled	Obtiene un valor que indica si se representarán las versiones de depuración de las bibliotecas de scripts de cliente.
IsInAsyncPostBack	Obtiene un valor que indica si el postback actual se ejecuta en modo de representación parcial.
IsNavigating	Obtiene un valor que indica si actualmente se controla un evento Navigate.
IsTrackingViewState	Obtiene un valor que indica si el control de servidor está guardando los cambios realizados en su estado de vista. (Heredado de Control)
IsViewStateEnabled	Obtiene un valor que indica si el estado de vista está habilitado para este control. (Heredado de Control)
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.
LoadViewStateByID	Obtiene un valor que indica si el control participa en la carga de su estado de vista mediante ID en lugar de índice. (Heredado de Control)
NamingContainer	Obtiene una referencia al contenedor de nomenclatura del control de servidor, que crea un espacio de nombres único para diferenciar los distintos controles de servidor que tienen el mismo valor para la propiedad ID. (Heredado de Control)
Page	Obtiene una referencia a la instancia Page que contiene el control de servidor. (Heredado de Control)
Parent	Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página. (Heredado de Control)
ProfileService	Obtiene el objeto ProfileServiceManager asociado a la instancia de ScriptManager actual.
RenderingCompatibility	Obtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados. (Heredado de Control)
RoleService	Obtiene el objeto RoleServiceManager asociado a la instancia de ScriptManager actual.
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.
ScriptPath	Obsoletos. Obtiene o establece la ruta de acceso raíz de la ubicación que se usa para compilar las rutas de acceso a los archivos de script personalizados y archivos de script Ajax de ASP.NET.
ScriptResourceMapping	Obtiene un objeto ScriptResourceMapping.
Scripts	Obtiene un objeto ScriptReferenceCollection que contiene los objetos ScriptReference, cada uno de los cuales representa un archivo de script representado en el cliente.
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.
Site	Obtiene información sobre el contenedor en que se encuentra el control actual cuando se representa en una superficie de diseño. (Heredado de Control)
SkinID	Obtiene o establece la máscara que se aplica al control. (Heredado de Control)
SupportsPartialRendering	Obtiene un valor que indica si el cliente admite la representación parcial de página.
TemplateControl	Obtiene o establece una referencia a la plantilla que contiene este control. (Heredado de Control)
TemplateSourceDirectory	Obtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual. (Heredado de Control)
UniqueID	Obtiene el identificador único calificado jerárquicamente para el control de servidor. (Heredado de Control)
ValidateRequestMode	Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el explorador para valores potencialmente peligrosos. (Heredado de Control)
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. (Heredado de Control)
ViewStateIgnoresCase	Obtiene un valor que indica si el objeto StateBag no distingue mayúsculas de minúsculas. (Heredado de Control)
ViewStateMode	Obtiene o establece el modo del estado de vista de este control. (Heredado de Control)
Visible	Invalida la propiedad Visible heredada de la clase Control base para evitar establecer este valor.

Métodos

AddedControl(Control, Int32)	Se llama después de agregar un control secundario a la colección Controls del objeto Control. (Heredado de Control)
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.
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.
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.
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. (Heredado de Control)
ApplyStyleSheetSkin(Page)	Aplica al control las propiedades de estilo definidas en la hoja de estilos de la página. (Heredado de Control)
BeginRenderTracing(TextWriter, Object)	Comienza el seguimiento en tiempo de diseño de los datos de representación. (Heredado de Control)
BuildProfileTree(String, Boolean)	Recopila información sobre el control de servidor y la pasa a la propiedad Trace para que se muestre cuando está habilitada la traza de la página. (Heredado de Control)
ClearCachedClientID()	Establece en `null` el valor de ClientID almacenado en caché. (Heredado de Control)
ClearChildControlState()	Elimina la información sobre el estado de control de los controles secundarios del control de servidor. (Heredado de Control)
ClearChildState()	Elimina la información sobre el estado de vista y el estado de control de los controles secundarios del control de servidor. (Heredado de Control)
ClearChildViewState()	Elimina la información sobre el estado de vista de todos los controles secundarios del control de servidor. (Heredado de Control)
ClearEffectiveClientIDMode()	Establece la propiedad ClientIDMode de la instancia del control actual y de cualquier control secundario en Inherit. (Heredado de Control)
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. (Heredado de Control)
CreateControlCollection()	Crea un nuevo objeto ControlCollection que contendrá los controles secundarios (de literal y servidor) del control de servidor. (Heredado de Control)
DataBind()	Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios. (Heredado de Control)
DataBind(Boolean)	Enlaza un origen de datos al control de servidor que se ha invocado y a todos sus controles secundarios con una opción para generar el evento DataBinding. (Heredado de Control)
DataBindChildren()	Enlaza un origen de datos a los controles secundarios del control de servidor. (Heredado de Control)
Dispose()	Habilita un control de servidor para que realice la limpieza final antes de que se libere de la memoria. (Heredado de Control)
EndRenderTracing(TextWriter, Object)	Finaliza el seguimiento en tiempo de diseño de los datos de representación. (Heredado de Control)
EnsureChildControls()	Determina si el control de servidor contiene controles secundarios. Si no tiene controles secundarios, los crea. (Heredado de Control)
EnsureID()	Crea un identificador para controles que no tiene un identificador asignado. (Heredado de Control)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
FindControl(String)	Busca un control de servidor con el parámetro `id` especificado en el contenedor de nomenclatura actual. (Heredado de Control)
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. Esta versión del método FindControl no se debe reemplazar. (Heredado de Control)
Focus()	Establece el foco de entrada en un control. (Heredado de Control)
GetCurrent(Page)	Obtiene la instancia de ScriptManager para un objeto Page dado.
GetDesignModeState()	Obtiene datos en tiempo de diseño para un control. (Heredado de Control)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetRegisteredArrayDeclarations()	Recupera una colección de solo lectura de las declaraciones de matriz de ECMAScript (JavaScript) que se registraron anteriormente con el objeto Page.
GetRegisteredClientScriptBlocks()	Recupera una colección de solo lectura de los bloques de script de cliente que se registraron anteriormente con el control ScriptManager.
GetRegisteredDisposeScripts()	Recupera una colección de solo lectura de los scripts `dispose` que se registraron anteriormente con el objeto Page.
GetRegisteredExpandoAttributes()	Recupera una colección de solo lectura de atributos personalizados (expando) que se registraron anteriormente con el objeto Page.
GetRegisteredHiddenFields()	Recupera una colección de solo lectura de los campos ocultos que se registraron anteriormente con el objeto Page.
GetRegisteredOnSubmitStatements()	Recupera una colección de solo lectura de las instrucciones `onsubmit` que se registraron anteriormente con el objeto Page.
GetRegisteredStartupScripts()	Recupera una colección de solo lectura de los scripts de inicio que se registraron anteriormente con el objeto Page.
GetRouteUrl(Object)	Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Heredado de Control)
GetRouteUrl(RouteValueDictionary)	Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Heredado de Control)
GetRouteUrl(String, Object)	Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta. (Heredado de Control)
GetRouteUrl(String, RouteValueDictionary)	Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta. (Heredado de Control)
GetStateString()	Recupera una cadena que contiene pares clave-valor que representan el estado de la página web.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetUniqueIDRelativeTo(Control)	Devuelve la parte correspondiente al prefijo de la propiedad UniqueID del control especificado. (Heredado de Control)
HasControls()	Determina si el control de servidor contiene controles secundarios. (Heredado de Control)
HasEvents()	Devuelve un valor que indica si se registran eventos para el control o los controles secundarios. (Heredado de Control)
IsLiteralContent()	Determina si el control de servidor alberga únicamente contenido literal. (Heredado de Control)
LoadControlState(Object)	Restaura información de estado de control de una solicitud de página anterior guardada por el método SaveControlState(). (Heredado de Control)
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.
LoadViewState(Object)	Restaura la información de estado de vista de una solicitud de página anterior guardada por el método SaveViewState(). (Heredado de Control)
MapPathSecure(String)	Recupera la ruta de acceso física a la que se asigna una ruta de acceso virtual, absoluta o relativa. (Heredado de Control)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnAsyncPostBackError(AsyncPostBackErrorEventArgs)	Genera el evento AsyncPostBackError.
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. (Heredado de Control)
OnDataBinding(EventArgs)	Genera el evento DataBinding. (Heredado de Control)
OnInit(EventArgs)	Provoca el evento Init y comprueba que haya tan solo un control ScriptManager en la página.
OnLoad(EventArgs)	Genera el evento Load. (Heredado de Control)
OnPreRender(EventArgs)	Provoca el evento PreRender y registra los archivos y servicios de script para las actualizaciones parciales de página.
OnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs)	Genera el evento ResolveCompositeScriptReference.
OnResolveScriptReference(ScriptReferenceEventArgs)	Provoca el evento ResolveScriptReference para cada referencia de script administrada por el control ScriptManager.
OnUnload(EventArgs)	Genera el evento Unload. (Heredado de Control)
OpenFile(String)	Obtiene un objeto Stream utilizado para leer un archivo. (Heredado de Control)
RaiseBubbleEvent(Object, EventArgs)	Asigna los orígenes del evento y su información al control principal del control. (Heredado de Control)
RaisePostBackEvent(String)	Procesa un evento de postback que genera el control ScriptManager y carga el estado del historial de la página web.
RaisePostDataChangedEvent()	Genera eventos para el control ScriptManager cuando devuelve datos al servidor.
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.
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.
RegisterAsyncPostBackControl(Control)	Registra un control como desencadenador de postbacks asincrónicos.
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.
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.
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.
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.
RegisterClientScriptResource(Control, Type, String)	Registra scripts 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.
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.
RegisterDataItem(Control, String)	Envía datos personalizados a un control durante la representación parcial de la página.
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 de notación de objetos JavaScript (JSON).
RegisterDispose(Control, String)	Registra un script `dispose` para un control que está dentro de un control UpdatePanel. Se ejecuta el script cuando el control UpdatePanel se actualiza o elimina.
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.
RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control)	Registra un control extensor con la instancia de ScriptManager actual.
RegisterHiddenField(Control, String, String)	Registra un campo oculto con el control ScriptManager para un control que está dentro de un control UpdatePanel.
RegisterHiddenField(Page, String, String)	Registra un campo oculto con el control ScriptManager durante cada postback asincrónico.
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.
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.
RegisterOnSubmitStatement(Control, Type, String, String)	Registra código ECMAScript (JavaScript) con el control ScriptManager para un control que se usa con un control UpdatePanel que se ejecuta cuando se envía el formulario.
RegisterOnSubmitStatement(Page, Type, String, String)	Registra código ECMAScript (JavaScript) con el control ScriptManager para un control que se usa con un control UpdatePanel que se ejecuta cuando se envía el formulario.
RegisterPostBackControl(Control)	Registra un control como desencadenador de un postback. Este método se usa para configurar controles de postback que se encuentran dentro de un control UpdatePanel y que, de otro modo, realizarían postbacks asincrónicos.
RegisterScriptControl<TScriptControl>(TScriptControl)	Registra un control de script con la instancia de ScriptManager actual.
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.
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.
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.
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.
RemovedControl(Control)	Se llama después de quitar un control secundario de la colección Controls del objeto Control. (Heredado de Control)
Render(HtmlTextWriter)	Representa el contenido del control ScriptManager en el explorador con el objeto HtmlTextWriter especificado.
RenderChildren(HtmlTextWriter)	Envía el contenido de los elementos secundarios de un control de servidor a un objeto HtmlTextWriter especificado, que escribe el contenido que se va a representar en el cliente. (Heredado de Control)
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. (Heredado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado. (Heredado de Control)
ResolveAdapter()	Obtiene el adaptador de controles que se encarga de representar el control especificado. (Heredado de Control)
ResolveClientUrl(String)	Obtiene una dirección URL que el explorador puede utilizar. (Heredado de Control)
ResolveUrl(String)	Convierte una dirección URL en una que el cliente solicitante pueda utilizar. (Heredado de Control)
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. (Heredado de Control)
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. (Heredado de Control)
SetDesignModeState(IDictionary)	Establece los datos en tiempo de diseño para un control. (Heredado de Control)
SetFocus(Control)	Establece el foco del explorador en el control especificado.
SetFocus(String)	Establece el foco del explorador en el control especificado mediante identificador.
SetRenderMethodDelegate(RenderMethod)	Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal. (Heredado de Control)
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. (Heredado de Control)
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. (Heredado de Control)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
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. Este objeto es accesible a través de la propiedad ViewState. (Heredado de Control)

Eventos

AsyncPostBackError	Se produce cuando hay un error de página durante un postback asincrónico.
DataBinding	Se produce cuando el control de servidor se enlaza a un origen de datos. (Heredado de Control)
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. (Heredado de Control)
Init	Tiene lugar al inicializar el control de servidor, que es el primer paso en su ciclo de vida. (Heredado de Control)
Load	Se produce cuando el control de servidor se carga en el objeto Page. (Heredado de Control)
Navigate	Se produce cuando el usuario hace clic en el botón Atrás o Adelante del explorador.
PreRender	Se produce una vez que se carga el objeto Control, pero antes de su representación. (Heredado de Control)
ResolveCompositeScriptReference	Se produce cuando un script compuesto se registra con el control ScriptManager.
ResolveScriptReference	Se produce cuando un miembro de la colección Scripts se registra con el control ScriptManager.
Unload	Se produce cuando el control de servidor se descarga de la memoria. (Heredado de Control)

Implementaciones de interfaz explícitas

IControlBuilderAccessor.ControlBuilder	Para obtener una descripción de este miembro, vea ControlBuilder. (Heredado de Control)
IControlDesignerAccessor.GetDesignModeState()	Para obtener una descripción de este miembro, vea GetDesignModeState(). (Heredado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Para obtener una descripción de este miembro, vea SetDesignModeState(IDictionary). (Heredado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Para obtener una descripción de este miembro, vea SetOwnerControl(Control). (Heredado de Control)
IControlDesignerAccessor.UserData	Para obtener una descripción de este miembro, vea UserData. (Heredado de Control)
IDataBindingsAccessor.DataBindings	Para obtener una descripción de este miembro, vea DataBindings. (Heredado de Control)
IDataBindingsAccessor.HasDataBindings	Para obtener una descripción de este miembro, vea HasDataBindings. (Heredado de Control)
IExpressionsAccessor.Expressions	Para obtener una descripción de este miembro, vea Expressions. (Heredado de Control)
IExpressionsAccessor.HasExpressions	Para obtener una descripción de este miembro, vea HasExpressions. (Heredado de Control)
IParserAccessor.AddParsedSubObject(Object)	Para obtener una descripción de este miembro, vea AddParsedSubObject(Object). (Heredado de Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)	Para obtener una descripción de este miembro, vea LoadPostData(String, NameValueCollection).
IPostBackDataHandler.RaisePostDataChangedEvent()	Para obtener una descripción de este miembro, vea RaisePostDataChangedEvent().
IPostBackEventHandler.RaisePostBackEvent(String)	Habilita el control ScriptManager para procesar un evento de postback y cargar el estado del historial de la página web.

Métodos de extensión

FindDataSourceControl(Control)	Devuelve el origen de datos que está asociado al control de datos del control especificado.
FindFieldTemplate(Control, String)	Devuelve la plantilla de campo para la columna especificada en el contenedor de nomenclatura del control especificado.
FindMetaTable(Control)	Devuelve el objeto de metatabla para el control de datos contenedor.

Se aplica a

Compartir vía