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

Usa el RegisterClientScriptResource método para registrar un script que es compatible con la representación parcial de página y que no tiene ninguna dependencia de Microsoft Ajax Library.You use the RegisterClientScriptResource method to register a script that is compatible with partial-page rendering and that has no Microsoft Ajax Library dependencies. Se registran los recursos de script que se registran mediante este método solo cuando control representa un control que está dentro de un UpdatePanel 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 el RegisterStartupScript(Page, Type, String, String, Boolean) 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 pertenecen a las actualizaciones parciales de página y, si desea registrar el bloque de script sólo una vez durante la representación de página inicial, utilice el RegisterClientScriptBlock método de la ClientScriptManager 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 a la ClientScriptManager objeto desde el 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 utiliza cuando se tiene acceso a recursos desde 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 de recursos en un script elemento.This method includes the content of the resource URL in a script element.

Tanto el RegisterClientScriptInclude y RegisterClientScriptResource archivos de script de carga de método en el explorador.Both the RegisterClientScriptInclude and the RegisterClientScriptResource method load script files into the browser. Si ya está cargado un script con el mismo tipo y la clave (para un archivo de script) o el mismo tipo y el nombre de recurso (para un recurso incrustado), no se vuelve a cargar el script.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 un UpdatePanel controlar de manera que se registra el script solo cuando el UpdatePanel control se actualiza, use el RegisterClientScriptResource(Control, Type, String) 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 pertenecen a las actualizaciones parciales de página y, si desea registrar el bloque de script sólo una vez durante la representación de página inicial, utilice el RegisterClientScriptBlock método de la ClientScriptManager 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 a la ClientScriptManager objeto desde el 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