Procedura: aggiungere una proprietà locale a una schermata di Silverlight

Articolo
06/10/2015

È possibile aggiungere un campo denominato local property a una schermata. È possibile utilizzare una proprietà locale per raccogliere un valore di input o per visualizzare un valore calcolato.

Per creare una proprietà locale

Nella parte superiore di Progettazione schermata fare clic su Aggiungi elemento di dati.

Verrà visualizzata la finestra di dialogo Aggiungi elemento di dati.
Nella finestra di dialogo Aggiungi elemento di dati selezionare Proprietà locale.
Nell'elenco a discesa Tipo scegliere un tipo per la proprietà locale.

È possibile selezionare qualsiasi tipo standard, ad esempio Stringa, Intero, Indirizzo di posta elettronica o qualsiasi entità associata all'applicazione, ad esempio Customer, Order Detail o Product.
Selezionare Obbligatorio per richiedere che in questo campo sia contenuto un valore.

Nota

Se in questo campo non è contenuto un valore quando l'utente tenta di aprire la schermata, viene visualizzato un messaggio di convalida.
Nella casella di testo Nome digitare un nome, quindi fare clic su OK.

La finestra di dialogo Aggiungi elemento di dati verrà chiusa. La proprietà locale viene visualizzata in Elenco dei membri della schermata.

Per aggiungere una proprietà locale a una schermata

Da Elenco dei membri della schermata trascinare la proprietà locale nella posizione desiderata di Albero del contenuto della schermata.
In Albero del contenuto della schermata, nell'elenco a discesa visualizzato accanto alla proprietà locale, selezionare il tipo di visualizzazione desiderato.

Ad esempio, se si crea una proprietà locale per visualizzare un valore monetario, è possibile impostare il relativo tipo di visualizzazione su Editor di denaro o Visualizzatore denaro. Analogamente, è possibile visualizzare una proprietà locale stringa come Casella di testo o Etichetta.

Per applicare le regole di convalida a una proprietà locale

In Elenco dei membri della schermata selezionare la proprietà locale.
Dalla finestra Proprietà espandere il nodo Convalida se non è già espanso.

Le regole di convalida disponibili varieranno a seconda del tipo della proprietà locale.
Se la proprietà locale deve disporre di un valore, selezionare Obbligatorio.

Selezionare qualsiasi altra regola di convalida che si desidera applicare alla proprietà locale.
Se è necessario eseguire una convalida più complessa, fare clic su Convalida personalizzata.

Verrà visualizzato l'Editor di codice. Tramite LightSwitch viene generato un metodo denominato localPropertyName_Validate. È possibile aggiungere una logica di convalida personalizzata a questo metodo. Nell'esempio seguente viene visualizzato un messaggio di errore se l'utente immette meno di tre caratteri per una proprietà locale denominata CityCode.
```
Private Sub CityCode_Validate(results As ScreenValidationResultsBuilder)
    If Me.CityCode.Length < 3 Then
        results.AddPropertyError("This string must have at least 3 letters.")
    End If 
End Sub
```
```
partial void CityCode_Validate
    (ScreenValidationResultsBuilder results)
{
    if (this.CityCode.Length < 3)
    {
        results.AddPropertyError("This string must have at least 3 letters.");
    }

}
```
Se nella stringa non sono contenuti almeno tre caratteri, la proprietà verrà evidenziata in rosso e viene visualizzato il messaggio di errore digitato in precedenza.

Per assegnare un valore a una proprietà locale tramite codice

È possibile impostare un valore su una proprietà locale tramite codice.

Nell'esempio seguente viene impostato il valore di una proprietà locale denominata ApprovedCheckBox su False.

Private Sub OrdersListDetail_InitializeDataWorkspace _
    (saveChangesTo As System.Collections.Generic.List _
     (Of Microsoft.LightSwitch.IDataService))
    ApproveCheckBox = False 

End Sub

partial void ApprovedCheckBox_Validate
    (ScreenValidationResultsBuilder results)
{
    ApprovedCheckBox = false;

}

Vedere anche

Attività

Procedura: aggiungere un comando personalizzato a una schermata di Silverlight

Procedura: progettare una schermata di Silverlight utilizzando Progettazione schermata

Altre risorse

Schermate: interfaccia utente dell'applicazione LightSwitch

Condividi tramite