Freigeben über


ScriptManager.RegisterClientScriptInclude Methode

Definition

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.

url ist null.

- oder -

url ist leer.

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.

Weitere Informationen

Gilt für: