ScriptManager.RegisterClientScriptResource ScriptManager.RegisterClientScriptResource ScriptManager.RegisterClientScriptResource Method

Definición

Registra scripts de cliente incrustados en ensamblados con el control ScriptManager para su uso con un control que participa en la representación parcial de página.Registers client script that is embedded in an assembly with the ScriptManager control for use with a control that is participating in partial-page rendering.

Sobrecargas

RegisterClientScriptResource(Control, Type, String) RegisterClientScriptResource(Control, Type, String) RegisterClientScriptResource(Control, Type, String)

Registra el script de cliente que está incrustado en un ensamblado con el control ScriptManager para su uso con un control que participa en la representación parcial de página.Registers the client script that is embedded in an assembly with the ScriptManager control for use with a control that is participating in partial-page rendering.

RegisterClientScriptResource(Page, Type, String) RegisterClientScriptResource(Page, Type, String) RegisterClientScriptResource(Page, Type, String)

Registra un archivo de script de cliente que se incrusta en un ensamblado con el control ScriptManager cada vez que se produce un postback.Registers a client script file that is embedded in an assembly with the ScriptManager control every time that a postback occurs.

RegisterClientScriptResource(Control, Type, String) RegisterClientScriptResource(Control, Type, String) RegisterClientScriptResource(Control, Type, String)

Registra el script de cliente que está incrustado en un ensamblado con el control ScriptManager para su uso con un control que participa en la representación parcial de página.Registers the client script that is embedded in an assembly with the ScriptManager control for use with a control that is participating in partial-page rendering.

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

Parámetros

control
Control Control Control

Control que registra el script.The control that is registering the script.

type
Type Type Type

Tipo del script de cliente.The type of the client script. Este parámetro se suele especificar mediante el uso del operador typeof (C#) o GetType (Visual Basic) para recuperar el tipo del control que registra el script.This parameter is usually specified by using the typeof operator (C#) or the GetType operator (Visual Basic) to retrieve the type of the control that is registering the script.

resourceName
String String String

Identificador del recurso.An identifier for the resource.

Excepciones

El valor type del recurso de cliente es null.The client resource type is null.

O bien-or- El control que registra el script es null.The control that is registering the script is null.

El control que registra el script no está en el árbol de controles de la página.The control that is registering the script is not in the page's control tree.

Comentarios

El método se RegisterClientScriptResource usa para registrar un script que es compatible con la representación parcial de página y que no tiene dependencias de la biblioteca de Microsoft Ajax.You use the RegisterClientScriptResource method to register a script that is compatible with partial-page rendering and that has no Microsoft Ajax Library dependencies. Los recursos de script que se registran con este método solo se control registran cuando representa un control que UpdatePanel está dentro de un control que se actualiza.Script resources that are registered by using this method are registered only when control represents a control that is inside an UpdatePanel control that is updated. Para registrar un script cada vez que se produce un postback asincrónico, utilice RegisterStartupScript(Page, Type, String, String, Boolean) la sobrecarga de este método.To register a script every time that an asynchronous postback occurs, use the RegisterStartupScript(Page, Type, String, String, Boolean) overload of this method.

Si desea registrar un bloque de script que no se corresponde con las actualizaciones parciales de página, y si desea registrar el bloque de script solo una vez durante la representación inicial de la página, use RegisterClientScriptBlock el método de ClientScriptManager la clase.If you want to register a script block that does not pertain to partial-page updates, and if you want to register the script block only one time during initial page rendering, use the RegisterClientScriptBlock method of the ClientScriptManager class. Puede obtener una referencia al ClientScriptManager objeto desde la ClientScript propiedad de la página.You can get a reference to the ClientScriptManager object from the ClientScript property of the page.

El RegisterClientScriptResource método se usa cuando se tiene acceso a los recursos de los ensamblados a través de un controlador http.The RegisterClientScriptResource method is used when resources from assemblies are accessed through an HTTP handler. Este método incluye el contenido de la dirección URL del recurso script en un elemento.This method includes the content of the resource URL in a script element.

RegisterClientScriptInclude TantoRegisterClientScriptResource como el método cargan los archivos de script en el explorador.Both the RegisterClientScriptInclude and the RegisterClientScriptResource method load script files into the browser. Si ya se ha cargado un script con el mismo tipo y clave (para un archivo de script) o el mismo tipo y nombre de recurso (para un recurso incrustado), el script no se recarga.If a script with the same type and key (for a script file) or the same type and resource name (for an embedded resource) is already loaded, the script is not reloaded.

Consulte también:

RegisterClientScriptResource(Page, Type, String) RegisterClientScriptResource(Page, Type, String) RegisterClientScriptResource(Page, Type, String)

Registra un archivo de script de cliente que se incrusta en un ensamblado con el control ScriptManager cada vez que se produce un postback.Registers a client script file that is embedded in an assembly with the ScriptManager control every time that a postback occurs.

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

Parámetros

page
Page Page Page

Objeto de página que registra el script.The page object that is registering the script.

type
Type Type Type

Tipo del script de cliente.The type of the client script. Este parámetro se suele especificar mediante el uso del operador typeof (C#) o GetType (Visual Basic) para recuperar el tipo del control que registra el script.This parameter is usually specified by using the typeof operator (C#) or the GetType operator (Visual Basic) to retrieve the type of the control that is registering the script.

resourceName
String String String

Identificador del recurso.An identifier for the resource.

Excepciones

El valor type del recurso de cliente es null.The client resource type is null.

O bien-or- La página que registra el script es null.The page that is registering the script is null.

Comentarios

Al registrar un archivo de script con este método, el script se representa cada vez que se produce un postback asincrónico.When you register a script file with this method, the script is rendered every time that an asynchronous postback occurs. Para registrar un script para un control que está dentro de UpdatePanel un control para que el script se registre solo cuando UpdatePanel se actualiza el control, use RegisterClientScriptResource(Control, Type, String) la sobrecarga de este método.To register a script for a control that is inside an UpdatePanel control so that the script is registered only when the UpdatePanel control is updated, use the RegisterClientScriptResource(Control, Type, String) overload of this method.

Si desea registrar un bloque de script que no se corresponde con las actualizaciones parciales de página, y si desea registrar el bloque de script solo una vez durante la representación inicial de la página, use RegisterClientScriptBlock el método de ClientScriptManager la clase.If you want to register a script block that does not pertain to partial-page updates, and if you want to register the script block only one time during initial page rendering, use the RegisterClientScriptBlock method of the ClientScriptManager class. Puede obtener una referencia al ClientScriptManager objeto desde la ClientScript propiedad de la página.You can get a reference to the ClientScriptManager object from the ClientScript property of the page.

Consulte también:

Se aplica a