Compartir a través de


ScriptManager.RegisterClientScriptInclude Método

Definición

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.

Sobrecargas

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.

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.

public:
 static void RegisterClientScriptInclude(System::Web::UI::Control ^ control, Type ^ type, System::String ^ key, System::String ^ url);
public static void RegisterClientScriptInclude (System.Web.UI.Control control, Type type, string key, string url);
static member RegisterClientScriptInclude : System.Web.UI.Control * Type * string * string -> unit
Public Shared Sub RegisterClientScriptInclude (control As Control, type As Type, key As String, url As String)

Parámetros

control
Control

Control que registra el archivo de script de cliente.

type
Type

Tipo del archivo de script de cliente. Este parámetro se suele especificar mediante el uso del operador typeof (C#) o GetType (Visual Basic) para recuperar el tipo del control que registra el script.

key
String

Identificador único del archivo de script.

url
String

Dirección URL del archivo de script.

Excepciones

El valor type del archivo de script de cliente es null.

o bien

El control que registra el archivo de script es null.

El control que registra el archivo de script no está en el árbol de controles de la página.

o bien

url es null.

o bien

url está vacía.

Ejemplos

<%@ 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">
    public void Page_Load(Object sender, EventArgs e)
    {
        if (!IsPostBack)
            Calendar1.SelectedDate = DateTime.Today;
        
    }
    protected void Page_PreRender(object sender, EventArgs e)
    {
        ScriptManager.RegisterClientScriptInclude(
            this,
            typeof(Page),
            "AlertScript",
            ResolveClientUrl("~/scripts/script_alertdiv.js"));
    }
    protected void IncrementButton_Click(object sender, EventArgs e)
    {
        Calendar1.SelectedDate = Calendar1.SelectedDate.AddDays(1.0);
    }
    protected void DecrementButton_Click(object sender, EventArgs e)
    {
        Calendar1.SelectedDate = Calendar1.SelectedDate.AddDays(-1.0);
    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>ScriptManager RegisterClientScriptInclude</title>
    <style type="text/css">
    div.MessageStyle
    {
      background-color: Green;
      top: 95%;
      left: 1%;
      position: absolute;
      visibility: hidden;
    }
    </style>
</head>
<body>
    <form id="Form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1"
                               runat="server"/>

            <script type="text/javascript">
            Sys.WebForms.PageRequestManager.instance.add_endRequest(Notify);
            </script>

            <asp:UpdatePanel ID="UpdatePanel1" UpdateMode="Conditional"
                runat="server">
                <ContentTemplate>
                    <asp:Calendar ID="Calendar1" runat="server"/>
                    <br />
                    Change the selected date: 
                    <asp:Button runat="server" ID="DecrementButton" Text="-" OnClick="DecrementButton_Click" />
                    <asp:Button runat="server" ID="IncrementButton" Text="+" OnClick="IncrementButton_Click" />
                </ContentTemplate>
            </asp:UpdatePanel>

            <div id="NotifyDiv" class="MessageStyle">
                Updates are complete.
            </div>
        </div>
    </form>
</body>
</html>
function Notify(sender, arg)
{
    ActivateAlertDiv('visible', 'NotifyDiv');
    setTimeout("ActivateAlertDiv('hidden', 'NotifyDiv')", 1000);
}
function ActivateAlertDiv(visstring, elem)
{
    var adiv = document.getElementById(elem);
    adiv.style.visibility = visstring;
}

Comentarios

El método se usa RegisterClientScriptInclude para registrar un archivo de script de cliente para una página o parte de una página que participa en actualizaciones parciales de páginas. Los archivos de script de cliente registrados mediante este método se envían a la página solo cuando control representa un control que está dentro de un UpdatePanel control que se está actualizando. Para registrar un archivo de script cada vez que se produce un postback asincrónico, use la RegisterClientScriptInclude(Page, Type, String, String) sobrecarga de este método.

Si desea registrar un bloque de script que no pertenece a actualizaciones parciales de páginas y si desea registrar el bloque de script solo una vez durante la representación de página inicial, use el RegisterClientScriptBlock método de la ClientScriptManager clase . Puede obtener una referencia al ClientScriptManager objeto desde la ClientScript propiedad de la página.

El RegisterClientScriptInclude método registra un archivo de script de cliente en la página mediante la representación de un script elemento cuya etiqueta de apertura contiene un src atributo . El url parámetro se usa para establecer el src atributo . Para resolver las direcciones URL, use el ResolveClientUrl método . Este método usa el contexto de la dirección URL a la que se llama para resolver la ruta de acceso.

RegisterClientScriptInclude Los métodos y RegisterClientScriptResource representan archivos de script en el explorador. Si ya se representa un script con el mismo tipo y clave (para un archivo de script) o el mismo tipo y nombre de recurso (para un recurso incrustado), el script no se representa de nuevo.

Consulte también

Se aplica a

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.

public:
 static void RegisterClientScriptInclude(System::Web::UI::Page ^ page, Type ^ type, System::String ^ key, System::String ^ url);
public static void RegisterClientScriptInclude (System.Web.UI.Page page, Type type, string key, string url);
static member RegisterClientScriptInclude : System.Web.UI.Page * Type * string * string -> unit
Public Shared Sub RegisterClientScriptInclude (page As Page, type As Type, key As String, url As String)

Parámetros

page
Page

Objeto de página que registra el archivo de script de cliente.

type
Type

Tipo del archivo de script de cliente. Este parámetro se suele especificar mediante el uso del operador typeof (C#) o GetType (Visual Basic) para recuperar el tipo del control que registra el script.

key
String

Identificador único del archivo de script.

url
String

Dirección URL del archivo de script.

Excepciones

El valor type del archivo de script de cliente es null.

o bien

La página que registra el archivo de script es null.

url es null.

o bien

url está vacía.

Comentarios

Al registrar un archivo de script con este método, el script se representa cada vez que se produce un postback asincrónico. Para registrar un archivo de script para un control que está dentro de un UpdatePanel control, de modo que el script solo se registre cuando se actualice el UpdatePanel control, use la RegisterClientScriptInclude(Control, Type, String, String) sobrecarga de este método.

Si desea registrar un bloque de script que no pertenece a actualizaciones parciales de páginas y si desea registrar el bloque de script solo una vez durante la representación de página inicial, use el RegisterClientScriptBlock método de la ClientScriptManager clase . Puede obtener una referencia al ClientScriptManager objeto desde la ClientScript propiedad de la página.

Consulte también

Se aplica a