IExtenderControl Gränssnitt

Definition

Namnområde:
System.Web.UI
Sammansättning:
System.Web.Extensions.dll

Definierar beteendet för en utökarkontroll.

public interface class IExtenderControl
public interface IExtenderControl
type IExtenderControl = interface
Public Interface IExtenderControl
Härledda

Kommentarer

Extender-kontroller som härleds från ExtenderControl klassen kräver att en ScriptManager kontroll finns på sidan. Basklassen ExtenderControl utför ett explicit test för att se till att det finns en ScriptManager kontroll på sidan.

Men om du vill skapa utökarkontroller och sidan inte innehåller någon ScriptManager kontroll kan du skapa en klass som implementerar IExtenderControl gränssnittet direkt. Om du skapar en klass som härleds från Control eller om du utökar en befintlig kontroll som härleds från Controlkan du implementera IExtenderControl gränssnittet för att stödja klientfunktioner.

Gränssnittet IExtenderControl registrerar skriptbiblioteken för en kontroll genom att anropa GetScriptReferences metoden och registrerar ScriptDescriptor objekt genom att anropa GetScriptDescriptors metoden. Metoden GetScriptDescriptors returnerar en IEnumerable lista över ScriptDescriptor objekt.

Note

Om du utökar en befintlig kontrolltyp som härleds från WebControl klassen implementerar du IScriptControl gränssnittet.

Om du vill skapa en utökarkontroll genom att implementera IExtenderControlgör du följande:

  • Skriv kod för kontrollens OnInit händelse för att identifiera och använda ScriptManager kontrollen om den är tillgänglig på sidan.

  • Om det ScriptManager inte är tillgängligt på sidan kan du ange alternativa sätt att registrera nödvändiga skript genom att anropa statiska metoder för ScriptManager klassen.

  • Ange skyddade virtuella medlemmar för IExtenderControl medlemmar.

  • Ange instansskriptet som ett skriptblock som du registrerar med ScriptManager kontrollen. Du måste göra detta under kontrollens PreRender, PreRenderCompleteeller Render händelser.

  • Registrera skriptbeskrivningarna under kontrollens Render händelse.

Note

Om sidan innehåller en UpdatePanel kontroll måste sidan innehålla en ScriptManager kontroll. Du måste bara implementera IExtenderControl gränssnittet när sidan inte innehåller någon ScriptManager kontroll.

Metoder

Name Description
GetScriptDescriptors(Control)

Registrerar objekten ScriptDescriptor för kontrollen och returnerar ett objekt som innehåller objekten ScriptDescriptor för kontrollen.
GetScriptReferences()

Registrerar skriptbiblioteken för kontrollen och returnerar en uppräkning av ECMAScript-filer (JavaScript) som har registrerats som inbäddade resurser.

Gäller för

Se även