ScriptManager.RegisterClientScriptResource 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 Clientskripts, die in eine Assembly eingebettet sind, mit dem Steuerelement für die ScriptManager Verwendung mit einem Steuerelement, das an partiellem Seitenrendering teilnimmt.
Überlädt
| Name | Beschreibung |
|---|---|
| RegisterClientScriptResource(Page, Type, String) |
Registriert eine Clientskriptdatei, die bei jedem Auftreten eines Postbacks in eine Assembly mit dem ScriptManager Steuerelement eingebettet ist. |
| RegisterClientScriptResource(Control, Type, String) |
Registriert das Clientskript, das in eine Assembly eingebettet ist, mit dem Steuerelement für die ScriptManager Verwendung mit einem Steuerelement, das an partiellem Seitenrendering teilnimmt. |
RegisterClientScriptResource(Page, Type, String)
Registriert eine Clientskriptdatei, die bei jedem Auftreten eines Postbacks in eine Assembly mit dem ScriptManager Steuerelement eingebettet ist.
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 -> unitPublic 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 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.
- resourceName
- String
Ein Bezeichner für die Ressource.
Ausnahmen
Die Clientressource type lautet null.
- oder -
Die Seite, die das Skript registriert, ist null.
Hinweise
Wenn Sie eine Skriptdatei bei dieser Methode registrieren, wird das Skript jedes Mal gerendert, wenn ein asynchroner Postback auftritt. Um ein Skript für ein Steuerelement zu registrieren, 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 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:
RegisterClientScriptResource(Control, Type, String)
Registriert das Clientskript, das in eine Assembly eingebettet ist, mit dem Steuerelement für die ScriptManager Verwendung mit einem Steuerelement, das an partiellem Seitenrendering teilnimmt.
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 -> unitPublic 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 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.
- resourceName
- String
Ein Bezeichner für die Ressource.
Ausnahmen
Die Clientressource type lautet null.
- oder -
Das Steuerelement, das das Skript registriert, ist null.
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 teilweisem Seitenrendering kompatibel ist und keine Abhängigkeiten der Microsoft Ajax-Bibliothek aufweist. Skriptressourcen, die mithilfe dieser Methode registriert sind, werden nur registriert, wenn control ein Steuerelement in einem UpdatePanel aktualisierten Steuerelement dargestellt wird. Wenn Sie ein Skript jedes Mal registrieren möchten, 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 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 RegisterClientScriptResource Methode wird verwendet, wenn über einen HTTP-Handler auf Ressourcen aus Assemblys zugegriffen wird. Diese Methode enthält den Inhalt der Ressourcen-URL in einem script Element.
Sowohl die RegisterClientScriptInclude Skriptdateien als auch die RegisterClientScriptResource Methode laden Skriptdateien in den 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 geladen wird, wird das Skript nicht neu geladen.
