ScriptManager.RegisterClientScriptInclude Método

Definição

Espaço de Nomes:
System.Web.UI
Assemblagem:
System.Web.Extensions.dll

Regista um ficheiro de script cliente com o ScriptManager controlo para uso com um controlo que está dentro de um UpdatePanel controlo, e depois adiciona uma referência de ficheiro de script à página.

Sobrecargas

Name Description
RegisterClientScriptInclude(Control, Type, String, String)

Regista um ficheiro de script cliente com o ScriptManager controlo para uso com um controlo que está dentro de um UpdatePanel controlo, e depois adiciona uma referência de ficheiro de script à página.
RegisterClientScriptInclude(Page, Type, String, String)

Regista o script cliente com o ScriptManager controlo sempre que ocorre um postback assíncrono, e depois adiciona uma referência a um ficheiro de script à página.

RegisterClientScriptInclude(Control, Type, String, String)

Regista um ficheiro de script cliente com o ScriptManager controlo para uso com um controlo que está dentro de um UpdatePanel controlo, e depois adiciona uma referência de ficheiro de script à 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

O controlo que regista o ficheiro de script do cliente.

type
Type

O tipo do ficheiro de script do cliente. Este parâmetro é normalmente especificado usando o operador typeof (C#) ou o operador GetType (Visual Basic) para recuperar o tipo do controlo que está a registar o script.

key
String

Um identificador único para o ficheiro de script.

url
String

A URL do ficheiro de script.

Exceções

ArgumentNullException

O ficheiro type de script do cliente é null.

-ou-

O controlo que regista o ficheiro de script é null.

ArgumentException

O controlo que regista o ficheiro de script não está na árvore de controlo da página.

-ou-

url é null.

-ou-

url está vazio.

Exemplos

<%@ 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;
}

Observações

Utiliza o RegisterClientScriptInclude método para registar um ficheiro de script cliente para uma página ou parte de uma página que está a participar em atualizações parciais da página. Os ficheiros de script cliente registados através deste método são enviados para a página apenas quando representa control um controlo que está dentro de um UpdatePanel controlo que está a ser atualizado. Para registar um ficheiro de script sempre que ocorre um postback assíncrono, use a RegisterClientScriptInclude(Page, Type, String, String) sobrecarga deste método.

Se quiser registar um bloco de script que não diz respeito a atualizações parciais de página, e se quiser registar o bloco de script apenas uma vez durante a renderização inicial da página, use o RegisterClientScriptBlock método da ClientScriptManager classe. Podes obter uma referência ao ClientScriptManager objeto a partir da ClientScript propriedade da página.

O RegisterClientScriptInclude método regista um ficheiro de script cliente na página ao renderizar um script elemento cuja etiqueta de abertura contém um src atributo. O url parâmetro é usado para definir o src atributo. Para resolver URLs, use o ResolveClientUrl método. Este método utiliza o contexto da URL para a qual é chamado para resolver o caminho.

Ambos os RegisterClientScriptInclude métodos e RegisterClientScriptResource renderizam os ficheiros de script para o navegador. Se um script com o mesmo tipo e chave (para um ficheiro de script) ou o mesmo tipo e nome de recurso (para um recurso embutido) já for renderizado, o script não é renderizado novamente.

Ver também

Aplica-se a

RegisterClientScriptInclude(Page, Type, String, String)

Regista o script cliente com o ScriptManager controlo sempre que ocorre um postback assíncrono, e depois adiciona uma referência a um ficheiro de script à 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

O objeto de página que regista o ficheiro de script cliente.

type
Type

O tipo do ficheiro de script do cliente. Este parâmetro é normalmente especificado usando o operador typeof (C#) ou o operador GetType (Visual Basic) para recuperar o tipo do controlo que está a registar o script.

key
String

Um identificador único para o ficheiro de script.

url
String

A URL do ficheiro de script.

Exceções

ArgumentNullException

O ficheiro type de script do cliente é null.

-ou-

A página que regista o ficheiro de script é null.

ArgumentException

url é null.

-ou-

url está vazio.

Observações

Quando regista um ficheiro de script com este método, o script é renderizado sempre que ocorre um postback assíncrono. Para registar um ficheiro de script para um controlo que está dentro de um UpdatePanel controlo, de modo a que esse script só seja registado quando o UpdatePanel controlo é atualizado, use a RegisterClientScriptInclude(Control, Type, String, String) sobrecarga deste método.

Se quiser registar um bloco de script que não diz respeito a atualizações parciais de página, e se quiser registar o bloco de script apenas uma vez durante a renderização inicial da página, use o RegisterClientScriptBlock método da ClientScriptManager classe. Podes obter uma referência ao ClientScriptManager objeto a partir da ClientScript propriedade da página.

Ver também

Aplica-se a