ScriptManager.RegisterDispose(Control, String) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
컨트롤 내부에 있는 dispose 컨트롤에 대한 스크립트를 등록합니다 UpdatePanel . 스크립트는 컨트롤이 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 .
예외
설명
이 메서드를 RegisterDispose 사용하여 컨트롤 내부에 있는 컨트롤에 대한 스크립트를 dispose 등록 UpdatePanel 합니다. 비동기 포스트백 UpdatePanel 중에 컨트롤을 업데이트, 삭제 또는 만들 수 있습니다. 패널이 업데이트되거나 삭제되면 내부에 dispose 있는 컨트롤에 대해 등록된 모든 UpdatePanel 스크립트가 호출됩니다. 일반적인 페이지 개발 시나리오에서는 메서드를 호출 RegisterDispose 할 필요가 없습니다.
이 RegisterDispose 메서드는 컨트롤 개발자가 스크립트를 등록하거나 인터페이스에서 IScriptControl 상속하는 컨트롤을 만드는 데 사용하기 위한 것입니다. 예를 들어 컴퍼지션을 dispose 사용하여 클라이언트 컨트롤을 개발하는 경우 스크립트를 사용할 수 있습니다. 컨트롤에서 개별 컨트롤을 구현 IScriptControl 하고 렌더링합니다. 와 같이 dispose정의된 클라이언트 구성 요소에 해당하지 않는 항목의 메서드를 등록 Sys.TextBox 합니다. 사용자 지정 컨트롤이 Microsoft Ajax 라이브러리의 클라이언트 구성 요소에 해당하는 요소를 구성하는 경우 dispose 자동으로 호출되므로 dispose 스크립트를 등록할 필요가 없습니다. 따라서 Microsoft Ajax 라이브러리의 일부이고 구성 요소가 더 이상 사용되지 않을 때 리소스를 해제해야 하는 클라이언트 구성 요소에 RegisterDispose 메서드를 사용합니다.
컨트롤에 RegisterDispose 대해 메서드를 여러 번 호출할 수 있습니다. 여러 스크립트가 집계됩니다. 삭제 스크립트의 순서는 스크립트가 등록된 순서와 일치합니다.
컨트롤에 dispose 없는 UpdatePanel 컨트롤에 대한 스크립트를 등록하면 예외가 throw됩니다.
dispose 이 스크립트는 클래스의 pageLoading 이벤트와 pageLoaded 클래스 간에 호출됩니다PageRequestManager.