ScriptManager.RegisterClientScriptInclude Metoda

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 skriptu pomocí ScriptManager ovládacího prvku pro použití s ovládacím prvku, který je uvnitř UpdatePanel ovládacího prvku, a pak přidá odkaz na soubor skriptu na stránku.

Přetížení

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

Pokud chcete zaregistrovat blok skriptu, který se netýká částečných aktualizací stránky, a pokud chcete zaregistrovat blok skriptu pouze jednou během počátečního vykreslování stránky, 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á značka obsahuje src atribut. Parametr url se používá k nastavení atributu src . K vyřešení adres URL použijte metodu ResolveClientUrl . Tato metoda používá kontext adresy URL, kterou je volána k překladu cesty.

RegisterClientScriptInclude RegisterClientScriptResource Soubory skriptu v prohlížeči i metody vykreslují. 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 na stránku přidá 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 (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í při každém výskytu asynchronního 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

Váš názor

Byla tato stránka užitečná?

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

Váš názor