ScriptManager.RegisterArrayDeclaration 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
使用 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
要註冊的一或多個陣列值。
例外狀況
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)
使用 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
要註冊的一或多個陣列值。
例外狀況
arrayName
為 null
。
備註
您可以使用 RegisterArrayDeclaration 方法來註冊與部分頁面轉譯相容的用戶端腳本陣列,而且沒有 Microsoft Ajax Library 相依性。 此方法會在每次發生非同步回傳時註冊陣列。 若要為控制項內的 UpdatePanel 控制項註冊陣列,以便只在更新面板時註冊陣列,請使用 RegisterArrayDeclaration(Control, String, String) 這個方法的多載。
如果您想要註冊與部分頁面更新無關的陣列,而且如果您想要在初始頁面轉譯期間只註冊陣列一次,請使用 RegisterArrayDeclaration 類別的 ClientScriptManager 方法。 您可以從頁面的 屬性取得 物件的 ClientScript 參考 ClientScriptManager 。