ScriptManager Clase

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 ASP.NET bibliotecas de scripts de Ajax y archivos de script, representación parcial de páginas y generación de clases de proxy de cliente para servicios web y de aplicaciones.

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 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 propiedad para especificar cómo se usa la AllowCustomErrorsRedirect sección de errores personalizados del archivo Web.config cuando se produce un error durante las actualizaciones parciales de 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>

Globalizar la fecha y hora que se muestran en el explorador

En el ejemplo siguiente se muestra cómo establecer la EnableScriptGlobalization propiedad para que el 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 autoen . 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:

Introduction
representación dePartial-Page
Uso del 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
control 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 permite hacer lo siguiente:

Registre el script compatible con las actualizaciones parciales de la página. Para administrar las dependencias entre el script y la biblioteca principal, cualquier script que registre se carga después del script de la 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 ASP.NET autenticación, rol y servicios de aplicación de perfil desde el script de cliente mediante el registro de estos servicios con el ScriptManager control .
Habilite la visualizació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 controles de servidor que implementen las IExtenderControl interfaces o IScriptControl con el ScriptManager control para que el script requerido por los componentes y comportamientos del cliente se represente.

representación de Partial-Page

La capacidad de una página de ASP.NET para admitir la representación parcial de páginas 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 produce 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ágina. 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 Partial-Page Información general sobre la representación. Para obtener más información sobre las condiciones que provocan una actualización, vea Información general sobre el control UpdatePanel.

Uso del 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, a continuación, 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 el 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 mantengan 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 con la actualización de Partial-Page

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 usarlo 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. De forma similar, si registra un script con un par de nombre de tipo o recurso 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 para postbacks asincrónicos.
RegisterDataItem	Envía datos personalizados a controles durante la representación parcial de páginas.
RegisterDispose	Registra un script dispose para un control que está dentro de un UpdatePanel control . El script se ejecuta cuando el UpdatePanel control 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 obtener acceso a los servicios web en el script, vea Exponer servicios web al script de cliente en ASP.NET AJAX y Llamar a servicios web desde el script de cliente en ASP.NET AJAX.

Localization

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 específico de la referencia cultural o de reserva 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, consulte 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 los errores del servidor se envían 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 Personalización del control de errores para controles UpdatePanel.

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

Nombre	Description
ScriptManager()	Inicializa una nueva instancia de la clase ScriptManager.

Propiedades

Nombre	Description
Adapter	Obtiene el adaptador específico del explorador para el control . (Heredado de Control)
AjaxFrameworkAssembly	Obtiene el ensamblado del marco de Ajax que usan los componentes de la página.
AjaxFrameworkMode	Obtiene o establece un valor que especifica cómo se incluirán los scripts de cliente de la biblioteca cliente de Microsoft Ajax en el cliente.
AllowCustomErrorsRedirect	Obtiene o establece un valor que determina si la sección de errores personalizados del archivo Web.config se usa durante un error en un postback asincrónico.
AppRelativeTemplateSourceDirectory	Obtiene o establece el directorio virtual relativo a la Page aplicación del objeto o 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 una postback asincrónica.
AsyncPostBackSourceElementID	Obtiene el identificador único del control que provocó el postback asincrónico.
AsyncPostBackTimeout	Obtiene o establece un valor que indica el tiempo, en segundos, antes de que se agote el tiempo de espera de postback asincrónico si no se recibe ninguna respuesta.
AuthenticationService	Obtiene el AuthenticationServiceManager objeto asociado a la instancia actual ScriptManager .
BindingContainer	Obtiene el control que contiene el enlace de datos de este control. (Heredado de Control)
ChildControlsCreated	Obtiene un valor que indica si se han creado los controles secundarios del control de servidor. (Heredado de Control)
ClientID	Obtiene el identificador de control para el marcado HTML generado por ASP.NET. (Heredado de Control)
ClientIDMode	Obtiene o establece el algoritmo que se usa para generar el valor de la ClientID propiedad . (Heredado de Control)
ClientIDSeparator	Obtiene un valor de carácter que representa el carácter separador utilizado en la ClientID propiedad . (Heredado de Control)
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 HttpContext objeto asociado al control de servidor para la solicitud web actual. (Heredado de Control)
Controls	Obtiene un ControlCollection objeto que representa los controles secundarios de un control de servidor especificado en la jerarquía de la interfaz de usuario. (Heredado de Control)
DataItemContainer	Obtiene una referencia al contenedor de nomenclatura si el contenedor de nomenclatura implementa IDataItemContainer. (Heredado de Control)
DataKeysContainer	Obtiene una referencia al contenedor de nomenclatura si el contenedor de nomenclatura implementa IDataKeysControl. (Heredado de Control)
DesignMode	Obtiene un valor que indica si se usa un control en una superficie de diseño. (Heredado de Control)
EmptyPageUrl	Obtiene o establece una dirección URL en una página web en blanco.
EnableCdn	Determina si la página actual carga las referencias de script de cliente desde rutas de acceso de CDN (Content Delivery Network).
EnableCdnFallback	Permite que la copia local de un script se cargue en caso de que la red CDN (Content Delivery Network) no esté disponible.
EnableHistory	Obtiene o establece un valor que indica si la página web admite la administración de puntos de historial.
EnablePageMethods	Obtiene o establece un valor que indica si se puede llamar a los métodos de página estáticos públicos de una página ASP.NET desde el script de cliente.
EnablePartialRendering	Obtiene o establece un valor que permite la representación parcial de una página, que a su vez permite actualizar las regiones de la página individualmente mediante UpdatePanel controles.
EnableScriptGlobalization	Obtiene o establece un valor que indica si el control representa el ScriptManager script que admite el análisis y el formato de información específica de la referencia cultural.
EnableScriptLocalization	Obtiene o establece un valor que indica si el ScriptManager control representa versiones localizadas de archivos de script.
EnableSecureHistoryState	Obtiene o establece un valor que indica si se va a 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 y el estado de vista de los controles secundarios que contiene, al cliente solicitante. (Heredado de Control)
Events	Obtiene una lista de delegados del controlador de eventos para el control . Esta propiedad es de solo lectura. (Heredado de Control)
HasChildViewState	Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen cualquier configuración de estado de vista guardada. (Heredado de Control)
ID	Obtiene o establece el identificador de programación asignado al control de servidor. (Heredado de Control)
IdSeparator	Obtiene el carácter usado para separar los identificadores de control. (Heredado de Control)
IsChildControlStateCleared	Obtiene un valor que indica si los controles contenidos en este control tienen estado de control. (Heredado de Control)
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 está ejecutando en modo de representación parcial.
IsNavigating	Obtiene un valor que indica si Navigate un evento se está controlando actualmente.
IsTrackingViewState	Obtiene un valor que indica si el control de servidor guarda los cambios en su estado de vista. (Heredado de Control)
IsViewStateEnabled	Obtiene un valor que indica si el estado de vista está habilitado para este control. (Heredado de Control)
LoadScriptsBeforeUI	Obtiene o establece un valor que indica si los scripts se cargan antes o después del marcado de la interfaz de usuario de página.
LoadViewStateByID	Obtiene un valor que indica si el control participa en la carga de su estado de vista en ID lugar del índice. (Heredado de Control)
NamingContainer	Obtiene una referencia al contenedor de nomenclatura del control de servidor, que crea un espacio de nombres único para diferenciar entre los controles de servidor con el mismo ID valor de propiedad. (Heredado de Control)
Page	Obtiene una referencia a la Page instancia que contiene el control de servidor. (Heredado de Control)
Parent	Obtiene una referencia al control primario del control de servidor en la jerarquía de controles de página. (Heredado de Control)
ProfileService	Obtiene el ProfileServiceManager objeto asociado a la instancia actual ScriptManager .
RenderingCompatibility	Obtiene un valor que especifica la versión de ASP.NET con la que se representará HTML. (Heredado de Control)
RoleService	Obtiene el RoleServiceManager objeto asociado a la instancia actual ScriptManager .
ScriptMode	Obtiene o establece un valor que especifica si se representan las versiones de depuración o versión 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 para ASP.NET archivos de script personalizados y Ajax.
ScriptResourceMapping	Obtiene un ScriptResourceMapping objeto .
Scripts	Obtiene un ScriptReferenceCollection objeto que contiene los objetos , cada uno de los ScriptReference cuales representa un archivo de script representado al cliente.
Services	Obtiene un ServiceReferenceCollection objeto que contiene un ServiceReference objeto para cada servicio web que ASP.NET expone en el cliente para la funcionalidad de Ajax.
Site	Obtiene información sobre el contenedor que hospeda el control actual cuando se representa en una superficie de diseño. (Heredado de Control)
SkinID	Obtiene o establece la máscara que se va a aplicar al control. (Heredado de Control)
SupportsPartialRendering	Obtiene un valor que indica si el cliente admite la representación parcial de páginas.
TemplateControl	Obtiene o establece una referencia a la plantilla que contiene este control. (Heredado de Control)
TemplateSourceDirectory	Obtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual. (Heredado de Control)
UniqueID	Obtiene el identificador único calificado jerárquicamente para el control de servidor. (Heredado de Control)
ValidateRequestMode	Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el explorador para detectar valores potencialmente peligrosos. (Heredado de Control)
ViewState	Obtiene un diccionario de información de estado que permite guardar y restaurar el estado de vista de un control de servidor en varias solicitudes para la misma página. (Heredado de Control)
ViewStateIgnoresCase	Obtiene un valor que indica si el StateBag objeto no distingue mayúsculas de minúsculas. (Heredado de Control)
ViewStateMode	Obtiene o establece el modo de estado de vista de este control. (Heredado de Control)
Visible	Invalida la Visible propiedad que se hereda de la clase base Control para evitar establecer este valor.

Métodos

Nombre	Description
AddedControl(Control, Int32)	Se llama después de agregar un control secundario a la Controls colección del Control objeto . (Heredado de Control)
AddHistoryPoint(NameValueCollection, String)	Crea un punto de historial y lo agrega a la pila del historial del explorador mediante la colección de datos de estado y el título de estado especificados.
AddHistoryPoint(String, String, String)	Crea un punto de 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.
AddHistoryPoint(String, String)	Crea un punto de historial y lo agrega a la pila del historial del explorador mediante la clave de estado y el valor de estado especificados.
AddParsedSubObject(Object)	Notifica al control de servidor que se ha analizado un elemento, ya sea XML o HTML, y agrega el elemento al objeto del control de ControlCollection servidor. (Heredado de Control)
ApplyStyleSheetSkin(Page)	Aplica las propiedades de estilo definidas en la hoja de estilos de página al control . (Heredado de Control)
BeginRenderTracing(TextWriter, Object)	Comienza el seguimiento en tiempo de diseño de los datos de representación. (Heredado de Control)
BuildProfileTree(String, Boolean)	Recopila información sobre el control de servidor y la entrega a la Trace propiedad que se va a mostrar cuando el seguimiento está habilitado para la página. (Heredado de Control)
ClearCachedClientID()	Establece el valor `null`almacenado en caché en ClientID . (Heredado de Control)
ClearChildControlState()	Elimina la información de estado de control de los controles secundarios del control de servidor. (Heredado de Control)
ClearChildState()	Elimina la información de estado de vista y estado de control de todos los controles secundarios del control de servidor. (Heredado de Control)
ClearChildViewState()	Elimina la información de estado de vista de todos los controles secundarios del control de servidor. (Heredado de Control)
ClearEffectiveClientIDMode()	Establece la ClientIDMode propiedad de la instancia de control actual y de cualquier control secundario en Inherit. (Heredado de Control)
CreateChildControls()	Llamado por el marco de ASP.NET página para notificar a los controles de servidor que usan la implementación basada en composición para crear los controles secundarios que contengan como preparación para la publicación o representación. (Heredado de Control)
CreateControlCollection()	Crea un nuevo ControlCollection objeto para contener los controles secundarios (literal y servidor) del control de servidor. (Heredado de Control)
DataBind()	Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios. (Heredado de Control)
DataBind(Boolean)	Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios con una opción para generar el DataBinding evento. (Heredado de Control)
DataBindChildren()	Enlaza un origen de datos a los controles secundarios del control de servidor. (Heredado de Control)
Dispose()	Permite que un control de servidor realice la limpieza final antes de liberarse de la memoria. (Heredado de Control)
EndRenderTracing(TextWriter, Object)	Finaliza el seguimiento en tiempo de diseño de los datos de representación. (Heredado de Control)
EnsureChildControls()	Determina si el control de servidor contiene controles secundarios. Si no es así, crea controles secundarios. (Heredado de Control)
EnsureID()	Crea un identificador para los controles que no tienen asignado un identificador. (Heredado de Control)
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
FindControl(String, Int32)	Busca en el contenedor de nomenclatura actual un control de servidor con el especificado `id` y un entero, especificado en el `pathOffset` parámetro , que ayuda en la búsqueda. No debe invalidar esta versión del FindControl método. (Heredado de Control)
FindControl(String)	Busca en el contenedor de nomenclatura actual un control de servidor con el parámetro especificado `id` . (Heredado de Control)
Focus()	Establece el foco de entrada en un control. (Heredado de Control)
GetCurrent(Page)	Obtiene la ScriptManager instancia de un objeto determinado Page .
GetDesignModeState()	Obtiene los datos en tiempo de diseño de un control. (Heredado de Control)
GetHashCode()	Actúa como función hash predeterminada. (Heredado de Object)
GetRegisteredArrayDeclarations()	Recupera una colección de solo lectura de declaraciones de matriz ECMAScript (JavaScript) que se registraron anteriormente con el Page objeto .
GetRegisteredClientScriptBlocks()	Recupera una colección de solo lectura de bloques de script de cliente que se registraron anteriormente con el ScriptManager control .
GetRegisteredDisposeScripts()	Recupera una colección de solo lectura de `dispose` scripts que se registraron anteriormente con el Page objeto .
GetRegisteredExpandoAttributes()	Recupera una colección de solo lectura de atributos personalizados (expando) que se registraron anteriormente con el Page objeto .
GetRegisteredHiddenFields()	Recupera una colección de solo lectura de campos ocultos que se registraron anteriormente con el Page objeto .
GetRegisteredOnSubmitStatements()	Recupera una colección de solo lectura de `onsubmit` instrucciones registradas anteriormente con el Page objeto .
GetRegisteredStartupScripts()	Recupera una colección de solo lectura de scripts de inicio que se registraron anteriormente con el Page objeto .
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 prefijo de la UniqueID propiedad del control especificado. (Heredado de Control)
HasControls()	Determina si el control de servidor contiene controles secundarios. (Heredado de Control)
HasEvents()	Devuelve un valor que indica si los eventos están registrados para el control o para los controles secundarios. (Heredado de Control)
IsLiteralContent()	Determina si el control de servidor contiene solo contenido literal. (Heredado de Control)
LoadControlState(Object)	Restaura la información de estado de control de una solicitud de página anterior guardada por el SaveControlState() método . (Heredado de Control)
LoadPostData(String, NameValueCollection)	Lee los datos del formulario que se publican desde el explorador al servidor 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 SaveViewState() método . (Heredado de Control)
MapPathSecure(String)	Recupera la ruta de acceso física a la que se asigna una ruta de acceso virtual, absoluta o relativa. (Heredado de Control)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
OnAsyncPostBackError(AsyncPostBackErrorEventArgs)	Genera el evento AsyncPostBackError.
OnBubbleEvent(Object, EventArgs)	Determina si el evento del control de servidor se pasa a la jerarquía de controles de servidor de interfaz de usuario de la página. (Heredado de Control)
OnDataBinding(EventArgs)	Genera el evento DataBinding. (Heredado de Control)
OnInit(EventArgs)	Genera el Init evento y se asegura de que solo exista un ScriptManager control en la página.
OnLoad(EventArgs)	Genera el evento Load. (Heredado de Control)
OnPreRender(EventArgs)	Genera el PreRender evento y registra archivos de script y servicios para actualizaciones parciales de páginas.
OnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs)	Genera el evento ResolveCompositeScriptReference.
OnResolveScriptReference(ScriptReferenceEventArgs)	Genera el ResolveScriptReference evento para cada referencia de script administrada por el ScriptManager control .
OnUnload(EventArgs)	Genera el evento Unload. (Heredado de Control)
OpenFile(String)	Obtiene un objeto Stream que se usa para leer un archivo. (Heredado de Control)
RaiseBubbleEvent(Object, EventArgs)	Asigna cualquier origen del evento y su información al elemento primario del control. (Heredado de Control)
RaisePostBackEvent(String)	Procesa un evento de postback generado por el ScriptManager control y carga el estado del historial de la página web.
RaisePostDataChangedEvent()	Genera eventos para el ScriptManager control cuando se envía al servidor.
RegisterArrayDeclaration(Control, String, String)	Registra una declaración de matriz ECMAScript (JavaScript) con el ScriptManager control para su uso con un control que está dentro de un UpdatePanel control y agrega la matriz a la página.
RegisterArrayDeclaration(Page, String, String)	Registra una declaración de matriz ECMAScript (JavaScript) con el ScriptManager control para su uso con un control que está dentro de un UpdatePanel control y agrega la matriz a la página.
RegisterAsyncPostBackControl(Control)	Registra un control como desencadenador para postbacks asincrónicos.
RegisterClientScriptBlock(Control, Type, String, String, Boolean)	Registra un bloque de script de cliente con el ScriptManager control para su uso con un control que está dentro de un UpdatePanel control 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 ScriptManager control para su uso con un control que está dentro de un UpdatePanel control y, a continuación, agrega el bloque de script a la página.
RegisterClientScriptInclude(Control, Type, String, String)	Registra un archivo de script de cliente con el ScriptManager control para su uso con un control que está dentro de un UpdatePanel control y, a continuación, agrega una referencia de archivo de script a la página.
RegisterClientScriptInclude(Page, Type, String, String)	Registra el script de cliente con el ScriptManager control cada vez que se produce un postback asincrónico y, a continuación, agrega una referencia de archivo de script a la página.
RegisterClientScriptResource(Control, Type, String)	Registra el script de cliente incrustado en un ensamblado con el ScriptManager control para usarlo con un control que participa en la representación parcial de páginas.
RegisterClientScriptResource(Page, Type, String)	Registra un archivo de script de cliente incrustado en un ensamblado con el ScriptManager control cada vez que se produce una devolución de entrada.
RegisterDataItem(Control, String, Boolean)	Envía datos personalizados a un control durante la representación de página parcial e indica si los datos están en formato de notación de objetos JavaScript (JSON).
RegisterDataItem(Control, String)	Envía datos personalizados a un control durante la representación parcial de páginas.
RegisterDispose(Control, String)	Registra un `dispose` script para un control que está dentro de un UpdatePanel control . El script se ejecuta cuando el UpdatePanel control se actualiza o elimina.
RegisterExpandoAttribute(Control, String, String, String, Boolean)	Registra un par nombre-valor con el ScriptManager control como un atributo personalizado (expando) de un control especificado.
RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control)	Registra un control extensor con la instancia actual ScriptManager .
RegisterHiddenField(Control, String, String)	Registra un campo oculto con el ScriptManager control para un control que está dentro de un UpdatePanel control.
RegisterHiddenField(Page, String, String)	Registra un campo oculto con el ScriptManager control durante cada postback asincrónico.
RegisterNamedClientScriptResource(Control, String)	Registra el script de cliente por nombre de recurso incrustado en un ensamblado con el ScriptManager control para su uso con un control que participa en la representación parcial de páginas.
RegisterNamedClientScriptResource(Page, String)	Registra el script de cliente por nombre de recurso incrustado en un ensamblado con el ScriptManager control para su uso con un control que participa en la representación parcial de páginas.
RegisterOnSubmitStatement(Control, Type, String, String)	Registra el código ECMAScript (JavaScript) con el ScriptManager control de un control que se usa con un UpdatePanel control que se ejecuta cuando se envía el formulario.
RegisterOnSubmitStatement(Page, Type, String, String)	Registra el código ECMAScript (JavaScript) con el ScriptManager control de un control que se usa con un UpdatePanel control que se ejecuta cuando se envía el formulario.
RegisterPostBackControl(Control)	Registra un control como desencadenador para un postback. Este método se usa para configurar controles de postback dentro de un UpdatePanel control que, de lo contrario, realizaría postbacks asincrónicos.
RegisterScriptControl<TScriptControl>(TScriptControl)	Registra un control de script con la instancia actual ScriptManager .
RegisterScriptDescriptors(IExtenderControl)	Llama a una ExtenderControl clase para devolver scripts de instancia que se deben representar para admitir el objeto de cliente que representa un control de cliente, un componente o un comportamiento.
RegisterScriptDescriptors(IScriptControl)	Llama a una ScriptControl clase para devolver scripts de instancia que se deben representar para admitir el objeto de cliente que representa un control de cliente, un componente o un comportamiento.
RegisterStartupScript(Control, Type, String, String, Boolean)	Registra un bloque de script de inicio para un control que está dentro de un UpdatePanel control mediante el ScriptManager control 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 ScriptManager control y agrega el bloque de script a la página.
RemovedControl(Control)	Se llama después de quitar un control secundario de la Controls colección del Control objeto . (Heredado de Control)
Render(HtmlTextWriter)	Representa el ScriptManager contenido del control en el explorador mediante el objeto especificado HtmlTextWriter .
RenderChildren(HtmlTextWriter)	Genera el contenido de los elementos secundarios de un control de servidor en un objeto proporcionado HtmlTextWriter , que escribe el contenido que se va a representar en el cliente. (Heredado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Genera contenido de control de servidor en un objeto proporcionado HtmlTextWriter mediante un objeto proporcionado ControlAdapter . (Heredado de Control)
RenderControl(HtmlTextWriter)	Genera contenido de control de servidor en un objeto proporcionado HtmlTextWriter y almacena información de seguimiento sobre el control si el seguimiento está habilitado. (Heredado de Control)
ResolveAdapter()	Obtiene el adaptador de control responsable de representar el control especificado. (Heredado de Control)
ResolveClientUrl(String)	Obtiene una dirección URL que el explorador puede usar. (Heredado de Control)
ResolveUrl(String)	Convierte una dirección URL en una que se pueda usar en el cliente solicitante. (Heredado de Control)
SaveControlState()	Guarda los cambios de estado de control de servidor que se han producido desde el momento en que se devolvió la página al servidor. (Heredado de Control)
SaveViewState()	Guarda los cambios de estado de vista de control de servidor que se han producido desde el momento en que la página se devolvió al servidor. (Heredado de Control)
SetDesignModeState(IDictionary)	Establece los datos en tiempo de diseño de un control. (Heredado de Control)
SetFocus(Control)	Establece el foco del explorador en el control especificado.
SetFocus(String)	Establece el foco del explorador en el control especificado por id.
SetRenderMethodDelegate(RenderMethod)	Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en su control primario. (Heredado de Control)
SetTraceData(Object, Object, Object)	Establece los datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, mediante el objeto rastreado, la clave de datos de seguimiento y el valor de los datos de seguimiento. (Heredado de Control)
SetTraceData(Object, Object)	Establece los datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, mediante la clave de datos de seguimiento y el valor de los datos de seguimiento. (Heredado de Control)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
TrackViewState()	Provoca el seguimiento de los cambios de estado de vista en el control de servidor para que se puedan almacenar en el objeto del control de StateBag servidor. Este objeto es accesible a través de la ViewState propiedad . (Heredado de Control)

Eventos

Nombre	Description
AsyncPostBackError	Se produce cuando se produce un error de página durante una postback asincrónica.
DataBinding	Se produce cuando el control de servidor se enlaza a un origen de datos. (Heredado de Control)
Disposed	Se produce cuando se libera un control de servidor de la memoria, que es la última fase del ciclo de vida del control de servidor cuando se solicita una página de ASP.NET. (Heredado de Control)
Init	Se produce cuando se inicializa el control de servidor, que es el primer paso de su ciclo de vida. (Heredado de Control)
Load	Se produce cuando el control de servidor se carga en el Page objeto . (Heredado de Control)
Navigate	Se produce cuando el usuario hace clic en el botón Atrás o Adelante del explorador.
PreRender	Se produce después de cargar el Control objeto, pero antes de la representación. (Heredado de Control)
ResolveCompositeScriptReference	Se produce cuando se registra un script compuesto con el ScriptManager control .
ResolveScriptReference	Se produce cuando se registra un miembro de la Scripts colección con el ScriptManager control .
Unload	Se produce cuando el control de servidor se descarga de la memoria. (Heredado de Control)

Implementaciones de interfaz explícitas

Nombre	Description
IControlBuilderAccessor.ControlBuilder	Para obtener una descripción de este miembro, vea ControlBuilder. (Heredado de Control)
IControlDesignerAccessor.GetDesignModeState()	Para obtener una descripción de este miembro, vea GetDesignModeState(). (Heredado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Para obtener una descripción de este miembro, vea SetDesignModeState(IDictionary). (Heredado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Para obtener una descripción de este miembro, vea SetOwnerControl(Control). (Heredado de Control)
IControlDesignerAccessor.UserData	Para obtener una descripción de este miembro, vea UserData. (Heredado de Control)
IDataBindingsAccessor.DataBindings	Para obtener una descripción de este miembro, vea DataBindings. (Heredado de Control)
IDataBindingsAccessor.HasDataBindings	Para obtener una descripción de este miembro, vea HasDataBindings. (Heredado de Control)
IExpressionsAccessor.Expressions	Para obtener una descripción de este miembro, vea Expressions. (Heredado de Control)
IExpressionsAccessor.HasExpressions	Para obtener una descripción de este miembro, vea HasExpressions. (Heredado de Control)
IParserAccessor.AddParsedSubObject(Object)	Para obtener una descripción de este miembro, vea AddParsedSubObject(Object). (Heredado de Control)
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)	ScriptManager Permite al control procesar un evento de postback y cargar el estado del historial de la página web.

Métodos de extensión

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

Se aplica a

Consulte también

Comentarios

Resultoulle útil esta páxina?

Compartir por

ScriptManager Clase

Definición

Ejemplos

Comentarios

Introducción

representación de Partial-Page

Uso del control ScriptManager con páginas maestras, controles de usuario y otros componentes secundarios

Administración y registro de scripts

Registro de script que depende de la biblioteca de Microsoft Ajax

Registro de scripts compatibles con la actualización de Partial-Page

Métodos de registro para controles UpdatePanel

Referencias de servicio web

Localization

Tratamiento de errores

Sintaxis declarativa

Constructores

Propiedades

Métodos

Eventos

Implementaciones de interfaz explícitas

Métodos de extensión

Se aplica a

Consulte también

Comentarios