Gewusst wie: Hinzufügen eines benutzerdefinierten Steuerelements zu einem Silverlight-Bildschirm

Sie können einem LightSwitch-Bildschirm Silverlight-Steuerelemente hinzufügen.Mit Silverlight-Steuerelementen können Sie Informationen auf Arten anzeigen oder sammeln, die über die Funktionen der integrierten LightSwitch-Steuerelemente hinausgehen.

Sie können Steuerelemente verwenden, die in der Silverlight-Laufzeit und im Silverlight-SDK enthalten sind.Sie können auch Steuerelemente verwenden, die Sie mit Silverlight-Projektvorlagen erstellen, z. B. mit den in Visual Studio 2010 verfügbaren Vorlagen.Auf beide Arten von Steuerelementen wird in LightSwitch als benutzerdefinierte Steuerelemente verwiesen.

Informationen zum Erstellen von benutzerdefinierten Steuerelementen mit Silverlight-Projektvorlagen in Visual Studio finden Sie in Grundlagen von Steuerelementen (Silverlight QuickStart)(möglicherweise in englischer Sprache).

Hinzufügen von neuen Steuerelementen und Ersetzen von vorhandenen Steuerelementen

Sie können ein benutzerdefiniertes Steuerelement einem Bildschirm hinzufügen, entweder als neues Steuerelement oder als Ersatz für ein vorhandenes LightSwitch-Steuerelement.

So fügen Sie ein benutzerdefiniertes Steuerelement einem Bildschirm hinzu

Wählen Sie in der Struktur der Bildschirminhalte eine beliebige Gruppe aus.
Klicken Sie am oberen Rand des Bildschirm-Designers auf Layoutelement hinzufügen und dann auf Benutzerdefiniertes Steuerelement.

Erweitern Sie im Dialogfeld Benutzerdefiniertes Steuerelement hinzufügen den Assemblyknoten, erweitern Sie den Namespaceknoten, und wählen Sie dann den Steuerelementknoten aus.

Wenn die gewünschte Assembly nicht im Dialogfeld Benutzerdefiniertes Steuerelement hinzufügen angezeigt wird, klicken Sie auf Verweis hinzufügen.Wählen Sie im Dialogfeld Verweis hinzufügen eine Assembly oder ein lokales Projekt aus, in der bzw. dem das gewünschte Steuerelement enthalten ist, und klicken Sie auf OK.

Hinweis
Wenn Sie dieses Steuerelement mit Silverlight-Projektvorlagen in Visual Studio erstellt und das Steuerelement per XAML-Änderung an Daten gebunden haben, müssen Sie den nächsten Schritt nicht ausführen.Weitere Informationen zum Binden eines benutzerdefinierten Steuerelements an Daten per XAML-Änderung für das Steuerelement finden Sie unter Verwenden von benutzerdefinierten Steuerelementen zum Erweitern der Benutzeroberfläche der LightSwitch-Anwendung.Wenn das benutzerdefinierte Steuerelement ein integriertes Silverlight-Steuerelement ist oder wenn Sie dieses Steuerelement mit Silverlight-Projektvorlagen in Visual Studio erstellt haben, Sie das Steuerelement jedoch mithilfe von LightSwitch an Daten binden möchten, fahren Sie mit dem nächsten Schritt fort.

Wenn Sie dieses Steuerelement mit Silverlight-Projektvorlagen in Visual Studio erstellt und das Steuerelement per XAML-Änderung an Daten gebunden haben, müssen Sie den nächsten Schritt nicht ausführen.Weitere Informationen zum Binden eines benutzerdefinierten Steuerelements an Daten per XAML-Änderung für das Steuerelement finden Sie unter Verwenden von benutzerdefinierten Steuerelementen zum Erweitern der Benutzeroberfläche der LightSwitch-Anwendung.Wenn das benutzerdefinierte Steuerelement ein integriertes Silverlight-Steuerelement ist oder wenn Sie dieses Steuerelement mit Silverlight-Projektvorlagen in Visual Studio erstellt haben, Sie das Steuerelement jedoch mithilfe von LightSwitch an Daten binden möchten, fahren Sie mit dem nächsten Schritt fort.

Geben Sie im Feld Geben Sie die Daten für das neue benutzerdefinierte Steuerelement an den Namen der Bildschirmdaten ein, die Sie an das Steuerelement binden möchten, und klicken Sie dann auf OK.

Wenn Sie z. B. möchten, dass ein benutzerdefiniertes Listenfeld Namen einer Auflistung mit dem Namen "CustomerSet" anzeigt, geben Sie "CustomerSet" ein.Wenn das Steuerelement den Namen des gerade ausgewählten Kunden anzeigen soll, geben Sie "CustomerSet.SelectedItem.ContactName" ein.
Fügen Sie Code hinzu, mit dem die Daten an eine spezifische Eigenschaft des Steuerelements gebunden werden.Weitere Informationen finden Sie weiter unten in diesem Dokument unter Binden von Daten an eine Eigenschaft des benutzerdefinierten Steuerelements.

So verwenden Sie ein benutzerdefiniertes Steuerelement, um ein vorhandenes Steuerelement zu ersetzen

Wählen Sie in der Struktur der Bildschirminhalte in der Dropdownliste neben dem Steuerelement, das Sie ersetzen möchten, die Option Benutzerdefiniertes Steuerelement aus.
Klicken Sie im Eigenschaftenfenster neben dem Feld Benutzerdefiniertes Steuerelement auf Ändern.
Erweitern Sie im Dialogfeld Benutzerdefiniertes Steuerelement hinzufügen den Assemblyknoten, erweitern Sie den Namespaceknoten, wählen Sie den Steuerelementknoten aus, und klicken Sie dann auf OK.

Wenn die Assembly, die das Steuerelement enthält, nicht im Dialogfeld Benutzerdefiniertes Steuerelement hinzufügen angezeigt wird, klicken Sie auf Verweis hinzufügen.Wählen Sie im Dialogfeld Verweis hinzufügen eine Assembly oder ein lokales Projekt aus, in der bzw. dem das gewünschte Steuerelement enthalten ist, und klicken Sie auf OK.
Fügen Sie Code hinzu, mit dem die Daten an eine spezifische Eigenschaft des Steuerelements gebunden werden.Weitere Informationen finden Sie weiter unten in diesem Dokument unter Binden von Daten an eine Eigenschaft des benutzerdefinierten Steuerelements.

Binden von Daten an eine Eigenschaft des benutzerdefinierten Steuerelements

Sie müssen die Daten, die Sie im Dialogfeld Benutzerdefiniertes Steuerelement hinzufügen angegeben haben, an eine bestimmte Eigenschaft des benutzerdefinierten Steuerelements binden.

So binden Sie Daten an eine Eigenschaft des benutzerdefinierten Steuerelements

Klicken Sie im Bildschirm-Designer auf den Pfeil neben der Schaltfläche Code schreiben und dann auf eine beliebige Methode.

Hinweis

Wählen Sie eine Methode aus, die ausgeführt wird, bevor Daten zur Laufzeit im Steuerelement erscheinen sollen, z. B. CustomerListDetail_Activated.

Im Code-Editor wird ein Methodenblock angezeigt.
Fügen Sie im Methodenblock Code hinzu, der die Bildschirmdaten an eine Eigenschaft des benutzerdefinierten Steuerelements bindet.

Im folgenden Beispiel wird auf ein benutzerdefiniertes Listenfeld-Steuerelement mit dem Namen Customers verwiesen.In diesem Code wird eine Datensammlung, die im Dialogfeld Benutzerdefiniertes Steuerelement hinzufügen angegeben wurde, an eine bestimmte Eigenschaft des Listenfelds gebunden.Mit diesem Code wird auch angegeben, dass Daten mit diesem Steuerelement geändert werden können.
```
Private Sub CustomersListDetail_Activated()
    Me.FindControl("Customers").SetBinding( _
        System.Windows.Controls.ListBox.ItemsSourceProperty, _
                "Value", System.Windows.Data.BindingMode.TwoWay)
End Sub
```
```
partial void CustomersListDetail_Activated()
{
    this.FindControl("Customers").SetBinding(
        System.Windows.Controls.ListBox.ItemsSourceProperty,
        "Value", System.Windows.Data.BindingMode.TwoWay);
}
```

Hinweis
Wählen Sie eine Methode aus, die ausgeführt wird, bevor Daten zur Laufzeit im Steuerelement erscheinen sollen, z. B. CustomerListDetail_Activated.