ScriptManager.RegisterDispose(Control, String) Metoda

Definicja

Przestrzeń nazw:

System.Web.UI

Zestaw:

System.Web.Extensions.dll

dispose Rejestruje skrypt dla kontrolki, która znajduje się wewnątrz kontrolkiUpdatePanel. Skrypt jest wykonywany po zaktualizowaniu lub usunięciu UpdatePanel kontrolki.

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)

Parametry

control

Control

Kontrolka, dla którego dispose jest przeznaczony skrypt.

disposeScript

String

Skrypt dispose .

Wyjątki

ArgumentNullException

control to null.

-lub-

disposeScript to null.

ArgumentException

control nie można odnaleźć na stronie.

-lub-

control nie znajduje się wewnątrz kontrolki UpdatePanel .

Uwagi

RegisterDispose Użyj metody , aby zarejestrować dispose skrypty dla kontrolek, które znajdują się wewnątrz kontrolkiUpdatePanel. Podczas asynchronicznych ogłaszania zwrotnego można aktualizować, usuwać lub tworzyć kontrolki UpdatePanel . Po zaktualizowaniu lub usunięciu panelu wywoływane są wszystkie dispose skrypty zarejestrowane dla kontrolek, które znajdują się wewnątrz.UpdatePanel W typowych scenariuszach tworzenia stron nie trzeba wywoływać RegisterDispose metody .

Metoda jest przeznaczona RegisterDispose do użycia przez deweloperów kontrolek do rejestrowania skryptu lub tworzenia kontrolek dziedzicujących po interfejsie IScriptControl . Na przykład można użyć skryptu dispose , jeśli tworzysz kontrolkę klienta przy użyciu kompozycji. W kontrolce zaimplementujesz IScriptControl i renderujesz poszczególne kontrolki. Należy zarejestrować metodę dispose dowolnego elementu, który nie odpowiada zdefiniowanemu składnikowi klienta, takie jak Sys.TextBox. Jeśli kontrolka niestandardowa komponuje elementy odpowiadające składnikom klienta w bibliotece Microsoft Ajax, nie trzeba rejestrować skryptudispose, ponieważ dispose jest wywoływana automatycznie. W związku z tym należy użyć RegisterDispose metody dla składników klienta, które są częścią biblioteki Microsoft Ajax i które muszą zwalniać zasoby, gdy składnik nie jest już używany.

Metodę RegisterDispose można wywołać wiele razy dla kontrolki. Wiele skryptów jest agregowanych. Kolejność rozpraszania skryptów jest zgodna z kolejnością zarejestrowania skryptów.

Jeśli zarejestrujesz dispose skrypt dla kontrolki, która nie znajduje się w kontrolce UpdatePanel , zostanie zgłoszony wyjątek. Skrypt dispose jest wywoływany pageLoading między zdarzeniami PageRequestManager i pageLoaded klasy .

Zobacz też

• IScriptControl