ScriptManager.RegisterClientScriptInclude Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Registriert eine Clientskriptdatei beim ScriptManager-Steuerelement für die Verwendung mit einem Steuerelement, das sich innerhalb eines UpdatePanel-Steuerelements befindet, und fügt der Seite dann einen Skriptdateiverweis hinzu.
Überlädt
RegisterClientScriptInclude(Control, Type, String, String) |
Registriert eine Clientskriptdatei beim ScriptManager-Steuerelement für die Verwendung mit einem Steuerelement, das sich innerhalb eines UpdatePanel-Steuerelements befindet, und fügt der Seite dann einen Skriptdateiverweis hinzu. |
RegisterClientScriptInclude(Page, Type, String, String) |
Registriert das Clientskript bei jedem asynchronen Postback beim ScriptManager-Steuerelement und fügt der Seite dann einen Skriptdateiverweis hinzu. |
RegisterClientScriptInclude(Control, Type, String, String)
Registriert eine Clientskriptdatei beim ScriptManager-Steuerelement für die Verwendung mit einem Steuerelement, das sich innerhalb eines UpdatePanel-Steuerelements befindet, und fügt der Seite dann einen Skriptdateiverweis hinzu.
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)
Parameter
- control
- Control
Das Steuerelement, das die Clientskriptdatei registriert.
- type
- Type
Der Typ der zu registrierenden Clientskriptdatei. Dieser Parameter wird meist mithilfe des Operators "typeof" (C#) bzw. des Operators "GetType" (Visual Basic) angegeben, um den Typ des Steuerelements abzurufen, das das Skript registriert.
- key
- String
Ein eindeutiger Bezeichner für die Skriptdatei.
- url
- String
Die URL der Skriptdatei.
Ausnahmen
Die Clientskriptdatei type
ist null
.
- oder -
Das Steuerelement, das die Skriptdatei registriert, ist null
.
Das Steuerelement, das die Skriptdatei registriert, befindet sich nicht in der Steuerelementstruktur der Seite.
- oder -
url
ist null
.
- oder -
url
ist leer.
Beispiele
<%@ 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;
}
Hinweise
Sie verwenden die RegisterClientScriptInclude -Methode, um eine Clientskriptdatei für eine Seite oder einen Teil einer Seite zu registrieren, die an teilseitigen Seitenupdates beteiligt ist. Clientskriptdateien, die mit dieser Methode registriert werden, werden nur dann an die Seite gesendet, wenn das control
ein Steuerelement darstellt, das sich in einem UpdatePanel Steuerelement befindet, das aktualisiert wird. Verwenden Sie RegisterClientScriptInclude(Page, Type, String, String) die Überladung dieser Methode, um bei jedem asynchronen Postback eine Skriptdatei zu registrieren.
Wenn Sie einen Skriptblock registrieren möchten, der sich nicht auf Teilaktualisierungen von Seiten bezieht, und wenn Sie den Skriptblock während des anfänglichen Seitenrenderings nur einmal registrieren möchten, verwenden Sie die RegisterClientScriptBlock -Methode der ClientScriptManager -Klasse. Sie können einen Verweis auf das ClientScriptManager -Objekt aus der ClientScript Eigenschaft der Seite abrufen.
Die RegisterClientScriptInclude -Methode registriert eine Clientskriptdatei auf der Seite, indem ein script
Element gerendert wird, dessen öffnendes Tag ein src
Attribut enthält. Der url
Parameter wird verwendet, um das src
Attribut festzulegen. Verwenden Sie die -Methode, um URLs aufzulösen ResolveClientUrl . Diese Methode verwendet den Kontext der URL, für die sie aufgerufen wird, um den Pfad aufzulösen.
Sowohl die RegisterClientScriptInclude -Methode als RegisterClientScriptResource auch rendern Skriptdateien im Browser. Wenn ein Skript mit dem gleichen Typ und Schlüssel (für eine Skriptdatei) oder demselben Typ und Ressourcennamen (für eine eingebettete Ressource) bereits gerendert wurde, wird das Skript nicht erneut gerendert.
Weitere Informationen
Gilt für:
RegisterClientScriptInclude(Page, Type, String, String)
Registriert das Clientskript bei jedem asynchronen Postback beim ScriptManager-Steuerelement und fügt der Seite dann einen Skriptdateiverweis hinzu.
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)
Parameter
- page
- Page
Das Seitenobjekt, das die Clientskriptdatei registriert.
- type
- Type
Der Typ der zu registrierenden Clientskriptdatei. Dieser Parameter wird meist mithilfe des Operators "typeof" (C#) bzw. des Operators "GetType" (Visual Basic) angegeben, um den Typ des Steuerelements abzurufen, das das Skript registriert.
- key
- String
Ein eindeutiger Bezeichner für die Skriptdatei.
- url
- String
Die URL der Skriptdatei.
Ausnahmen
Die Clientskriptdatei type
ist null
.
- oder -
Die Seite, die die Skriptdatei registriert, ist null
.
Hinweise
Wenn Sie eine Skriptdatei bei dieser Methode registrieren, wird das Skript jedes Mal gerendert, wenn ein asynchrones Postback erfolgt. Verwenden RegisterClientScriptInclude(Control, Type, String, String) Sie die Überladung dieser Methode, um eine Skriptdatei für ein Steuerelement zu registrieren, das sich in einem UpdatePanel Steuerelement befindet, sodass das Skript nur registriert wird, wenn das UpdatePanel Steuerelement aktualisiert wird.
Wenn Sie einen Skriptblock registrieren möchten, der sich nicht auf Teilaktualisierungen von Seiten bezieht, und wenn Sie den Skriptblock während des anfänglichen Seitenrenderings nur einmal registrieren möchten, verwenden Sie die RegisterClientScriptBlock -Methode der ClientScriptManager -Klasse. Sie können einen Verweis auf das ClientScriptManager -Objekt aus der ClientScript Eigenschaft der Seite abrufen.