Freigeben über

ScriptManager.RegisterClientScriptInclude Methode

Definition

Namespace:
System.Web.UI
Assembly:
System.Web.Extensions.dll

Registriert eine Clientskriptdatei mit dem Steuerelement für die ScriptManager Verwendung mit einem Steuerelement, das sich in einem UpdatePanel Steuerelement befindet, und fügt dann einen Skriptdateiverweis zur Seite hinzu.

Überlädt

Name Beschreibung
RegisterClientScriptInclude(Control, Type, String, String)

Registriert eine Clientskriptdatei mit dem Steuerelement für die ScriptManager Verwendung mit einem Steuerelement, das sich in einem UpdatePanel Steuerelement befindet, und fügt dann einen Skriptdateiverweis zur Seite hinzu.
RegisterClientScriptInclude(Page, Type, String, String)

Registriert client script with the ScriptManager control every time that an asynchron postback occurs, and then adds a script file reference to the page.

RegisterClientScriptInclude(Control, Type, String, String)

Registriert eine Clientskriptdatei mit dem Steuerelement für die ScriptManager Verwendung mit einem Steuerelement, das sich in einem UpdatePanel Steuerelement befindet, und fügt dann einen Skriptdateiverweis zur Seite 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 Clientskriptdatei. Dieser Parameter wird in der Regel mit dem Typeof-Operator (C#) oder dem GetType-Operator (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

ArgumentNullException

Die Clientskriptdatei type ist null.

- oder -

Das Steuerelement, das die Skriptdatei registriert, ist null.

ArgumentException

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 Teilseitenaktualisierungen teilnimmt. Clientskriptdateien, die mithilfe dieser Methode registriert sind, werden nur dann an die Seite gesendet, wenn das control Steuerelement in einem UpdatePanel Steuerelement dargestellt wird, das aktualisiert wird. Wenn Sie eine Skriptdatei jedes Mal registrieren möchten, wenn ein asynchroner Postback auftritt, verwenden Sie die RegisterClientScriptInclude(Page, Type, String, String) Überladung dieser Methode.

Wenn Sie einen Skriptblock registrieren möchten, der sich nicht auf Teilseitenaktualisierungen bezieht, und wenn Sie den Skriptblock nur einmal während des anfänglichen Seitenrenderings 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 Öffnende Tag ein src Attribut enthält. Der url Parameter wird verwendet, um das src Attribut festzulegen. Verwenden Sie die ResolveClientUrl Methode, um URLs aufzulösen. Diese Methode verwendet den Kontext der URL, die aufgerufen wird, um den Pfad aufzulösen.

Sowohl die Skriptdateien als RegisterClientScriptResource auch die RegisterClientScriptInclude Methoden rendern Skriptdateien im Browser. Wenn ein Skript mit demselben Typ und Schlüssel (für eine Skriptdatei) oder demselben Typ und Ressourcennamen (für eine eingebettete Ressource) bereits gerendert wird, wird das Skript nicht erneut gerendert.

Weitere Informationen

Gilt für:

RegisterClientScriptInclude(Page, Type, String, String)

Registriert client script with the ScriptManager control every time that an asynchron postback occurs, and then adds a script file reference to the page.

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 Clientskriptdatei. Dieser Parameter wird in der Regel mit dem Typeof-Operator (C#) oder dem GetType-Operator (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

ArgumentNullException

Die Clientskriptdatei type ist null.

- oder -

Die Seite, die die Skriptdatei registriert, ist null.

ArgumentException

url ist null.

- oder -

url ist leer.

Hinweise

Wenn Sie eine Skriptdatei bei dieser Methode registrieren, wird das Skript jedes Mal gerendert, wenn ein asynchroner Postback auftritt. Verwenden Sie die RegisterClientScriptInclude(Control, Type, String, String) Überladung dieser Methode, um eine Skriptdatei für ein Steuerelement zu registrieren, das innerhalb eines UpdatePanel Steuerelements enthalten ist, sodass das Skript nur registriert wird, wenn das UpdatePanel Steuerelement aktualisiert wird.

Wenn Sie einen Skriptblock registrieren möchten, der sich nicht auf Teilseitenaktualisierungen bezieht, und wenn Sie den Skriptblock nur einmal während des anfänglichen Seitenrenderings 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: