Sdílet prostřednictvím


IExtenderControl Rozhraní

Definice

Definuje chování pro ovládací prvek rozšířeného ovládacího prvku.

public interface class IExtenderControl
public interface IExtenderControl
type IExtenderControl = interface
Public Interface IExtenderControl
Odvozené

Poznámky

Rozšířené ovládací prvky, které jsou odvozeny od ExtenderControl třídy, vyžadují, ScriptManager aby byl ovládací prvek na stránce. ExtenderControlZákladní třída provede explicitní test, aby bylo zajištěno, že ScriptManager ovládací prvek na stránce existuje.

Nicméně pokud chcete vytvořit rozšířené ovládací prvky a stránka neobsahuje ScriptManager ovládací prvek, můžete vytvořit třídu, která implementuje IExtenderControl rozhraní přímo. Kromě toho, pokud vytváříte třídu, která je odvozena z Control nebo rozšiřujete existující ovládací prvek, který je odvozen z Control , můžete implementovat IExtenderControl rozhraní pro podporu funkčnosti klienta.

IExtenderControlRozhraní registruje knihovny skriptů pro ovládací prvek voláním GetScriptReferences metody a registruje ScriptDescriptor objekty voláním GetScriptDescriptors metody. GetScriptDescriptorsMetoda vrátí IEnumerable seznam ScriptDescriptor objektů.

Poznámka

Pokud rozšíříte existující typ ovládacího prvku, který je odvozen z WebControl třídy, implementujte IScriptControl rozhraní.

Chcete-li vytvořit ovládací prvek rozšířeného ovládacího prvku implementací IExtenderControl , proveďte následující:

  • Napište kód pro událost ovládacího prvku OnInit pro detekci a použití ScriptManager ovládacího prvku, pokud je k dispozici na stránce.

  • Pokud ScriptManager není na stránce k dispozici, poskytněte alternativní způsob registrace požadovaných skriptů voláním statických metod ScriptManager třídy.

  • Poskytněte chráněným virtuálním členům IExtenderControl členy.

  • Poskytněte skript instance jako blok skriptu, který se zaregistrujete s ScriptManager ovládacím prvkem. To je nutné provést během událostí ovládacího prvku PreRender , PreRenderComplete nebo Render .

  • Zaregistrujte popisovače skriptu během události ovládacího prvku Render .

Poznámka

Pokud stránka obsahuje UpdatePanel ovládací prvek, stránka musí obsahovat ScriptManager ovládací prvek. Rozhraní je nutné implementovat IExtenderControl pouze v případě, že stránka neobsahuje ScriptManager ovládací prvek.

Metody

GetScriptDescriptors(Control)

Zaregistruje ScriptDescriptor objekty pro ovládací prvek a vrátí objekt, který obsahuje ScriptDescriptor objekty ovládacího prvku.

GetScriptReferences()

Zaregistruje knihovny skriptů pro ovládací prvek a vrátí výčet souborů ECMAScript (JavaScript), které byly zaregistrovány jako integrované prostředky.

Platí pro

Viz také