ScriptManager.RegisterClientScriptResource Método

Definición

Espacio de nombres:

System.Web.UI

Ensamblado:

System.Web.Extensions.dll

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.

Sobrecargas

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.
RegisterClientScriptResource(Control, Type, String)	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.

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.

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)

Parámetros

page

Page

Objeto de página que registra el script.

type

Type

Tipo del script de cliente. 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.

resourceName

String

Identificador del recurso.

Excepciones

ArgumentNullException

El valor type del recurso de cliente es null.

o bien La página que registra el script es null.

Comentarios

Al registrar un archivo de script con este método, el script se representa cada vez que se produce una postback asincrónica. Para registrar un script para un control que está dentro de un UpdatePanel control para que el script se registre solo cuando se actualice el UpdatePanel control, use la RegisterClientScriptResource(Control, Type, String) sobrecarga de este método.

Si desea registrar un bloque de script que no pertenece a actualizaciones parciales de páginas y si desea registrar el bloque de script solo una vez durante la representación inicial de página, use el RegisterClientScriptBlock método de la ClientScriptManager clase . Puede obtener una referencia al ClientScriptManager objeto desde la ClientScript propiedad de la página.

Consulte también

• RegisterClientScriptResource(Control, Type, String)
• WebResourceAttribute

RegisterClientScriptResource(Control, Type, String)

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.

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)

Parámetros

control

Control

Control que registra el script.

type

Type

Tipo del script de cliente. 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.

resourceName

String

Identificador del recurso.

Excepciones

ArgumentNullException

El valor type del recurso de cliente es null.

o bien El control que registra el script es null.

ArgumentException

El control que registra el script no está en el árbol de controles de la página.

Comentarios

Use el RegisterClientScriptResource método para registrar un script compatible con la representación parcial de páginas y que no tenga dependencias de la biblioteca de Microsoft Ajax. Los recursos de script registrados mediante este método solo se registran cuando control representa un control que está dentro de un UpdatePanel control que se actualiza. Para registrar un script cada vez que se produce un postback asincrónico, use la RegisterStartupScript(Page, Type, String, String, Boolean) sobrecarga de este método.

Si desea registrar un bloque de script que no pertenece a actualizaciones parciales de páginas y si desea registrar el bloque de script solo una vez durante la representación de página inicial, use el RegisterClientScriptBlock método de la ClientScriptManager clase . Puede obtener una referencia al ClientScriptManager objeto desde la ClientScript propiedad de la página.

El RegisterClientScriptResource método se usa cuando se accede a los recursos de los ensamblados a través de un controlador HTTP. Este método incluye el contenido de la dirección URL del recurso en un script elemento .

Tanto el método como el RegisterClientScriptInclude RegisterClientScriptResource método cargan archivos de script en el explorador. 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 vuelve a cargar.

Consulte también

• RegisterClientScriptResource(Page, Type, String)
• WebResourceAttribute