ScriptManager.RegisterClientScriptInclude Metoda

Reference

Definice

Obor názvů:: System.Web.UI

Sestavení:: System.Web.Extensions.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Zaregistruje soubor klientského ScriptManager skriptu pomocí ovládacího prvku pro použití s ovládacím prvek, který je uvnitř UpdatePanel ovládacího prvku, a pak přidá na stránku odkaz na soubor skriptu.

Přetížení

RegisterClientScriptInclude(Control, Type, String, String)	Zaregistruje soubor klientského ScriptManager skriptu pomocí ovládacího prvku pro použití s ovládacím prvek, který je uvnitř UpdatePanel ovládacího prvku, a pak přidá na stránku odkaz na soubor skriptu.
RegisterClientScriptInclude(Page, Type, String, String)	Zaregistruje klientský skript pomocí ScriptManager ovládacího prvku pokaždé, když dojde k asynchronnímu postbacku, a pak přidá na stránku odkaz na soubor skriptu.

RegisterClientScriptInclude(Control, Type, String, String)

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)

Parametry

control: Control

Ovládací prvek, který registruje soubor klientského skriptu.

type: Type

Typ souboru klientského skriptu. Tento parametr je obvykle určen pomocí operátoru typeof (C#) nebo GetType operátor (Visual Basic) k načtení typu ovládacího prvku, který registruje skript.

key: String

Jedinečný identifikátor souboru skriptu.

url: String

Adresa URL souboru skriptu.

Výjimky

ArgumentNullException

Soubor type klientského skriptu je null.

-nebo- Ovládací prvek, který registruje soubor skriptu je null.

ArgumentException

Ovládací prvek, který registruje soubor skriptu, není ve stromu ovládacích prvků stránky.

-nebo- url je null.

-nebo- url je prázdný.

Příklady

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

Poznámky

Tuto metodu RegisterClientScriptInclude použijete k registraci souboru klientského skriptu pro stránku nebo část stránky, která se účastní částečných aktualizací. Soubory klientských skriptů zaregistrované pomocí této metody se odesílají na stránku pouze v případě control , že představuje ovládací prvek, který je uvnitř UpdatePanel ovládacího prvku, který se aktualizuje. Pokud chcete zaregistrovat soubor skriptu pokaždé, když dojde k asynchronnímu postbacku, použijte RegisterClientScriptInclude(Page, Type, String, String) přetížení této metody.

Chcete-li zaregistrovat blok skriptu, který se netýká částečných aktualizací stránky, a pokud chcete při počátečním vykreslování stránky zaregistrovat blok skriptu pouze jednou, použijte RegisterClientScriptBlock metodu ClientScriptManager třídy. Odkaz na ClientScriptManager objekt můžete získat z ClientScript vlastnosti stránky.

Metoda RegisterClientScriptInclude zaregistruje soubor klientského skriptu na stránce vykreslením elementu script , jehož levá src značka obsahuje atribut. Parametr url se používá k nastavení atributu src . K překladu adres URL použijte metodu ResolveClientUrl . Tato metoda používá kontext adresy URL, kterou volá k překladu cesty.

Soubory skriptů v prohlížeči se vykreslují jak metodami RegisterClientScriptInclude RegisterClientScriptResource , tak i soubory. Pokud je již vykreslen skript se stejným typem a klíčem (pro soubor skriptu) nebo stejný typ a název prostředku (pro vložený prostředek), skript se znovu nevykreslí.

Viz také

RegisterClientScriptInclude(Page, Type, String, String)

Platí pro

RegisterClientScriptInclude(Page, Type, String, String)

Zaregistruje klientský skript pomocí ScriptManager ovládacího prvku pokaždé, když dojde k asynchronnímu postbacku, a pak přidá na stránku odkaz na soubor skriptu.

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)

Parametry

page: Page

Objekt stránky, který registruje soubor klientského skriptu.

type: Type

Typ souboru klientského skriptu. Tento parametr je obvykle určen pomocí operátoru typeof (C#) nebo GetType operátor (Visual Basic) k načtení typu ovládacího prvku, který registruje skript.

key: String

Jedinečný identifikátor souboru skriptu.

url: String

Adresa URL souboru skriptu.

Výjimky

ArgumentNullException

Soubor type klientského skriptu je null.

-nebo- Stránka, která registruje soubor skriptu, je null.

ArgumentException

url je null.

-nebo- url je prázdný.

Poznámky

Při registraci souboru skriptu pomocí této metody se skript vykreslí pokaždé, když dojde k asynchronnímu postbacku. Chcete-li zaregistrovat soubor skriptu pro ovládací prvek, který je uvnitř UpdatePanel ovládacího prvku, aby byl skript registrován pouze při UpdatePanel aktualizaci ovládacího prvku, použijte RegisterClientScriptInclude(Control, Type, String, String) přetížení této metody.

Viz také

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

Platí pro

Sdílet prostřednictvím

ScriptManager.RegisterClientScriptInclude Metoda

Definice

Přetížení

RegisterClientScriptInclude(Control, Type, String, String)

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

RegisterClientScriptInclude(Page, Type, String, String)

Parametry

Výjimky

Poznámky

Viz také

Platí pro

Další materiály