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

Articolo
03/05/2013

È possibile aggiungere un campo denominato proprietà locale 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 dati....

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

È possibile selezionare qualsiasi tipo standard, quale Stringa, Intero, Indirizzo di posta elettronica o qualsiasi entità associata all'applicazione, ad esempio Cliente, Dettaglio ordineo Prodotto.
Selezionare Obbligatorio per richiedere che questo campo contenga un valore.

[!NOTA]

Se questo campo non contiene 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 dati verrà chiusa.La proprietà locale viene visualizzata in Elenco dei membri della schermata.

Per aggiungere una proprietà locale a una schermata

Dall'elenco dei membri della schermata, trascinare la proprietà locale nella posizione desiderata dell'Albero del contenuto della schermata.
In Albero del contenuto della schermata, nell'elenco a discesa visualizzato accanto alla proprietà locale, selezionare il tipo visualizzato 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 della stringa come Casella di testo o Etichetta.

Per applicare le regole di convalida a una proprietà locale

In Screen Members List, selezionare la proprietà locale.
Dal 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à aperto l'editor di codice.LightSwitch genera 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 la stringa non contiene almeno tre caratteri, la proprietà verrà delineata in rosso e viene visualizzato il messaggio di errore digitato sopra.

Per assegnare un valore a una proprietà locale tramite codice

È possibile impostare un valore a 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

Condividi tramite