IExtenderControl Rozhraní

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.Extensions.dll

Definuje chování pro ovládací prvek extenderu.

public interface class IExtenderControl

public interface IExtenderControl

type IExtenderControl = interface

Public Interface IExtenderControl

Odvozené

System.Web.UI.ExtenderControl

Poznámky

Rozšiřující ovládací prvky odvozené z ExtenderControl třídy vyžadují ScriptManager , aby byl ovládací prvek na stránce. Základní ExtenderControl třída provádí explicitní test, aby se ujistil, že ScriptManager ovládací prvek existuje na stránce.

Pokud však chcete vytvořit rozšiřující 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 nebo Control rozšiřujete existující ovládací prvek odvozený z Control, můžete implementovat IExtenderControl rozhraní pro podporu klientských funkcí.

Rozhraní IExtenderControl zaregistruje knihovny skriptů pro ovládací prvek voláním GetScriptReferences metody a zaregistruje ScriptDescriptor objekty voláním GetScriptDescriptors metody. Metoda GetScriptDescriptors vrátí IEnumerable seznam ScriptDescriptor objektů.

Note

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

Pokud chcete vytvořit ovládací prvek extenderu implementací IExtenderControl, postupujte takto:

• Napište kód události ovládacího prvku OnInit , který rozpozná a použije ScriptManager ovládací prvek, pokud je k dispozici na stránce.

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

• Poskytnutí chráněných virtuálních členů členům IExtenderControl

• Zadejte skript instance jako blok skriptu, který zaregistrujete v ovládacím ScriptManager prvku. Musíte to provést během ovládacího prvku PreRender, PreRenderCompletenebo Render událostí.

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

Note

Pokud stránka obsahuje UpdatePanel ovládací prvek, musí stránka obsahovat ScriptManager ovládací prvek. Rozhraní musíte implementovat IExtenderControl pouze v případech, kdy stránka neobsahuje ScriptManager ovládací prvek.

Metody

Name	Description
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 registrovány jako vložené prostředky.

Viz také

• ExtenderControl
• ScriptManager