Página de inicio Biblioteca Aprender Descargas Soporte técnico Comunidad
Iniciar sesión | United States - English | |
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original
Este tema aún no ha recibido ninguna valoración - Valorar este tema

ClientScriptManager (Clase)

.NET Framework 4

Define los métodos para la administración de scripts de cliente en aplicaciones web.

System.Object
  System.Web.UI.ClientScriptManager

Espacio de nombres:  System.Web.UI
Ensamblado:  System.Web (en System.Web.dll)
C#
C++
F#
VB
Copiar 
public sealed class ClientScriptManager

El tipo ClientScriptManager expone los siguientes miembros.

  Nombre Descripción
Método público Equals(Object) Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
Método protegido Finalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método público GetCallbackEventReference(Control, String, String, String) Obtiene una referencia a una función de cliente que, cuando se invoca, inicia una devolución de llamada del cliente a un evento de servidor. La función de cliente para este método sobrecargado incluye un control, un argumento, un script de cliente y un contexto especificados.
Método público GetCallbackEventReference(Control, String, String, String, Boolean) Obtiene una referencia a una función de cliente que, cuando se invoca, inicia una devolución de llamada del cliente a los eventos de servidor. La función de cliente para este método sobrecargado incluye un control, un argumento, un script de cliente, un contexto y un valor booleano especificados.
Método público GetCallbackEventReference(Control, String, String, String, String, Boolean) Obtiene una referencia a una función de cliente que, cuando se invoca, inicia una devolución de llamada del cliente a los eventos de servidor. La función de cliente para este método sobrecargado incluye un control, un argumento, un script de cliente, un contexto, un controlador de errores y un valor booleano especificados.
Método público GetCallbackEventReference(String, String, String, String, String, Boolean) Obtiene una referencia a una función de cliente que, cuando se invoca, inicia una devolución de llamada del cliente a los eventos de servidor. La función de cliente para este método sobrecargado incluye un destino, un argumento, un script de cliente, un contexto, un controlador de errores y un valor booleano especificados.
Método público GetHashCode Actúa como función hash para un tipo concreto. (Se hereda de Object).
Método público GetPostBackClientHyperlink(Control, String) Obtiene una referencia, con javascript: anexado al principio, que se puede utilizar en un evento de devolución de datos del cliente al servidor para el control especificado y con los argumentos de evento especificados.
Método público GetPostBackClientHyperlink(Control, String, Boolean) Obtiene una referencia, con javascript: anexado al principio, que se puede utilizar en un evento de devolución de datos del cliente al servidor para el control especificado y con los argumentos de evento especificados y, también, con una indicación booleana de si se debe registrar la devolución de datos para realizar la validación del evento.
Método público GetPostBackEventReference(PostBackOptions) Devuelve una cadena que se puede utilizar en un evento de cliente para que se produzca una devolución de datos al servidor. La instancia PostBackOptions especificada define la cadena de referencia.
Método público GetPostBackEventReference(Control, String) Devuelve una cadena que se puede utilizar en un evento de cliente para que se produzca una devolución de datos al servidor. El control especificado para controlar la devolución de datos y un argumento de cadena con información adicional sobre el evento definen la cadena de referencia.
Método público GetPostBackEventReference(PostBackOptions, Boolean) Devuelve una cadena que se puede utilizar en un evento de cliente para que se produzca una devolución de datos al servidor. El objeto PostBackOptions especificado define la cadena de referencia. Opcionalmente, registra la referencia de evento para su validación.
Método público GetPostBackEventReference(Control, String, Boolean) Devuelve una cadena que se debe utilizar en un evento de cliente para que se produzca una devolución de datos al servidor. El control especificado para controlar la devolución de datos y un argumento de cadena con información adicional sobre el evento definen la cadena de referencia. Opcionalmente, registra la referencia de evento para su validación.
Método público GetType Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método público GetWebResourceUrl Obtiene una referencia de la dirección URL de un recurso en un ensamblado.
Método público IsClientScriptBlockRegistered(String) Determina si el bloque de script de cliente se encuentra registrado con el objeto Page utilizando la clave especificada.
Método público IsClientScriptBlockRegistered(Type, String) Determina si el bloque de script de cliente se encuentra registrado con el objeto Page utilizando una clave y un tipo.
Método público IsClientScriptIncludeRegistered(String) Determina si la inclusión de script de cliente se encuentra registrada con el objeto Page utilizando la clave especificada.
Método público IsClientScriptIncludeRegistered(Type, String) Determina si la inclusión de script de cliente se encuentra registrada con el objeto Page utilizando una clave y un tipo.
Método público IsOnSubmitStatementRegistered(String) Determina si la instrucción OnSubmit se encuentra registrada con el objeto Page utilizando la clave especificada.
Método público IsOnSubmitStatementRegistered(Type, String) Determina si la instrucción OnSubmit se encuentra registrada con el objeto Page utilizando la clave y el tipo especificados.
Método público IsStartupScriptRegistered(String) Determina si el script de inicio se encuentra registrado con el objeto Page utilizando la clave especificada.
Método público IsStartupScriptRegistered(Type, String) Determina si el script de inicio se encuentra registrado con el objeto Page utilizando la clave y el tipo especificados.
Método protegido MemberwiseClone Crea una copia superficial del objeto Object actual. (Se hereda de Object).
Método público RegisterArrayDeclaration Registra una declaración de matriz JavaScript con el objeto Page utilizando un nombre y un valor de matriz.
Método público RegisterClientScriptBlock(Type, String, String) Registra el script de cliente con el objeto Page utilizando un tipo, clave y literal de script.
Método público RegisterClientScriptBlock(Type, String, String, Boolean) Registra el script de cliente con el objeto Page utilizando un tipo, clave, literal de script y valor booleano que indican si se agregan etiquetas de script.
Método público RegisterClientScriptInclude(String, String) Registra el script de cliente con el objeto Page utilizando una clave y una dirección URL que permiten que se llame desde el script del cliente.
Método público RegisterClientScriptInclude(Type, String, String) Registra la inclusión de script de cliente con el objeto Page utilizando un tipo, una clave y una dirección URL.
Método público RegisterClientScriptResource Registra el recurso de script de cliente con el objeto Page utilizando un tipo y un nombre de recurso.
Método público RegisterExpandoAttribute(String, String, String) Registra un par de nombre y valor como atributo personalizado (expando) del control especificado incluyendo un Id. de control, nombre de atributo y valor de atributo.
Método público RegisterExpandoAttribute(String, String, String, Boolean) Registra un par de nombre y valor como atributo personalizado (expando) del control especificado proporcionando un Id. de control, un nombre de atributo, un valor de atributo y un valor booleano que indica si se codifica el valor de atributo.
Método público RegisterForEventValidation(PostBackOptions) Registra una referencia de evento para su validación con PostBackOptions.
Método público RegisterForEventValidation(String) Registra una referencia de evento para su validación con un identificador de control único que representa el control de cliente que genera el evento.
Método público RegisterForEventValidation(String, String) Registra una referencia de evento para su validación con un identificador de control único y argumentos de evento que representan el control de cliente que genera el evento.
Método público RegisterHiddenField Registra un valor oculto con el objeto Page.
Método público RegisterOnSubmitStatement Registra una instrucción OnSubmit con el objeto Page utilizando un tipo, una clave y un literal de script. La instrucción se ejecuta cuando se envía el objeto HtmlForm.
Método público RegisterStartupScript(Type, String, String) Registra el script de inicio con el objeto Page utilizando un tipo, una clave y un literal de script.
Método público RegisterStartupScript(Type, String, String, Boolean) Registra el script de inicio con el objeto Page utilizando un tipo, una clave, un literal de script y un valor booleano que indican si se agregan etiquetas de script.
Método público ToString Devuelve una cadena que representa el objeto actual. (Se hereda de Object).
Método público ValidateEvent(String) Valida un evento de cliente que se registró para la validación de eventos mediante el método RegisterForEventValidation.
Método público ValidateEvent(String, String) Valida un evento de cliente que se registró para la validación del evento mediante el método RegisterForEventValidation.
Arriba

La clase ClientScriptManager se utiliza para administrar los scripts de cliente y agregarlos a las aplicaciones web. Puede obtener una referencia a la clase ClientScriptManager desde la propiedad ClientScript del objeto Page.

Mediante declaración puede agregar un script de cliente a una página web incluyendo el script en el marcado HTML de la página. Sin embargo, hay situaciones en las que se necesita agregar dinámicamente el script de cliente. Para agregar dinámicamente un script, utilice los métodos RegisterClientScriptBlock, RegisterClientScriptInclude, RegisterStartupScript o RegisterOnSubmitStatement, dependiendo de cuándo y cómo desee agregar el script. Para obtener más información, vea Cómo: Agregar script de cliente a las páginas Web ASP.NET dinámicamente.

La clase ClientScriptManager identifica de forma única los scripts por un objeto String clave y un objeto Type. Los scripts de la misma clave y tipo se consideran duplicados. La utilización del tipo de script ayuda a evitar la confusión entre scripts similares de controles de usuario diferentes que podrían utilizarse en la página.

Se puede utilizar la clase ClientScriptManager para invocar las devoluciones de llamada del cliente en aquellas situaciones en la que es deseable ejecutar código de servidor desde el cliente sin realizar una devolución de datos. Este procedimiento se denomina realizar una devolución de llamada fuera de banda al servidor. En una devolución de llamada de cliente, una función de script de cliente envía una solicitud asincrónica a una página web ASP.NET. La página Web ejecuta una versión modificada de su ciclo de vida normal para procesar la devolución de llamada. Utilice el método GetCallbackEventReference para obtener una referencia a una función de cliente que, cuando se invoca, inicia una devolución de llamada de cliente a los eventos del servidor. Para obtener más información, vea Implementar mediante programación devoluciones de llamada de cliente sin postbacks en páginas web de ASP.NET.

Nota Nota

Las devoluciones de llamada de scripts no funcionan en los exploradores más antiguos que no admiten el Document Object Model (DOM) y requieren que ECMAScript esté habilitado en el cliente. Para comprobar si el explorador admite las devoluciones de llamada, utilice la propiedad SupportsCallback que es accesible a través de la propiedad Browser del objeto Request intrínseco de ASP.NET.

Utilice los métodos GetPostBackEventReference y GetPostBackClientHyperlink para definir un evento de devolución de datos de cliente. Cuando se invocan, estos métodos habilitan las funciones de script de cliente para que el servidor devuelva los datos a la página. Un evento de devolución de datos de cliente es diferente de una devolución de llamada de cliente en que la página Web finaliza un ciclo de vida normal para procesar el evento de devolución de datos de cliente.

Nota Nota

Si está utilizando un control Button y la propiedad UseSubmitBehavior se establece en false, puede utilizar el método GetPostBackEventReference para devolver el evento de devolución de datos de cliente para el control Button.

Se puede utilizar la propiedad OnClientClick del control Button, el control ImageButton y el control LinkButton para ejecutar el script de cliente.

En el ejemplo de código siguiente se muestra cómo usar el método RegisterClientScriptBlock de la clase ClientScriptManager. En la página, se definen dos scripts de cliente: PopupScript, que muestra un mensaje de alerta cuando la página está cargada y ButtonClickScript, que define un controlador del cliente para un evento onClick de un botón HTML.

C#
VB
Copiar 

<%@ Page Language="C#"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  public void Page_Load(Object sender, EventArgs e)
  {
    // Define the name and type of the client scripts on the page.
    String csname1 = "PopupScript";
    String csname2 = "ButtonClickScript";
    Type cstype = this.GetType();

    // Get a ClientScriptManager reference from the Page class.
    ClientScriptManager cs = Page.ClientScript;

    // Check to see if the startup script is already registered.
    if (!cs.IsStartupScriptRegistered(cstype, csname1))
    {
      String cstext1 = "alert('Hello World');";
      cs.RegisterStartupScript(cstype, csname1, cstext1, true);
    }

    // Check to see if the client script is already registered.
    if (!cs.IsClientScriptBlockRegistered(cstype, csname2))
    {
      StringBuilder cstext2 = new StringBuilder();
      cstext2.Append("<script type=\"text/javascript\"> function DoClick() {");
      cstext2.Append("Form1.Message.value='Text from client script.'} </");
      cstext2.Append("script>");
      cs.RegisterClientScriptBlock(cstype, csname2, cstext2.ToString(), false);
    }
  }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form id="Form1"
         runat="server">
        <input type="text" id="Message" /> <input type="button" value="ClickMe" onclick="DoClick()" />
     </form>
  </body>
</html>

.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
¿Le ha resultado útil?
(Caracteres restantes: 1500)
Contenido de la comunidad Agregar
Anotaciones Preguntas más frecuentes