ScriptManager.RegisterClientScriptInclude Metoda
Definice
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)
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.
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
Soubor type
klientského skriptu je null
.
-nebo-
Ovládací prvek, který registruje soubor skriptu je null
.
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é
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
Soubor type
klientského skriptu je null
.
-nebo-
Stránka, která registruje soubor skriptu, je null
.
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.
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.