ScriptManager.RegisterClientScriptResource Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Registra el script de cliente incrustado en un ensamblado con el ScriptManager control para su uso con un control que participa en la representación parcial de páginas.
Sobrecargas
| Nombre | Description |
|---|---|
| RegisterClientScriptResource(Page, Type, String) |
Registra un archivo de script de cliente incrustado en un ensamblado con el ScriptManager control cada vez que se produce una devolución de entrada. |
| RegisterClientScriptResource(Control, Type, String) |
Registra el script de cliente incrustado en un ensamblado con el ScriptManager control para usarlo con un control que participa en la representación parcial de páginas. |
RegisterClientScriptResource(Page, Type, String)
Registra un archivo de script de cliente incrustado en un ensamblado con el ScriptManager control cada vez que se produce una devolución de entrada.
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)Parámetros
- page
- Page
Objeto de página que registra el script.
- type
- Type
Tipo del script de cliente. Normalmente, este parámetro se especifica mediante el operador typeof (C#) o el operador GetType (Visual Basic) para recuperar el tipo del control que registra el script.
- resourceName
- String
Identificador del recurso.
Excepciones
El recurso type 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 un postback asincrónico. 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 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.
Consulte también
Se aplica a
RegisterClientScriptResource(Control, Type, String)
Registra el script de cliente incrustado en un ensamblado con el ScriptManager control para usarlo con un control que participa en la representación parcial de páginas.
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)Parámetros
- control
- Control
Control que registra el script.
- type
- Type
Tipo del script de cliente. Normalmente, este parámetro se especifica mediante el operador typeof (C#) o el operador GetType (Visual Basic) para recuperar el tipo del control que registra el script.
- resourceName
- String
Identificador del recurso.
Excepciones
El recurso type de cliente es null.
O bien
El control que registra el script es null.
El control que registra el script no está en el árbol de control 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 RegisterClientScriptIncludeRegisterClientScriptResource 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.
