Procedura: aggiungere un controllo personalizzato a una schermata di Silverlight

Articolo
06/10/2015

È possibile aggiungere i controlli Silverlight a una schermata LightSwitch. Con i controlli Silverlight, è possibile visualizzare o raccogliere informazioni in modalità che vanno oltre le funzionalità dei controlli LightSwitch incorporati.

È possibile utilizzare i controlli inclusi nel runtime Silverlight e Silverlight SDK. È inoltre possibile utilizzare i controlli creati tramite i modelli di progetto Silverlight, ad esempio, quelli disponibili in Visual Studio 2010. Entrambi i tipi di controlli vengono definiti controlli personalizzati in LightSwitch.

Per informazioni su come creare controlli personalizzati tramite i modelli di progetto Silverlight in Visual Studio, vedere Verificare le basi (guida rapida di Silverlight).

Aggiunta di nuovi controlli e sostituzione dei controlli esistenti

È possibile aggiungere un controllo personalizzato a una schermata, come nuovo controllo o come sostituzione per un controllo LightSwitch esistente.

Per aggiungere un controllo personalizzato a una schermata

In Screen Content Tree, selezionare qualsiasi gruppo.
Nella parte superiore della finestra Progettazione schermata, fare clic su Aggiungi elemento di layout, quindi fare clic su Controllo personalizzato.
Nella finestra di dialogo Aggiungi controllo personalizzato espandere il nodo dell'assembly, espandere il nodo dello spazio dei nomi, quindi selezionare il nodo di controllo.

Se l'assembly desiderato non è presente nella finestra di dialogo Aggiungi controllo personalizzato, fare clic su Aggiungi riferimento. Nella finestra di dialogo Aggiungi riferimento selezionare un assembly o un progetto locale che contiene il controllo che si desidera utilizzare, quindi fare clic su OK.

Nota

Se è stato creato questo controllo tramite i modelli di progetto Silverlight in Visual Studio, e l'utente ha associato il controllo ai dati modificando l'XAML del controllo, non è necessario eseguire il passaggio successivo.Per ulteriori informazioni su come associare un controllo personalizzato ai dati modificando il codice XAML del controllo, vedere Utilizzo di controlli personalizzati per migliorare l'interfaccia utente di un'applicazione di LightSwitch.Se il controllo personalizzato è un controllo Silverlight incorporato, o se è stato creato tramite modelli di progetto Silverlight in Visual Studio, ma si desidera associarlo ai dati tramite LightSwitch, procedere al passaggio successivo.
Nel campo Specifica i dati per il nuovo controllo personalizzato, digitare il nome dei dati della schermata che si desidera associare al controllo, quindi fare clic su OK.

Se, ad esempio, si desidera che in una casella di riepilogo personalizzata vengano visualizzati nomi da una raccolta denominata CustomerSet, digitare CustomerSet. Se si desidera che nel controllo venga visualizzato il nome del cliente attualmente selezionato, digitare CustomerSet.SelectedItem.ContactName.
Aggiungere il codice che associa i dati a una proprietà specifica del controllo. Per ulteriori informazioni, vedere Associazione di dati ad una proprietà dei controlli personalizzati più avanti in questo documento.

Per utilizzare un controllo personalizzato per sostituire un controllo esistente

In Albero del contenuto della schermata, nell'elenco a discesa accanto al controllo che si desidera sostituire, selezionare Controllo personalizzato.
Nella finestra Proprietà accanto al campo Controllo personalizzato fare clic su Modifica
Nella finestra di dialogo Aggiungi controllo personalizzato, espandere il nodo dell'assembly, espandere il nodo dello spazio dei nomi, selezionare il nodo di controllo, quindi fare clic su OK.

Se l'assembly che contiene il controllo non è visualizzato nella finestra di dialogo Aggiungi controllo personalizzato, fare clic su Aggiungi riferimento. Nella finestra di dialogo Aggiungi riferimento selezionare un assembly o un progetto locale che contiene il controllo che si desidera utilizzare, quindi fare clic su OK.
Aggiungere il codice che associa i dati a una proprietà specifica del controllo. Per ulteriori informazioni, vedere Associazione di dati ad una proprietà dei controlli personalizzati più avanti in questo documento.

Associazione dei dati a una proprietà del controllo personalizzato

È necessario associare i dati specificati nella finestra di dialogo Aggiungi controllo personalizzato a una proprietà specifica del controllo personalizzato.

Per associare i dati a una proprietà del controllo personalizzato

Nella finestra Progettazione schermata, fare clic sulla freccia accanto al pulsante Scrivi codice, quindi fare clic su qualsiasi metodo.

Nota

Scegliere un metodo che venga eseguito prima di quando si desidera che appaiano i dati nel controllo in fase di esecuzione, ad esempio, CustomerListDetail_Activated.

Nell'editor di codice viene visualizzato un blocco di metodi.
Nel blocco di metodi, aggiungere il codice che associa i dati della schermata a una proprietà del controllo personalizzato.

Il seguente esempio fa riferimento ad un controllo della casella di riepilogo personalizzata denominata Customers. Questo codice consente di associare una raccolta dati specificata nella finestra di dialogo Aggiungi controllo personalizzato a una proprietà specifica della casella di riepilogo. Il codice consente inoltre di specificare la possibilità di modificare i dati tramite tale controllo.
```
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);
}
```