ScriptManager.RegisterClientScriptInclude Método

Referência

Definição

Namespace:: System.Web.UI

Assembly:: System.Web.Extensions.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Registra um arquivo de script de cliente com o controle ScriptManager para uso com um controle que está em um controle UpdatePanel e adiciona uma referência de arquivo de script à página.

Sobrecargas

RegisterClientScriptInclude(Control, Type, String, String)	Registra um arquivo de script de cliente com o controle ScriptManager para uso com um controle que está em um controle UpdatePanel e adiciona uma referência de arquivo de script à página.
RegisterClientScriptInclude(Page, Type, String, String)	Registra um script de cliente com o controle ScriptManager toda vez que um postback assíncrono ocorre e, em seguida, adiciona uma referência de arquivo de script à página.

RegisterClientScriptInclude(Control, Type, String, String)

Registra um arquivo de script de cliente com o controle ScriptManager para uso com um controle que está em um controle UpdatePanel e adiciona uma referência de arquivo 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 controle que está registrando o arquivo de script de cliente.

type: Type

O tipo de arquivo de script de cliente. Geralmente, este parâmetro é especificado com o operador typeof (C#) ou GetType (Visual Basic) para recuperar o tipo do controle que está registrando o script.

key: String

Um identificador exclusivo para o arquivo de script.

url: String

A URL do arquivo de script.

Exceções

ArgumentNullException

O arquivo de script de cliente type é null.

- ou -

O controle que está registrando o arquivo de script é null.

ArgumentException

O controle que está registrando o arquivo de script não está na árvore de controle 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;
}

Comentários

Use o RegisterClientScriptInclude método para registrar um arquivo de script de cliente para uma página ou parte de uma página que esteja participando de atualizações de página parcial. Os arquivos de script do cliente registrados usando esse método são enviados para a página somente quando o control representa um controle que está dentro de um UpdatePanel controle que está sendo atualizado. Para registrar um arquivo de script sempre que ocorrer um postback assíncrono, use a RegisterClientScriptInclude(Page, Type, String, String) sobrecarga desse método.

Se você quiser registrar um bloco de script que não pertence a atualizações de página parcial e se quiser registrar o bloco de script apenas uma vez durante a renderização inicial da página, use o RegisterClientScriptBlock método da ClientScriptManager classe . Você pode obter uma referência ao ClientScriptManager objeto da ClientScript propriedade da página.

O RegisterClientScriptInclude método registra um arquivo de script de cliente na página renderizando um script elemento cuja marca 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 . Esse método usa o contexto da URL que é chamada para resolver o caminho.

RegisterClientScriptInclude Os métodos e RegisterClientScriptResource renderizam arquivos de script para o navegador. Se um script com o mesmo tipo e chave (para um arquivo de script) ou o mesmo tipo e nome de recurso (para um recurso inserido) já estiver renderizado, o script não será renderizado novamente.

Confira também

RegisterClientScriptInclude(Page, Type, String, String)

Aplica-se a

RegisterClientScriptInclude(Page, Type, String, String)

Registra um script de cliente com o controle ScriptManager toda vez que um postback assíncrono ocorre e, em seguida, adiciona uma referência de arquivo 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 da página que está registrando o arquivo de script de cliente.

type: Type

key: String

Um identificador exclusivo para o arquivo de script.

url: String

A URL do arquivo de script.

Exceções

ArgumentNullException

O arquivo de script de cliente type é null.

- ou -

A página que está registrando o arquivo de script é null.

ArgumentException

url é null.

- ou -

url está vazio.

Comentários

Quando você registra um arquivo de script com esse método, o script é renderizado sempre que ocorre um postback assíncrono. Para registrar um arquivo de script para um controle que está dentro de um UpdatePanel controle para que o script seja registrado somente quando o UpdatePanel controle for atualizado, use a RegisterClientScriptInclude(Control, Type, String, String) sobrecarga desse método.

Confira também

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

Aplica-se a

ScriptManager.RegisterClientScriptInclude Método

Definição

Sobrecargas

RegisterClientScriptInclude(Control, Type, String, String)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

RegisterClientScriptInclude(Page, Type, String, String)

Parâmetros

Exceções

Comentários

Confira também

Aplica-se a

Comentários

Recursos adicionais