ScriptManager.RegisterClientScriptResource Methode

  • Referenz

Definition

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

Registriert das in einer Assembly eingebettete Clientskript beim ScriptManager-Steuerelement, um dieses mit einem Steuerelement zu verwenden, das am Teilrendering von Seiten beteiligt ist.

Überlädt

RegisterClientScriptResource(Page, Type, String)

Registriert eine in einer Assembly eingebettete Clientskriptdatei bei jedem asynchronen Postback beim ScriptManager-Steuerelement.
RegisterClientScriptResource(Control, Type, String)

Registriert das in einer Assembly eingebettete Clientskript beim ScriptManager-Steuerelement, um dieses mit einem Steuerelement zu verwenden, das am Teilrendering von Seiten beteiligt ist.

RegisterClientScriptResource(Page, Type, String)

Registriert eine in einer Assembly eingebettete Clientskriptdatei bei jedem asynchronen Postback beim ScriptManager-Steuerelement.

public:
 static void RegisterClientScriptResource(System::Web::UI::Page ^ page, Type ^ type, System::String ^ resourceName);
public static void RegisterClientScriptResource (System.Web.UI.Page page, Type type, string resourceName);
static member RegisterClientScriptResource : System.Web.UI.Page * Type * string -> unit
Public Shared Sub RegisterClientScriptResource (page As Page, type As Type, resourceName As String)

Parameter

page
Page

Das Seitenobjekt, das das Skript registriert.

type
Type

Der Typ des Clientskripts. 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.

resourceName
String

Ein Bezeichner für die Ressource.

Ausnahmen

ArgumentNullException

Die Clientressource type ist null.

- oder - Die Seite, die das Skript registriert, ist null.

Hinweise

Wenn Sie eine Skriptdatei mit dieser Methode registrieren, wird das Skript jedes Mal gerendert, wenn ein asynchroner Postback auftritt. Wenn Sie ein Skript für ein Steuerelement registrieren möchten, das sich innerhalb eines UpdatePanel Steuerelements befindet, damit das Skript nur registriert wird, wenn das UpdatePanel Steuerelement aktualisiert wird, verwenden Sie die RegisterClientScriptResource(Control, Type, String) Überladung dieser Methode.

Wenn Sie einen Skriptblock registrieren möchten, der sich nicht auf Teilseitenupdates bezieht, und wenn Sie den Skriptblock nur einmal während des ersten Seitenrenderings registrieren möchten, verwenden Sie die RegisterClientScriptBlock Methode der ClientScriptManager Klasse. Sie können einen Verweis auf das ClientScriptManager Objekt über die ClientScript Eigenschaft der Seite abrufen.

Siehe auch

Gilt für

RegisterClientScriptResource(Control, Type, String)

Registriert das in einer Assembly eingebettete Clientskript beim ScriptManager-Steuerelement, um dieses mit einem Steuerelement zu verwenden, das am Teilrendering von Seiten beteiligt ist.

public:
 static void RegisterClientScriptResource(System::Web::UI::Control ^ control, Type ^ type, System::String ^ resourceName);
public static void RegisterClientScriptResource (System.Web.UI.Control control, Type type, string resourceName);
static member RegisterClientScriptResource : System.Web.UI.Control * Type * string -> unit
Public Shared Sub RegisterClientScriptResource (control As Control, type As Type, resourceName As String)

Parameter

control
Control

Das Steuerelement, das das Skript registriert.

type
Type

Der Typ des Clientskripts. 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.

resourceName
String

Ein Bezeichner für die Ressource.

Ausnahmen

ArgumentNullException

Die Clientressource type ist null.

- oder - Das Steuerelement, das das Skript registriert, ist null.

ArgumentException

Das Steuerelement, das das Skript registriert, befindet sich nicht in der Steuerelementstruktur der Seite.

Hinweise

Sie verwenden die RegisterClientScriptResource Methode, um ein Skript zu registrieren, das mit teilseitigem Rendering kompatibel ist und keine Abhängigkeiten von Microsoft Ajax Library aufweist. Skriptressourcen, die mithilfe dieser Methode registriert werden, werden nur registriert, wenn control ein Steuerelement in einem UpdatePanel Steuerelement dargestellt wird, das aktualisiert wird. Um ein Skript jedes Mal zu registrieren, wenn ein asynchroner Postback auftritt, verwenden Sie die RegisterStartupScript(Page, Type, String, String, Boolean) Überladung dieser Methode.

Wenn Sie einen Skriptblock registrieren möchten, der sich nicht auf Teilseitenupdates 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 Objekt aus der ClientScriptManager ClientScript Eigenschaft der Seite abrufen.

Die RegisterClientScriptResource Methode wird verwendet, wenn Ressourcen aus Assemblys über einen HTTP-Handler zugegriffen werden. Diese Methode enthält den Inhalt der Ressourcen-URL in einem script Element.

Sowohl die Skriptdateien als auch die RegisterClientScriptInclude RegisterClientScriptResource Methode laden Skriptdateien in den Browser. Wenn ein Skript mit demselben Typ und schlüssel (für eine Skriptdatei) oder demselben Typ und demselben Ressourcennamen (für eine eingebettete Ressource) bereits geladen wird, wird das Skript nicht neu geladen.

Siehe auch

Gilt für