Adicionar uma propriedade Local

Artigo
02/25/2013

Nesta lição, você aprenderá como personalizar uma tela adicionando uma propriedade local.

Adicionando uma Propriedade Local

Além de usar o Designer de Tela para personalizar os controles em uma tela, você também pode adicionar itens de dados, por exemplo, uma propriedade local que pode exibir um valor calculado.

Para adicionar uma propriedade local

No Gerenciador de Soluções, clique duas vezes na tela OrdersByCustomers.
Na faixa de opções da barra de ferramentas, clique no botão Adicionar o Item de Dados.
Na caixa de diálogo Adicionar o Item de Dados, selecione Propriedade Local e clique em OK.

Um novo nó chamado Property1 é adicionado ao painel esquerdo do Designer de tela.
Selecione o nó Property1 e, na janela de Propriedades, selecione a propriedade Nome e digite NumberOfOrders.

O nome também é alterado no painel esquerdo do designer.
Arraste o nó NumberOfOrders para embaixo do nó Barra de Comando sob o nó Layout de Linhas | Coluna de Detalhes no painel central.
Na lista suspensa do nó Número de Pedidos, altere o tipo de controle para Rótulo.
Pressione F5 para executar o aplicativo e, no menu de navegação, clique em Pedidos por Clientes para exibir a tela e verificar as alterações.

Observe que um campo Número de Pedidos agora é exibido na parte superior da coluna direita e que nenhum valor é exibido.
Clique no botão Fechar no canto superior direito da janela do aplicativo para fechá-lo.

Para exibir um valor de uma propriedade local

No painel esquerdo do Designer de Tela, selecione o nó Clientes.
Na Fita da barra de ferramentas, na lista Escreva Código, clique em Customers_SelectionChanged.

O Editor de Códigos abre e exibe o método Customers_SelectionChanged.
No método Customers_SelectionChanged, adicione o seguinte código.
```
NumberOfOrders = Orders.Count.ToString
```
```
NumberOfOrders = Orders.Count.ToString();
```
Quando um cliente é selecionado, esse código calcula o número de pedidos desse cliente.Este valor é então exibido no campo Número de Pedidos.
Pressione F5 para executar o aplicativo e, no menu de navegação, clique em Pedidos por Clientes para exibir a tela e verificar as alterações.

Observe que quando você seleciona um cliente, o número de pedidos desse cliente é exibido no campo Número de pedidos.
Clique no botão Fechar no canto superior direito da janela do aplicativo para fechá-lo.

Visão aprofundada

Esta lição mostrou como criar uma propriedade local para exibir um valor calculado em uma tela.Neste caso, você usou o método SelectionChanged da coleção de clientes para retornar o Count de pedidos sempre que um cliente é selecionado.Você deve ter notado que o código usa o método ToString para converter o Count para uma String.Isso é necessário porque a propriedade local foi definida como uma String na caixa de diálogo de Adicionar o Item de Dados.Se em vez disso você tivesse selecionado Integer como o tipo, a conversão não seria necessária.

Além de usar uma propriedade local para exibir um valor calculado, você também pode usar uma propriedade local para coletar um valor de entrada do usuário.Por exemplo, você poderia criar uma propriedade local que exibe uma lista de cidades, quando um usuário especifica uma região geográfica.