Gewusst wie: Erstellen eines LightSwitch-Steuerelements

Artikel
08/04/2015

LightSwitch-Steuerelemente sind die gängigste Methode, um die Darstellung und die Funktionalität einer LightSwitch-Anwendung anzupassen. Ein LightSwitch-Steuerelement ist einfach ein Silverlight-Steuerelement mit zusätzlich integrierter Funktionalität des LightSwitch-Modells. Steuerelemente können in LightSwitch auf zwei Arten hinzugefügt werden: als benutzerdefiniertes Steuerelement oder als Steuerelementerweiterung. Weitere Informationen zum Verwenden benutzerdefinierter Steuerelemente finden Sie unter Gewusst wie: Hinzufügen eines benutzerdefinierten Steuerelements zu einem Silverlight-Bildschirm.

Obwohl sich nahezu alle Silverlight-Steuerelemente direkt als benutzerdefinierte Steuerelemente in LightSwitch verwenden lassen, sprechen mehrere Gründe dafür, stattdessen eine Steuerelementerweiterung zu erstellen. Eine Steuerelementerweiterung kann von Anwendungen und Entwicklern einfacher gemeinsam genutzt werden. Zudem kann eine Erweiterung LightSwitch-spezifische Funktionen bereitstellen, was mit einem Silverlight-Steuerelement nicht möglich ist. Darüber hinaus können einige Steuerelementtypen (wie z. B. Gruppensteuerelemente) nur als Erweiterung erstellt werden, da sie die SupportedContentItemKind-Eigenschaft von LightSwitch implementieren müssen.

In der folgenden Tabelle werden die fünf Typen der Steuerelementerweiterungen aufgeführt, die Sie erstellen können:

Steuerelementtyp	Beschreibung
Wert	Stellt ein Inhaltselement für einen bestimmten Skalarwert eines einfachen Datentyps dar, die Visualisierung erfolgt über ein einzelnes Steuerelement.
Details	Stellt ein Inhaltselement für eine Entität oder einen komplexen Typ dar, die Visualisierung erfolgt über ein einzelnes Steuerelement oder über einzelne Felder mithilfe der untergeordneten Knotenelemente.
Befehl	Stellt ein Inhaltselement zur Initialisierung einer Aktion dar, beispielsweise Button oder Hyperlink.
Auflistung	Stellt ein Auflistungsinhaltselement dar, beispielsweise Grid oder ListBox.
Gruppe	Stellt ein Gruppeninhaltselement dar, beispielsweise TableLayout oder RowsLayout.

Die Schritte, die zum Erstellen einer Steuerelementerweiterung auszuführen sind, variieren ein wenig bei den verschiedenen Steuerelementen, das generelle Verfahren ist jedoch identisch. Dieses Dokument enthält eine Liste der erforderlichen und optionalen Schritte zum Erstellen einer Steuerelementerweiterung mit dem LightSwitch Extensibility Toolkit und bietet Links zu unterstützender Dokumentation.

Erforderliche Schritte zum Erstellen einer Steuerelementerweiterung

Erstellen Sie ein Erweiterungsprojekt, und fügen Sie dann die Vorlage Steuerelement hinzu. Weitere Informationen finden Sie unter Gewusst wie: Erstellen eines LightSwitch-Erweiterungsprojekts.
Aktualisieren Sie die Metadaten für SupportedContentItemKind und DisplayName. Weitere Informationen finden Sie unter "So aktualisieren Sie Steuerelement-Metadaten" in Exemplarische Vorgehensweise: Erstellen einer Smart-Layout-Erweiterung.

Sie können auch DisplayName als String-Ressource angeben. Weitere Informationen finden Sie unter "So aktualisieren Sie Steuerelement-Metadaten" und "So fügen Sie Ressourcenzeichenfolgen hinzu" in Exemplarische Vorgehensweise: Erstellen einer Detailsteuerelementerweiterung.
Bei Steuerelementen für Werte und Auflistungen aktualisieren Sie die SupportedDataType-Metadaten. Weitere Informationen finden Sie unter "So geben Sie unterstützte Datentypen an" in Exemplarische Vorgehensweise: Erstellen einer Wert-Steuerelementerweiterung.
Ersetzen Sie die Symbole für das Steuerelement. Weitere Informationen finden Sie unter "So aktualisieren Sie das Steuerelementsymbol" in Exemplarische Vorgehensweise: Erstellen einer Detailsteuerelementerweiterung.
Definieren Sie die Implementierung und die Benutzeroberfläche für das Steuerelement.

Die Detailangaben sind für jeden Steuerelementtyp unterschiedlich. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Erstellen einer Wert-Steuerelementerweiterung, Exemplarische Vorgehensweise: Erstellen einer Detailsteuerelementerweiterung, Exemplarische Vorgehensweise: Erstellen einer Smart-Layout-Erweiterung oder Exemplarische Vorgehensweise: Erstellen einer StackPanel-Steuerelementerweiterung.
Testen und Debuggen Sie das Steuerelement. Weitere Informationen finden Sie unter Gewusst wie: Debuggen oder Testen einer LightSwitch-Erweiterung.
Legen Sie Paketeigenschaften für das Steuerelement fest. Weitere Informationen finden Sie unter Gewusst wie: VSIX-Paketeigenschaften.
Verteilen Sie das Steuerelement. Weitere Informationen finden Sie unter Gewusst wie: Verteilen einer LightSwitch-Erweiterung.

Optionale Schritte zum Erstellen einer Steuerelementerweiterung

Fügen Sie Eigenschaften für das Steuerelement hinzu. Weitere Informationen finden Sie unter Definieren, Überschreiben und Verwenden von LightSwitch-Steuerelementeigenschaften.
Erstellen Sie benutzerdefinierte Eigenschaften-Editoren für das Steuerelement. Weitere Informationen finden Sie unter "Erstellen eines benutzerdefinierten Editors für DisplayProperty" in Exemplarische Vorgehensweise: Erstellen einer Detailsteuerelementerweiterung.
Ermöglichen Sie es Entwicklern, programmgesteuert auf das Steuerelement zuzugreifen. Weitere Informationen finden Sie unter "Erstellen eines programmierbaren Steuerelements" in Exemplarische Vorgehensweise: Erstellen einer Detailsteuerelementerweiterung.
Fügen Sie Unterstützung für berechnete Felder hinzu. Weitere Informationen finden Sie unter "Behandeln des IsComputed-Status im Steuerelement" in Exemplarische Vorgehensweise: Erstellen einer Detailsteuerelementerweiterung.
Fügen Sie Unterstützung für das KeyUp-Ereignis hinzu. Weitere Informationen finden Sie unter "Verhindern des Löschvorgangs für ein Element" in Exemplarische Vorgehensweise: Erstellen einer Detailsteuerelementerweiterung.
Fügen Sie Unterstützung für die Tastaturnavigation hinzu. Weitere Informationen finden Sie unter "Behandeln der Tastaturnavigation in DataGrid" in Exemplarische Vorgehensweise: Erstellen einer Detailsteuerelementerweiterung.
Fügen Sie Unterstützung für den schreibgeschützten Modus hinzu. Weitere Informationen finden Sie unter "Unterstützung für schreibgeschützten Modus" in Exemplarische Vorgehensweise: Erstellen einer Wert-Steuerelementerweiterung.
Fügen Sie dem Steuerelement die Unterstützung für den Anzeigemodus hinzu. Weitere Informationen finden Sie unter Zusätzliche LightSwitch-Steuerelementkonzepte.
Erstellen Sie ein Steuerelement, das immer schreibgeschützt ist. Weitere Informationen finden Sie unter Zusätzliche LightSwitch-Steuerelementkonzepte.
Stellen Sie sowohl ein Editor- als auch ein Viewer-Steuerelement bereit. Weitere Informationen finden Sie unter Zusätzliche LightSwitch-Steuerelementkonzepte.