ScriptManager.RegisterArrayDeclaration メソッド

定義

名前空間:

System.Web.UI

アセンブリ:

System.Web.Extensions.dll

UpdatePanel コントロール内のコントロールで使用できるように ECMAScript (JavaScript) 配列宣言を ScriptManager コントロールに登録し、配列をページに追加します。

オーバーロード

RegisterArrayDeclaration(Control, String, String)	UpdatePanel コントロール内のコントロールで使用できるように ECMAScript (JavaScript) 配列宣言を ScriptManager コントロールに登録し、配列をページに追加します。
RegisterArrayDeclaration(Page, String, String)	UpdatePanel コントロール内のコントロールで使用できるように ECMAScript (JavaScript) 配列宣言を ScriptManager コントロールに登録し、配列をページに追加します。

RegisterArrayDeclaration(Control, String, String)

UpdatePanel コントロール内のコントロールで使用できるように ECMAScript (JavaScript) 配列宣言を ScriptManager コントロールに登録し、配列をページに追加します。

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 ライブラリの依存関係がないクライアント スクリプト配列を登録します。 このメソッドは、更新中のコントロール内にあるコントロールを表すとき control に配列を UpdatePanel 登録します。 非同期ポストバックが発生するたびに配列を登録するには、このメソッドのオーバーロードを RegisterArrayDeclaration(Page, String, String) 使用します。

部分ページ更新に関連しない配列を登録し、初期ページレンダリング中に配列を 1 回だけ登録する場合は、クラスのメソッドをRegisterArrayDeclarationClientScriptManager使用します。 ページのプロパティからオブジェクトへの ClientScriptManager 参照を ClientScript 取得できます。

このメソッドは RegisterArrayDeclaration 、パラメーターで指定された名前の配列が既に arrayName 登録されているかどうかを判断します。 その場合、メソッドはで指定された arrayValue値を追加します。 登録する配列はクラスに ArrayList 基づいているため、重複が許可されます。 名前が入力 arrayName された登録済み配列が存在しない場合は、配列が作成され、その配列に arrayValue 値が追加されます。

配列に文字列リテラルを含めるには、単一引用符 (') またはエスケープされた二重引用符 (\") arrayValueを使用します。

JavaScript では、コンマ (,) が配列内の区切り記号として扱われます。 でコンマ区切りの文字列 arrayValueを渡すことで、複数の配列値を指定できます。 コンマで arrayValue 2 つの項目を区切る方法は、メソッドを RegisterArrayDeclaration 2 回呼び出すのと同じで、項目ごとに 1 回です。

こちらもご覧ください

• RegisterArrayDeclaration(Page, String, String)

RegisterArrayDeclaration(Page, String, String)

UpdatePanel コントロール内のコントロールで使用できるように ECMAScript (JavaScript) 配列宣言を ScriptManager コントロールに登録し、配列をページに追加します。

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 ライブラリの依存関係がないクライアント スクリプト配列を登録します。 このメソッドは、非同期ポストバックが発生するたびに配列を登録します。 パネルが更新されたときにのみ配列が登録されるように、コントロール内にある UpdatePanel コントロールの配列を登録するには、このメソッドのオーバーロードを RegisterArrayDeclaration(Control, String, String) 使用します。

部分ページ更新に関連しない配列を登録し、初期ページレンダリング中に配列を 1 回だけ登録する場合は、クラスのメソッドをRegisterArrayDeclarationClientScriptManager使用します。 ページのプロパティからオブジェクトへの ClientScriptManager 参照を ClientScript 取得できます。

こちらもご覧ください

• RegisterArrayDeclaration(Control, String, String)