ScriptManager.RegisterClientScriptResource Metod

Definition

Namnområde:
System.Web.UI
Sammansättning:
System.Web.Extensions.dll

Registrerar klientskript som är inbäddat i en sammansättning med ScriptManager kontrollen för användning med en kontroll som deltar i delvis sidåtergivning.

Överlagringar

Name Description
RegisterClientScriptResource(Page, Type, String)

Registrerar en klientskriptfil som är inbäddad i en sammansättning med ScriptManager kontrollen varje gång en postback inträffar.
RegisterClientScriptResource(Control, Type, String)

Registrerar klientskriptet som är inbäddat i en sammansättning med ScriptManager kontrollen för användning med en kontroll som deltar i delvis sidåtergivning.

RegisterClientScriptResource(Page, Type, String)

Registrerar en klientskriptfil som är inbäddad i en sammansättning med ScriptManager kontrollen varje gång en postback inträffar.

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)

Parametrar

page
Page

Sidobjektet som registrerar skriptet.

type
Type

Typ av klientskript. Den här parametern anges vanligtvis med hjälp av typ av operator (C#) eller GetType-operatorn (Visual Basic) för att hämta typen av kontroll som registrerar skriptet.

resourceName
String

En identifierare för resursen.

Undantag

ArgumentNullException

Klientresursen type är null.

-eller-

Sidan som registrerar skriptet är null.

Kommentarer

När du registrerar en skriptfil med den här metoden återges skriptet varje gång en asynkron postback sker. Om du vill registrera ett skript för en kontroll som finns i en UpdatePanel kontroll så att skriptet endast registreras när UpdatePanel kontrollen uppdateras använder du överbelastningen av den RegisterClientScriptResource(Control, Type, String) här metoden.

Om du vill registrera ett skriptblock som inte gäller partiella siduppdateringar, och om du bara vill registrera skriptblocket en gång under den första sidåtergivningen RegisterClientScriptBlock , använder du -metoden för ClientScriptManager klassen. Du kan hämta en referens till ClientScriptManager objektet från ClientScript sidans egenskap.

Se även

Gäller för

RegisterClientScriptResource(Control, Type, String)

Registrerar klientskriptet som är inbäddat i en sammansättning med ScriptManager kontrollen för användning med en kontroll som deltar i delvis sidåtergivning.

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)

Parametrar

control
Control

Kontrollen som registrerar skriptet.

type
Type

Typ av klientskript. Den här parametern anges vanligtvis med hjälp av typ av operator (C#) eller GetType-operatorn (Visual Basic) för att hämta typen av kontroll som registrerar skriptet.

resourceName
String

En identifierare för resursen.

Undantag

ArgumentNullException

Klientresursen type är null.

-eller-

Kontrollen som registrerar skriptet är null.

ArgumentException

Kontrollen som registrerar skriptet finns inte i sidans kontrollträd.

Kommentarer

Du använder metoden RegisterClientScriptResource för att registrera ett skript som är kompatibelt med delvis sidåtergivning och som inte har några Microsoft Ajax-biblioteksberoenden. Skriptresurser som registreras med den här metoden registreras endast när control representerar en kontroll som finns i en UpdatePanel kontroll som uppdateras. Om du vill registrera ett skript varje gång en asynkron postback inträffar använder du överlagringen av den RegisterStartupScript(Page, Type, String, String, Boolean) här metoden.

Om du vill registrera ett skriptblock som inte gäller partiella siduppdateringar, och om du bara vill registrera skriptblocket en gång under den första sidåtergivningen RegisterClientScriptBlock , använder du -metoden för ClientScriptManager klassen. Du kan hämta en referens till ClientScriptManager objektet från ClientScript sidans egenskap.

Metoden RegisterClientScriptResource används när resurser från sammansättningar nås via en HTTP-hanterare. Den här metoden innehåller innehållet i resurs-URL:en i ett script element.

Både skriptfilerna RegisterClientScriptInclude och RegisterClientScriptResource -metoden läses in i webbläsaren. Om ett skript med samma typ och nyckel (för en skriptfil) eller samma typ och resursnamn (för en inbäddad resurs) redan har lästs in, läses skriptet inte in igen.

Se även

Gäller för