Implementieren der Wiedergabe mit Vorlagen

Aktualisiert: November 2007

ASP.NET Mobile-Steuerelemente, die die Wiedergabe mit Vorlagen unterstützen, unterstützen auch eine Standardwiedergabe. Die Entscheidungen zur Verwendung von Vorlagen beim Erstellen der Wiedergabe können je nach Zielgerät unterschiedlich ausfallen. ASP.NET bietet eine Standardabfolge von Operationen, die eine gerätespezifische Wiedergabe mit Vorlagen ermöglicht. Mobile Steuerelemente, die eine Wiedergabe mit Vorlagen unterstützen, müssen die folgende Reihenfolge einhalten:

1. Das Steuerelement bestimmt mithilfe der IsTemplated-Eigenschaft, ob Gerätevorlagen definiert und ausgewählt werden. Verwenden Sie dazu die OnInit-Methode oder die CreateChildControls-Methode.

2. Wenn Vorlagen definiert sind, ruft das Steuerelement die CreateTemplatedUI-Methode auf, die das Steuerelement von der MobileControl-Basisklasse erbt.

   Hinweis:
   Rufen Sie CreateTemplatedUI nicht auf, wenn für das Steuerelement keine Vorlagen verwendet werden.

3. CreateTemplatedUI ruft die CreateTemplatedUI-Methode des Steuerelementadapters auf. Sie können Geräteadapter codieren, die diese Methode überschreiben, um eine gerätespezifische Wiedergabe mit Vorlagen zu implementieren.

4. Die Standardimplementierung der CreateTemplatedUI-Methode des Steuerelementadapters, die in der Basisklasse des Steuerelementadapters definiert ist, ruft wiederum die CreateDefaultTemplatedUI-Methode des Steuerelements auf. Sie können Steuerelemente codieren, die diese Methode überschreiben, um eine allgemeine Wiedergabe mit Vorlagen zu implementieren.

5. Das Steuerelement gibt Vorlagen durch die Render-Methode des Adapters wieder, indem es das untergeordnete Element des Steuerelements (in dem Instanzen von Vorlagen erstellt werden) wiedergibt.

Mobile Steuerelemente müssen Instanzen von neuen Vorlagen immer in einem Containersteuerelementtyp erstellen, der von TemplateContainer abgeleitet ist. Diese Regel wird strenger angewendet als die Regel für ASP.NET-Serversteuerelemente, bei der das Steuerelement nur die INamingContainer-Markierungsschnittstelle implementieren muss. Das folgende Codebeispiel veranschaulicht das Erstellen einer Instanz von einer Vorlage in einem mobilen Steuerelement.

void CreateChildTemplate(ITemplate template)
{
    TemplateContainer container = new TemplateContainer();
        template.InstantiateIn(container);
        container.DataBind();
        Controls.Add(container);
}

ItemCommand-Ereignisse

Bei einer Wiedergabe mit Vorlagen wird der ItemCommand-Ereignishandler durch den ASP.NET-Eventbubblingmechanismus aufgerufen. Dem Ereignishandler wird ein Parameter übergeben, der auf das Quellelement und auf die CommandName-Eigenschaft des Steuerelements zeigt, das das Ereignis generiert hat. Hiermit können Sie ein einzelnes Listenelement mit mehreren zugeordneten Interaktionen wiedergeben.

Bei der Standardwiedergabe stellt das Steuerelement eine einfache Benutzeroberfläche bereit, in der Benutzer auf eine Liste mit Elementen klicken können. Beim Postback ruft das Steuerelement den ItemCommand-Handler mit einem Argument auf, das auf das Quellelement zeigt. Die CommandName-Eigenschaft gibt null zurück.

Siehe auch

Aufgaben

Gewusst wie: Erstellen von vorlagenbasierten ASP.NET-Benutzersteuerelementen

Konzepte

Vorlagensätze und Steuerelemente mit Vorlagen

Weitere Ressourcen

Hinzufügen neuer Geräteadapter und Gerätunterstützung