Procedura: aggiungere un controllo personalizzato a una schermata di Silverlight

Articolo
03/05/2013

È 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 sulla creazione di controlli personalizzati tramite i modelli di progetto Silverlight in Visual Studio, vedere la pagina relativa alle informazioni di base sui controlli (guida rapida di Silverlight).

Aggiunta dei 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 ad una schermata

In Albero del contenuto della schermata, 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 sull'associazione di un controllo personalizzato ai dati tramite la modifica di XAML del controllo, vedere la pagina relativa all'utilizzo di controlli personalizzati per migliorare l'interfaccia utente dell'applicazione 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 un codice che associa i dati ad 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 un codice che associa i dati ad 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 ad una proprietà dei controlli personalizzati

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

Per associare i dati ad 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);
}
```