Exportar (0) Imprimir
Expandir todo

ClientScriptManager.RegisterArrayDeclaration (Método)

Registra una declaración de matriz JavaScript con el objeto Page utilizando un nombre y un valor de matriz.

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

public void RegisterArrayDeclaration (
	string arrayName,
	string arrayValue
)
public void RegisterArrayDeclaration (
	String arrayName, 
	String arrayValue
)
public function RegisterArrayDeclaration (
	arrayName : String, 
	arrayValue : String
)
No aplicable.

Parámetros

arrayName

Nombre de matriz que se va a registrar.

arrayValue

Valor o valores de matriz que se va a registrar.

Tipo de excepciónCondición

ArgumentNullException

El valor de arrayName es referencia null (Nothing en Visual Basic).

El método RegisterArrayDeclaration comprueba si una matriz registrada existe con el mismo nombre que el nombre especificado en el parámetro arrayName y, en ese caso, agrega los valores especificados en el parámetro arrayValue. Dado que el mecanismo de almacenamiento subyacente se basa en el objeto ArrayList, se permiten duplicados. Si una matriz registrada con el mismo nombre que el parámetro arrayName no existe, se crea y se le agregan los valores en el parámetro arrayValue.

Si quiere literales de cadena en la matriz JavaScript resultante, incluya comillas simples (') o comillas doble (\") de escape en el parámetro arrayValue. Además, JavaScript trata la coma (,) como un delimitador de elementos en una matriz. La separación de dos elementos con una coma en el parámetro arrayValue tendrá el mismo efecto que llamar dos veces al método RegisterArrayDeclaration, una vez para cada elemento.

En el ejemplo de código siguiente se muestra el uso de los métodos RegisterArrayDeclaration y RegisterHiddenField. El ejemplo registra una matriz y un valor oculto y define el evento OnClick de un botón <input> para calcular la suma de dos valores de la matriz y el valor oculto.

<%@ 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 array name and values.
    String arrName = "MyArray";
    String arrValue = "\"1\", \"2\", \"text\"";
    
    // Define the hidden field name and initial value.
    String hiddenName = "MyHiddenField";
    String hiddenValue = "3";
    
    // Define script name and type.
    String csname = "ConcatScript";
    Type cstype = this.GetType();
        
    // Get a ClientScriptManager reference from the Page class.
    ClientScriptManager cs = Page.ClientScript;

    // Register the array with the Page class.
    cs.RegisterArrayDeclaration(arrName, arrValue);

    // Register the hidden field with the Page class.
    cs.RegisterHiddenField(hiddenName, hiddenValue);

    // Check to see if the  script is already registered.
    if (!cs.IsClientScriptBlockRegistered(cstype, csname))
    {
      StringBuilder cstext = new StringBuilder();
      cstext.Append("<script type=\"text\"/javascript> function DoClick() {");
      cstext.Append("Form1.Message.value='Sum = ' + ");
      cstext.Append("(parseInt(" + arrName + "[0])+");
      cstext.Append("parseInt(" + arrName + "[1])+");
      cstext.Append("parseInt(" + Form1.Name + "." + hiddenName + ".value));} </");
      cstext.Append("script>");
      cs.RegisterClientScriptBlock(cstype, csname, cstext.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" 
            onclick="DoClick()" 
            value="Run Script" />
     </form>
  </body>
</html>

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0
Mostrar:
© 2015 Microsoft