ClientScriptManager.RegisterArrayDeclaration(String, String) Methode

Definition

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Registriert eine JavaScript-Arraydeklaration mit dem Page Objekt unter Verwendung eines Arraynamens und eines Arraywerts.

public:
 void RegisterArrayDeclaration(System::String ^ arrayName, System::String ^ arrayValue);
public void RegisterArrayDeclaration(string arrayName, string arrayValue);
member this.RegisterArrayDeclaration : string * string -> unit
Public Sub RegisterArrayDeclaration (arrayName As String, arrayValue As String)

Parameter

arrayName
String

Der arrayname, der registriert werden soll.

arrayValue
String

Der arraywert oder die zu registrierenden Werte.

Ausnahmen

ArgumentNullException

arrayName ist null.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der RegisterArrayDeclaration Methoden veranschaulicht RegisterHiddenField . Im Beispiel wird ein Array und ein ausgeblendeter Wert registriert und das OnClick Ereignis einer <input> Schaltfläche definiert, um die Summe zweier Werte des Arrays und des ausgeblendeten Werts zu berechnen.

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

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)

    ' Define the array name and values.
    Dim arrName As String = "MyArray"
    Dim arrValue As String = """1"", ""2"", ""text"""
    
    ' Define the hidden field name and initial value.
    Dim hiddenName As String = "MyHiddenField"
    Dim hiddenValue As String = "3"
    
    ' Define script name and type.
    Dim csname As String = "ConcatScript"
    Dim cstype As Type = Me.GetType()
        
    ' Get a ClientScriptManager reference from the Page class.
    Dim cs As ClientScriptManager = 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 (Not cs.IsClientScriptBlockRegistered(cstype, csname)) Then
      Dim cstext As StringBuilder = 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)
    End If
    
  End Sub
  
</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>

Hinweise

Die RegisterArrayDeclaration Überprüfungen, um festzustellen, ob ein registriertes Array mit demselben Namen wie der im arrayName Parameter angegebene Name vorhanden ist, und fügt ggf. die im arrayValue Parameter angegebenen Werte hinzu. Da der zugrunde liegende Speichermechanismus auf einem ArrayListDuplikat basiert, sind Duplikate zulässig. Wenn ein registriertes Array mit demselben Namen wie der arrayName Parameter nicht vorhanden ist, wird es erstellt und die Werte im arrayValue Parameter hinzugefügt.

Wenn Sie Zeichenfolgenliterale im resultierenden JavaScript-Array verwenden möchten, schließen Sie einfache Anführungszeichen (') oder escaped doppelte Anführungszeichen (\") in den arrayValue Parameter ein. Der Wert des arrayValue Parameters sollte ein einzelnes Element sein. Wenn dem Array mehrere Werte hinzugefügt werden müssen, führen Sie mehrere Aufrufe mithilfe der RegisterArrayDeclaration Methode aus.

Gilt für:

Weitere Informationen