ScriptManager.RegisterArrayDeclaration 메서드

정의

ScriptManager 컨트롤 내에 있는 컨트롤과 함께 사용할 UpdatePanel 컨트롤을 사용하여 ECMAScript(JavaScript) 배열 선언을 등록한 후 해당 배열을 페이지에 추가합니다.

오버로드

RegisterArrayDeclaration(Control, String, String)

ScriptManager 컨트롤 내에 있는 컨트롤과 함께 사용할 UpdatePanel 컨트롤을 사용하여 ECMAScript(JavaScript) 배열 선언을 등록한 후 해당 배열을 페이지에 추가합니다.

RegisterArrayDeclaration(Page, String, String)

ScriptManager 컨트롤 내에 있는 컨트롤과 함께 사용할 UpdatePanel 컨트롤을 사용하여 ECMAScript(JavaScript) 배열 선언을 등록한 후 해당 배열을 페이지에 추가합니다.

RegisterArrayDeclaration(Control, String, String)

ScriptManager 컨트롤 내에 있는 컨트롤과 함께 사용할 UpdatePanel 컨트롤을 사용하여 ECMAScript(JavaScript) 배열 선언을 등록한 후 해당 배열을 페이지에 추가합니다.

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 라이브러리 종속성이 없는 클라이언트 스크립트 배열을 등록합니다. 이 메서드는 업데이트되는 컨트롤 내에 있는 컨트롤을 나타낼 때 control 배열을 UpdatePanel 등록합니다. 비동기 포스트백이 발생할 때마다 배열을 등록하려면 이 메서드의 오버로드를 RegisterArrayDeclaration(Page, String, String) 사용합니다.

부분 페이지 업데이트와 관련이 없는 배열을 등록하고 초기 페이지 렌더링 중에 배열을 한 번만 등록하려면 클래스의 메서드를 RegisterArrayDeclaration ClientScriptManager 사용합니다. 페이지의 속성에서 개체에 ClientScriptManager 대한 참조를 ClientScript 가져올 수 있습니다.

메서드는 RegisterArrayDeclaration 매개 변수에 지정된 이름의 배열이 이미 등록되어 arrayName 있는지 여부를 결정합니다. 이 경우 메서드는 에 지정된 arrayValue값을 추가합니다. 등록할 배열은 클래스를 ArrayList 기반으로 하므로 중복이 허용됩니다. 이름이 arrayName 있는 등록된 배열이 없으면 배열이 만들어지고 해당 배열에 값 arrayValue 이 추가됩니다.

배열에 문자열 리터럴을 포함하려면 .에서 작은따옴표(') 또는 이스케이프된 큰따옴표(\") arrayValue를 사용합니다.

JavaScript는 쉼표(,)를 배열의 구분 기호로 처리합니다. 에 쉼표로 구분된 문자열을 전달하여 여러 배열 값을 지정할 수 있습니다 arrayValue. 두 항목을 쉼표 arrayValue 로 구분하는 것은 각 항목에 대해 한 번씩 메서드를 RegisterArrayDeclaration 두 번 호출하는 것과 같습니다.

추가 정보

적용 대상

RegisterArrayDeclaration(Page, String, String)

ScriptManager 컨트롤 내에 있는 컨트롤과 함께 사용할 UpdatePanel 컨트롤을 사용하여 ECMAScript(JavaScript) 배열 선언을 등록한 후 해당 배열을 페이지에 추가합니다.

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 라이브러리 종속성이 없는 클라이언트 스크립트 배열을 등록합니다. 이 메서드는 비동기 포스트백이 발생할 때마다 배열을 등록합니다. 패널이 업데이트될 때만 배열이 등록되도록 컨트롤 내에 UpdatePanel 있는 컨트롤에 대한 배열을 등록하려면 이 메서드의 오버로드를 RegisterArrayDeclaration(Control, String, String) 사용합니다.

부분 페이지 업데이트와 관련이 없는 배열을 등록하고 초기 페이지 렌더링 중에 배열을 한 번만 등록하려면 클래스의 메서드를 RegisterArrayDeclaration ClientScriptManager 사용합니다. 페이지의 속성에서 개체에 ClientScriptManager 대한 참조를 ClientScript 가져올 수 있습니다.

추가 정보

적용 대상