Como adicionar uma propriedade local a uma tela do Silverlight

Artigo
02/25/2013

Você pode adicionar um campo chamado propriedade local 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 de 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 que estão associadas ao seu aplicativo, como Cliente, Detalhes do pedido ou Produto.
Selecione É necessário se você deseja exigir que este campo contenha um valor.

Observação

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

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

Observação
Se este campo não contiver um valor quando o usuário tentar abrir a tela, uma mensagem de validação aparece.

Para adicionar uma propriedade local a uma tela

Na Lista de Membros de Tela, arraste a propriedade local no 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 você estiver criando uma propriedade local para exibir um valor monetário, você pode alterar o tipo de exibição para Editor de Moeda ou Visualizador de Moeda.Semelhantemente, você pode exibir uma propriedade local de cadeia de caracteres como Caixa de Texto ou Rótulo.

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

Na Lista de Membros de Tela, selecione a propriedade local.
Da janela Propriedades, expanda o nó de 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 deve ter um valor, selecione É necessário.

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

O Editor de Código é exibido.LightSwitch gera um método chamado Validação de localPropertyName.Você pode adicionar uma lógica de validação personalizada para este método.O exemplo seguinte exibe uma mensagem de erro se o usuário insere menos que 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 contém pelo menos três caracteres, a propriedade será demarcada em vermelho e a mensagem de erro que você digitou acima é exibida.

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

Você pode definir um valor local para uma propriedade 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 do usuário do seu aplicativo.

Compartilhar via