ClientScriptManager.RegisterArrayDeclaration(String, String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Registriert unter Verwendung eines Arraynamens und eines Arraytyps eine JavaScript-Arraydeklaration für ein Page-Objekt.
public:
void RegisterArrayDeclaration(System::String ^ arrayName, System::String ^ arrayValue);public void RegisterArrayDeclaration (string arrayName, string arrayValue);member this.RegisterArrayDeclaration : string * string -> unitPublic Sub RegisterArrayDeclaration (arrayName As String, arrayValue As String)Parameter
- arrayName
- String
Der zu registrierende Arrayname.
- arrayValue
- String
Der zu registrierende Arraywert bzw. die zu registrierenden Arraywerte.
Ausnahmen
arrayName ist null.
Beispiele
Im folgenden Codebeispiel wird die Verwendung der RegisterArrayDeclaration Methoden und RegisterHiddenField veranschaulicht. Im Beispiel werden ein Array und ein ausgeblendeter Wert registriert und das OnClick Ereignis einer <input> Schaltfläche definiert, um die Summe der zwei 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üft, ob ein registriertes Array mit demselben Namen wie der im arrayName Parameter angegebene Name vorhanden ist, und fügt, falls ja, die im arrayValue Parameter angegebenen Werte hinzu. Da der zugrunde liegende Speichermechanismus auf einem ArrayListbasiert, 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, fügen Sie einfache Anführungszeichen (') oder doppelte Anführungszeichen mit Escapezeichen (\") in den arrayValue Parameter ein. Der Wert des arrayValue Parameters sollte ein einzelnes Element sein. Wenn dem Array mehr als ein Wert hinzugefügt werden muss, führen Sie mehrere Aufrufe mit der RegisterArrayDeclaration -Methode aus.
