ScriptManager.RegisterArrayDeclaration 方法

定義

命名空間:

System.Web.UI

組件:

System.Web.Extensions.dll

使用 ScriptManager 控制項註冊 ECMAScript (JavaScript) 陣列宣告，以配合 UpdatePanel 控制項內部的控制項一起使用，並將陣列加入至網頁中。

多載

RegisterArrayDeclaration(Control, String, String)	使用 ScriptManager 控制項註冊 ECMAScript (JavaScript) 陣列宣告，以配合 UpdatePanel 控制項內部的控制項一起使用，並將陣列加入至網頁中。
RegisterArrayDeclaration(Page, String, String)	使用 ScriptManager 控制項註冊 ECMAScript (JavaScript) 陣列宣告，以配合 UpdatePanel 控制項內部的控制項一起使用，並將陣列加入至網頁中。

RegisterArrayDeclaration(Control, String, String)

使用 ScriptManager 控制項註冊 ECMAScript (JavaScript) 陣列宣告，以配合 UpdatePanel 控制項內部的控制項一起使用，並將陣列加入至網頁中。

public:
 static void RegisterArrayDeclaration(System::Web::UI::Control ^ control, System::String ^ arrayName, System::String ^ arrayValue);

public static void RegisterArrayDeclaration (System.Web.UI.Control control, string arrayName, string arrayValue);

static member RegisterArrayDeclaration : System.Web.UI.Control * string * string -> unit

Public Shared Sub RegisterArrayDeclaration (control As Control, arrayName As String, arrayValue As String)

參數

control

Control

要註冊陣列的控制項。

arrayName

String

要註冊的陣列名稱。

arrayValue

String

要註冊的一或多個陣列值。

例外狀況

ArgumentNullException

arrayName 為 null。

備註

您可以使用 RegisterArrayDeclaration 方法來註冊與部分頁面轉譯相容的用戶端腳本陣列，而且沒有 Microsoft Ajax Library 相依性。 這個方法會在 代表正在更新之 UpdatePanel 控制項內的控制項時 control ，註冊陣列。 若要在每次發生非同步回傳時註冊陣列，請使用 RegisterArrayDeclaration(Page, String, String) 此方法的多載。

如果您想要註冊與部分頁面更新無關的陣列，而且如果您想要在初始頁面轉譯期間只註冊陣列一次，請使用 RegisterArrayDeclaration 類別的 ClientScriptManager 方法。 您可以從頁面的 屬性取得 物件的 ClientScript 參考 ClientScriptManager 。

方法 RegisterArrayDeclaration 會判斷是否已登錄參數中所指定名稱的 arrayName 陣列。 如果是，方法會加入 中指定的 arrayValue 值。 由於要註冊的陣列是以 類別為基礎 ArrayList ，因此允許重複專案。 如果 中 arrayName 名稱為 的已註冊陣列不存在，則會建立陣列，並將 中的 arrayValue 值加入其中。

若要在陣列中包含字串常值，請使用單引號 (') 或逸出雙引號 (\ 「) 中的 arrayValue 。

請注意，JavaScript 會將逗號 (，) 視為陣列中的分隔符號。 您可以在 中 arrayValue 傳遞逗號分隔字串，以指定多個陣列值。 在 中 arrayValue 以逗號分隔兩個專案相當於呼叫 RegisterArrayDeclaration 方法兩次，每個專案一次。

另請參閱

• RegisterArrayDeclaration(Page, String, String)

RegisterArrayDeclaration(Page, String, String)

使用 ScriptManager 控制項註冊 ECMAScript (JavaScript) 陣列宣告，以配合 UpdatePanel 控制項內部的控制項一起使用，並將陣列加入至網頁中。

public:
 static void RegisterArrayDeclaration(System::Web::UI::Page ^ page, System::String ^ arrayName, System::String ^ arrayValue);

public static void RegisterArrayDeclaration (System.Web.UI.Page page, string arrayName, string arrayValue);

static member RegisterArrayDeclaration : System.Web.UI.Page * string * string -> unit

Public Shared Sub RegisterArrayDeclaration (page As Page, arrayName As String, arrayValue As String)

參數

page

Page

要註冊陣列的頁面物件。

arrayName

String

要註冊的陣列名稱。

arrayValue

String

要註冊的一或多個陣列值。

例外狀況

ArgumentNullException

arrayName 為 null。

備註

您可以使用 RegisterArrayDeclaration 方法來註冊與部分頁面轉譯相容的用戶端腳本陣列，而且沒有 Microsoft Ajax Library 相依性。 此方法會在每次發生非同步回傳時註冊陣列。 若要為控制項內的 UpdatePanel 控制項註冊陣列，以便只在更新面板時註冊陣列，請使用 RegisterArrayDeclaration(Control, String, String) 這個方法的多載。

如果您想要註冊與部分頁面更新無關的陣列，而且如果您想要在初始頁面轉譯期間只註冊陣列一次，請使用 RegisterArrayDeclaration 類別的 ClientScriptManager 方法。 您可以從頁面的 屬性取得 物件的 ClientScript 參考 ClientScriptManager 。

另請參閱

• RegisterArrayDeclaration(Control, String, String)