Como adicionar uma propriedade local a uma tela do Silverlight

Artigo
06/10/2015

É possível adicionar um campo chamado local property a uma tela. Você pode usar uma propriedade local para coletar um valor de entrada ou para exibir um valor calculado.

Como criar uma propriedade local

Na parte superior do Designer de Tela, clique em Adicionar Item de Dados….

A caixa de diálogo Adicionar Item de Dados aparece.
Na caixa de diálogo Adicionar Item de Dados, selecione Propriedade Local.
Na lista suspensa Tipo, escolha um tipo para a propriedade local.

Você pode selecionar qualquer um dos tipos padrão, como Cadeia de Caracteres, Inteiro, Endereço de Email ou qualquer uma das entidades associadas ao aplicativo, como Cliente, Detalhes do Pedido ou Produto.
Selecione É Obrigatório se você quiser exigir que este campo contenha um valor.

Dica

Se esse campo não contiver um valor quando o usuário tentar abrir a tela, uma mensagem de validação aparecerá.
Na caixa de texto Nome, digite um nome e clique em OK.

A caixa de diálogo Adicionar Item de Dados será fechada. A propriedade local aparece na Lista de Membros da Tela.

Para adicionar uma propriedade local a uma tela

Na Lista de Membros da Tela, arraste a propriedade local para o local desejado da Árvore de Conteúdo da Tela.
Na Árvore de Conteúdo da Tela, na lista suspensa que aparece ao lado da propriedade local, selecione o tipo de exibição desejado.

Por exemplo, se estiver criando uma propriedade local para exibir um valor monetário, você poderá alterar o tipo de exibição para Editor de Moeda ou Visualizador de Moeda. Da mesma forma, você pode exibir uma propriedade local da cadeia de caracteres como Caixa de Texto ou Rótulo.

Para aplicar regras de validação a uma propriedade local

Na Lista de Membros da Tela, selecione a propriedade local.
Na janela Propriedades, expanda o nó Validação se ele ainda não estiver expandido.

As regras disponíveis de validação irão variar dependendo do tipo da propriedade local.
Se a propriedade local precisar ter um valor, selecione É Obrigatório.

Selecione qualquer outra regra de validação que você queira aplicar à propriedade local.
Se você precisar executar uma validação mais complexa, clique em Validação Personalizada.

O Editor de Códigos é exibido. LightSwitch gera um método chamado localPropertyName_Validate. Você pode adicionar uma lógica de validação personalizada a esse método. O exemplo a seguir exibirá uma mensagem de erro se o usuário inserir menos de três de caracteres para uma propriedade local chamada 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 a cadeia de caracteres não contiver pelo menos três caracteres, a propriedade será contornada em vermelho e a mensagem de erro que você digitou acima será exibida.

Para atribuir um valor a uma propriedade local usando código

Você pode definir um valor a uma propriedade local usando código.

O exemplo a seguir define o valor de uma propriedade local chamada ApprovedCheckBox como 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;

}

Consulte também

Tarefas

Como adicionar um comando personalizado a uma tela do Silverlight

Como criar uma tela do Silverlight usando o Designer de Tela

Outros recursos

Telas: a interface de usuário do aplicativo LightSwitch

Partilhar via