Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.

Traducción

Original

Este tema aún no ha recibido ninguna valoración - Valorar este tema

ClientScriptManager.RegisterStartupScript (Método) (Type, String, String, Boolean)

.NET Framework 4.5

Otras versiones

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.

Espacio de nombres: System.Web.UI
Ensamblado: System.Web (en System.Web.dll)

Sintaxis

C++

public void RegisterStartupScript(
	Type type,
	string key,
	string script,
	bool addScriptTags
)

Parámetros

type: Tipo: System.Type
Tipo del script de inicio que se va a registrar.

key: Tipo: System.String
Clave del script de inicio que se va a registrar.

script: Tipo: System.String
Literal del script de inicio que se va a registrar.

addScriptTags: Tipo: System.Boolean
Valor booleano que indica si se agregan etiquetas de script.

Excepciones

Excepción	Condición
ArgumentNullException	type es null.

Comentarios

Un script de inicio se identifica de forma única mediante su clave y su tipo. Los scripts de la misma clave y tipo se consideran duplicados. Solamente se puede registrar un script con un par de clave y tipo específicos con la página. Al intentar registrar un script ya registrado no se crea un duplicado del mismo.

Llame al método IsStartupScriptRegistered para determinar si ya se encuentra registrado un script de inicio con par de clave y tipo específicos, y evitar innecesariamente agregar el script.

En esta sobrecarga del método RegisterStartupScript, puede indicar si el script proporcionado en el parámetro script se ajusta con un bloque de elemento <script> mediante el parámetro addScriptTags. El establecimiento del parámetro addScriptTags a true indica que automáticamente se agregarán etiquetas de script.

El bloque de script agregado por el método RegisterStartupScript ejecuta cuando finaliza la carga de la página pero antes de que se provoca el evento OnLoad de la página. No se garantiza que los bloques de script envíen los resultados en el orden en que están registrados. Si el orden de los bloques de scripts es importante, utilice un objeto StringBuilder para reunir los scripts en una sola cadena y registrarlos después en un solo bloque de script de cliente.

Ejemplos

En el ejemplo de código siguiente se muestra el uso del método RegisterStartupScript. Observe que el parámetro addScriptTags se establece en false por lo que las etiquetas de script de apertura y cierre se incluyen con el parámetro script.


<%@ 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>

Información de versión

.NET Framework

Compatible con: 4.5, 4, 3.5, 3.0, 2.0

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.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.

Vea también

Referencia

ClientScriptManager Clase

RegisterStartupScript (Sobrecarga)

System.Web.UI (Espacio de nombres)

RegisterStartupScript

Script

¿Te ha resultado útil? Sí No

No es preciso

No es lo suficientemente profundo

Se necesitan ejemplos de código adicionales

La traducción necesita mejoras

(Caracteres restantes: 1500)

Adiciones de comunidad

AGREGAR