ScriptManager.RegisterDispose(Control, String) 메서드

정의

UpdatePanel 컨트롤 내에 있는 컨트롤에 대해 dispose 스크립트를 등록합니다. 스크립트는 UpdatePanel 컨트롤이 업데이트되거나 삭제될 때 실행됩니다.

public:
 void RegisterDispose(System::Web::UI::Control ^ control, System::String ^ disposeScript);
public void RegisterDispose (System.Web.UI.Control control, string disposeScript);
member this.RegisterDispose : System.Web.UI.Control * string -> unit
Public Sub RegisterDispose (control As Control, disposeScript As String)

매개 변수

control
Control

dispose 스크립트의 컨트롤입니다.

disposeScript
String

dispose 스크립트입니다.

예외

control이(가) null인 경우

또는 disposeScript이(가) null인 경우

control이 페이지에 없는 경우

또는 controlUpdatePanel 컨트롤 내에 있지 않은 경우

설명

이 메서드를 RegisterDispose 사용하여 컨트롤 내에 있는 컨트롤에 대한 스크립트를 UpdatePanel 등록 dispose 합니다. 비동기 포스트백 중에 컨트롤을 UpdatePanel 업데이트, 삭제 또는 만들 수 있습니다. 패널이 업데이트되거나 삭제되면 내부에 UpdatePanel 있는 컨트롤에 등록된 모든 dispose 스크립트가 호출됩니다. 일반적인 페이지 개발 시나리오에서는 메서드를 호출 RegisterDispose 할 필요가 없습니다.

RegisterDispose 메서드는 컨트롤 개발자가 스크립트를 등록하거나 인터페이스에서 IScriptControl 상속되는 컨트롤을 만드는 데 사용하기 위한 것입니다. 예를 들어 컴퍼지션을 dispose 사용하여 클라이언트 컨트롤을 개발하는 경우 스크립트를 사용할 수 있습니다. 컨트롤에서 개별 컨트롤을 구현 IScriptControl 하고 렌더링합니다. 와 같이 Sys.TextBox정의된 클라이언트 구성 요소에 해당하지 않는 항목의 메서드를 등록 dispose 합니다. 사용자 지정 컨트롤이 Microsoft Ajax 라이브러리의 클라이언트 구성 요소에 해당하는 요소를 구성하는 경우 자동으로 호출되므로 스크립트 disposedispose 등록할 필요가 없습니다. 따라서 Microsoft Ajax 라이브러리의 일부이며 구성 요소가 더 이상 사용되지 않을 때 리소스를 해제해야 하는 클라이언트 구성 요소에 메서드를 사용합니다 RegisterDispose .

컨트롤에 RegisterDispose 대해 메서드를 여러 번 호출할 수 있습니다. 여러 스크립트가 집계됩니다. 삭제 스크립트의 순서는 스크립트가 등록된 순서와 일치합니다.

컨트롤에 dispose 없는 UpdatePanel 컨트롤에 대한 스크립트를 등록하면 예외가 throw됩니다. 스크립트는 클래스의 pageLoading 이벤트와 pageLoaded 클래스 간에 호출됩니다PageRequestManager.dispose

적용 대상

추가 정보