Agregar una propiedad local

En la siguiente lección, obtendrá información sobre cómo personalizar una pantalla agregando una propiedad local.

Agregar una propiedad local

Además de utilizar el Diseñador de pantallas para personalizar los controles en una pantalla, también puede agregar elementos de datos, por ejemplo, una propiedad local que puede mostrar un valor calculado.

Para agregar una propiedad local

En el Explorador de soluciones, haga doble clic en la pantalla ÓrdenesPorClientes.
En la cinta de la barra de herramientas, haga clic en el botón Agregar elemento de datos.
En el cuadro de diálogo Agregar elemento de datos, seleccione Propiedad local y, a continuación, haga clic en Aceptar.

Un nuevo nodo denominado Property1 se agrega al panel izquierdo del Diseñador de pantallas.
Seleccione el nodo Property1 y en la ventana Propiedades, seleccione la propiedad Name y escriba NúmeroDePedidos.

El nombre también cambia en el panel izquierdo del diseñador.
Arrastre el nodo NúmeroDePedidos justo debajo del nodo Barra de comandos bajo el nodo Diseño de filas | Columna de detalles en el panel central.
En la lista desplegable del nodo Número de pedidos, cambie el tipo de control a Etiqueta.
Presione F5 para ejecutar la aplicación y, en el menú de desplazamiento, haga clic en Pedidos por clientes para mostrar la pantalla y comprobar los cambios.

Observe que el campo Número de pedidos se muestra ahora en la parte superior de la columna derecha y no se muestra ningún valor.
Haga clic en el botón Cerrar en la esquina superior derecha de la ventana de la aplicación para cerrarla.

Mostrar un valor para una propiedad local

En el panel izquierdo del Diseñador de pantallas, seleccione el nodo Clientes.
En la Cinta de barra de herramientas, en la lista Escribir código, haga clic en Customers_SelectionChanged.

El Editor de código se abre y muestra el método Customers_SelectionChanged.
En el método Customers_SelectionChanged, agregue el código siguiente.
```
NumberOfOrders = Orders.Count.ToString
```
```
NumberOfOrders = Orders.Count.ToString();
```
Cuando un cliente está seleccionado, el código calcula el número de pedidos de ese cliente.Ese valor se muestra para el campo Número de pedidos.
Presione F5 para ejecutar la aplicación y en el menú de desplazamiento, haga clic en Pedidos por clientes para mostrar la pantalla y comprobar los cambios.

Observe que al seleccionar un cliente, el número de pedidos para ese cliente se muestra en el campo Número de pedidos.
Haga clic en el botón Cerrar en la esquina superior derecha de la ventana de la aplicación para cerrarla.

Información detallada

Esta lección ha mostrado cómo crear una propiedad local para mostrar un valor calculado en una pantalla.En este caso, se ha utilizado el método SelectionChanged de la colección de clientes para devolver Count de los pedidos cada vez que se selecciona un cliente.Puede haber observado que el código utiliza el método ToString para convertir Count en String.Se requiere porque la propiedad local se definió como String en el cuadro de diálogo Agregar elemento de datos.Si hubiera seleccionado Integer como el tipo, no se requeriría la conversión.

Además de utilizar una propiedad local para mostrar un valor calculado, también puede utilizar una propiedad local para recopilar un valor de entrada del usuario.Por ejemplo, podría crear una propiedad local que muestre una lista de ciudades cuando un usuario especifica una región geográfica.