Introduccion A LightSwitch

Introducción a LightSwitch
Visual Studio 2013
Otras versiones
Este tema aún no ha recibido ninguna valoración - Valorar este tema
Puede compilar aplicaciones empresariales rápidamente centrándose en la lógica de

negocios, en lugar de en la infraestructura de la aplicación, si utiliza el entorno de
desarrollo simplificado de Visual Studio LightSwitch.
Para obtener una introducción rápida al entorno de desarrollo de LightSwitch y sus

características más comunes, vea Tutorial: Crear la aplicación Vision Clinic en
LightSwitch, que muestra cómo crear una aplicación para una aplicación de Vision Clinic
ficticia.
Para obtener una introducción más detallada, vea Paseo guiado por LightSwitch, que
explica no solo los pasos que se llevan a cabo, sino también por qué.
Temas relacionados
Título Descripción
Describe herramientas como el diseñador de entidades
Entorno de desarrollo de
y el Diseñador de consultas en el entorno de
LightSwitch
desarrollo.
Contiene vínculos a un conjunto de lecciones
Paseo guiado por LightSwitch secuenciales que describen la mayoría de las
capacidades de LightSwitch.
Muestra cómo crear una aplicación para una aplicación
Tutorial: Crear la aplicación
de Vision Clinic ficticia, que muestra las capacidades
Vision Clinic en LightSwitch
de LightSwitch.
Muestra cómo trabajar con fuentes OData que genera
LightSwitch como origen de datos
LightSwitch.
Tutorial: Crear un cliente
Muestra cómo crear una aplicación cliente en HTML.
LightSwitch para usuarios móviles
Tutorial: Crear una aplicación para Muestra cómo crear una aplicación que está
SharePoint utilizando LightSwitch autohospedada en SharePoint para Office 365.
Contiene información y vínculos a recursos de la
Comunidad: Conectar con otros
comunidad como foros, blogs y sitios web acerca de
desarrolladores de LightSwitch
LightSwitch.
Solucionar problemas de Contiene información sobre los problemas más
LightSwitch frecuentes y los pasos para resolverlos.
Vea también
Conceptos
Visual Studio LightSwitch
Entorno de desarrollo de LightSwitch

Visual Studio 2013
Otras versiones
Puede crear una aplicación de LightSwitch mediante el entorno de desarrollo integrado

(IDE) de Visual Studio LightSwitch. Si está familiarizado con Visual Studio, reconocerá
algunas de las partes del IDE, pero puede que otras no le resulten conocidas. En este tema
se proporciona una introducción al IDE de LightSwitch.
Familiarizarse con el entorno de desarrollo
La parte principal del IDE está compuesta de diseñadores o ventanas correspondientes a

varias tareas de desarrollo, los cuales aparecen o desaparecen al cambiar de una tarea a otra.
Con las ventanas de herramientas que aparecen a la derecha de la ventana principal puede
navegar entre los diseñadores, establecer propiedades para los mismos y mucho más. A
continuación se incluyen algunos de los diseñadores y ventanas que se usarán
principalmente:
 Diseñador de LightSwitch
El diseñador de LightSwitch aparece al crear un proyecto. Contiene vínculos que se

pueden usar para conectarse a una base de datos existente o para crear tablas nuevas
en la base de datos de la aplicación.
 Explorador de soluciones
El Explorador de soluciones contiene una lista de todos los elementos del proyecto.
Se usa para navegar entre las ventanas del diseñador y está dividido en las secciones
que corresponden a los elementos de datos, las pantallas y las propiedades de la
aplicación. De forma predeterminada, el Explorador de soluciones siempre está
visible.
 Diseñador de datos
El Diseñador de datos, también conocido como Diseñador de tablas, es donde se
trabaja con los datos de la aplicación. El Diseñador de Datos se puede abrir
haciendo doble clic en el nodo origen de los datos en el Explorador de soluciones.
 Diseñador de pantallas
El Diseñador de pantallas es donde crea la interfaz de usuario para su aplicación. El

Diseñador de pantallas se puede abrir haciendo doble clic en el nodo de pantallas
del Explorador de soluciones.
 Diseñador de consultas
El Diseñador de consultas es donde se crean las consultas para filtrar y ordenar los
datos de la aplicación. Las consultas se pueden usar como base para nuevas
pantallas o para modificar el contenido de una pantalla existente. El Diseñador de
consultas se puede abrir desde el menú Proyecto cuando hay un nodo de orígenes de
datos seleccionado en el Explorador de soluciones.
 Propiedades (Ventana)
La ventana Propiedades es donde se establecen las propiedades para los elementos

en el diseñador activo. Las propiedades disponibles varían según el contexto. De
forma predeterminada, la ventana Propiedades siempre está visible.
 Editor de código
El Editor de código es donde se escribe el código de la aplicación. Se abre una

instancia independiente del Editor de código para cada elemento de la aplicación
que contiene código de usuario. A diferencia de las ventanas de diseñador, estas
ventanas permanecen abiertas hasta que el usuario decida cerrarlas. El Editor de
código se puede abrir desde el menú Proyecto cuando una pantalla o entidad se
selecciona en el Explorador de soluciones. También se puede abrir desde muchos
diseñadores.
 Diseñador de aplicaciones
El Diseñador de aplicaciones es donde se administran los valores y las propiedades
que definen la apariencia y el comportamiento de la aplicación. Incluye las pestañas
Propiedades generales, Extensiones, Navegación de pantalla, Control de acceso y
Tipo de aplicación. El Diseñador de aplicaciones se puede abrir desde el nodo
Propiedades del Explorador de soluciones.
Temas relacionados
Paseo guiado por Ofrece lecciones que abarcan muchas de las funciones de
LightSwitch LightSwitch.
Depurar herramientas en Ofrece una introducción a varios elementos del IDE
LightSwitch relacionados con la depuración de aplicaciones.
Vea también
Otros recursos
Paseo guiado por LightSwitch
Visual Studio 2013
Otras versiones
El paseo guiado de LightSwitch consta de un conjunto de lecciones diseñado para presentar

las capacidades básicas de LightSwitch. Las lecciones le guían por el proceso de creación
de una aplicación a fin de que se familiarice con el entorno de desarrollo de LightSwitch.
Estas lecciones se deben seguir secuencialmente, ya que cada paso continúa a partir del
anterior.
Requisitos previos
En el paseo guiado de LightSwitch se utiliza un servicio Open Data Protocol (OData) para
conectarse a la base de datos Northwind. Debe tener acceso a Internet para poder consultar
la base de datos.
Resulta útil tener algún conocimiento de programación en Visual Basic o en Visual C#,
aunque no es necesario. Se le proporcionará cualquier código que tenga que escribir.
Pasos siguientes
En el primer conjunto de lecciones, aprenderá a compilar una aplicación sencilla en cuatro

pasos.
Primera lección: Crear la primera aplicación de LightSwitch.

Vea también
Tareas
Tutorial: Crear la aplicación Vision Clinic en LightSwitch
Otros recursos
Entorno de desarrollo de LightSwitch
Crear la primera aplicación de

LightSwitch
Personas que lo han encontrado útil: 1 de 1 - Valorar este tema
La mejor manera de aprender a diseñar una aplicación mediante Visual Studio LightSwitch
consiste en crear una aplicación de ejemplo. En las cuatro lecciones siguientes se muestra
cómo crear una aplicación de administración de contactos.
Cuatro sencillos pasos
La aplicación de administración de contactos interactúa con una base de datos y muestra los
datos en pantalla. Entre las capacidades disponibles se incluyen la entrada de datos, la
navegación, la validación, las búsquedas y mucho más; todo ello sin escribir una sola línea
de código.
El proceso se describe en los cuatro pasos siguientes.
Crear un proyecto
El primer paso para crear una aplicación LightSwitch consiste en crear un proyecto. Un
proyecto representa el contenedor de los archivos que componen la aplicación. Para obtener
información acerca de cómo crear un proyecto, vea Paso 1: Crear un proyecto de
LightSwitch.
Definir los datos
El segundo paso para crear una aplicación consiste en definir los datos que utiliza la
aplicación. En la aplicación de administración de contactos, se necesitan datos que
representen un nombre, una compañía, un número de teléfono y una dirección de correo
electrónico. Para obtener información acerca de cómo definir los datos, vea Paso 2: Definir
los datos en LightSwitch.
Crear pantalla
El paso siguiente es crear una pantalla que permita ver, escribir y modificar los datos del
contacto. Para obtener información acerca de cómo crear una pantalla, vea Paso 3: Crear
una pantalla en LightSwitch.
Ejecutar la aplicación
El paso final consiste en ejecutar la aplicación y ver cómo funciona. Para obtener
información acerca de cómo ejecutar una aplicación, vea Paso 4: ejecutar y probar la
aplicación.
Temas relacionados
Entorno de desarrollo de
Describe las diferentes partes del IDE de LightSwitch.
LightSwitch
Muestra cómo crear una aplicación que aborda las
Tutorial: Crear la aplicación
necesidades de negocio de una clínica oftalmológica
Vision Clinic en LightSwitch
ficticia.
Proporciona una introducción general a LightSwitch y
sus funciones.
Paso 1: Crear un proyecto de LightSwitch

Visual Studio 2013
Otras versiones
En el primer proyecto, crearemos una aplicación para administrar la información de

contactos. El primer paso consiste en iniciar Visual Studio 2013 y crear un proyecto.
Crear un proyecto
Para crear un proyecto en una aplicación
1. En el menú Inicio, elija Visual Studio 2013.

2. En la barra de menús, elija Archivo, Nuevo proyecto.
Aparece el cuadro de diálogo Nuevo proyecto.
3. En la lista de plantillas, expanda el nodo de Visual Basic o de Visual C# y, a

continuación, elija el nodo LightSwitch y elija Aplicación de escritorio de
LightSwitch (Visual Basic) o la plantilla Aplicación de escritorio de LightSwitch
(Visual C#).
4. En el cuadro de texto Nombre, escriba Mi primera aplicación y elija el botón
Aceptar.
Aparece la ventana Diseñador de Mi primera aplicación, y se agregan las carpetas

necesarias para el proyecto en la ventana del Explorador de soluciones, como se
muestra en la siguiente ilustración:
Información detallada
Acaba de crear un proyecto para una aplicación de administración de contactos con la

finalidad de almacenar y organizar las secciones de esa aplicación.
Al abrir el cuadro de diálogo Nuevo proyecto, se pueden crear varios tipos de proyectos. La
aplicación de administración de contactos consiste en una aplicación típica de escritorio
basada en Windows que se puede ejecutar desde el menú Inicio. También puede crear una
aplicación basada en web que se puede ejecutar en un explorador web. Normalmente,
puede cambiar el tipo de aplicación en fases posteriores.
Al crear el proyecto, puede elegir entre Visual Basic o Visual C# como lenguaje de
programación, aunque ambos lenguajes ofrecen las mismas funcionalidades. Puede elegir el
lenguaje que prefiera al crear el proyecto, aunque no podrá modificar dicha elección más
adelante.
En la mayoría de los casos, es posible que desee escribir un nombre más descriptivo para el
proyecto en el cuadro de diálogo Nuevo proyecto. También puede cambiar la ubicación
donde se guardan los archivos de proyecto cuando se crea el proyecto.
Pasos siguientes
En la lección siguiente, aprenderá a definir los datos para la aplicación mediante la creación
de una entidad de datos.
Próxima lección: Paso 2: Definir los datos en LightSwitch
Vea también
Tareas
Cómo: Crear, abrir, guardar o eliminar un proyecto de LightSwitch
Otros recursos
Crear la primera aplicación de LightSwitch
Proyectos: El contenedor para la aplicación de LightSwitch
Paso 2: Definir los datos en LightSwitch

Visual Studio 2013
Otras versiones
En esta lección, se definirán los datos para la aplicación de administración de contactos

mediante la creación de una tabla, también conocida como una entidad de datos. El
Diseñador de datos de LightSwitch permite especificar los campos de propiedades y los
tipos de datos que representan un contacto.
Definir los datos
Para crear una entidad en la aplicación

1. En la ventana del Diseñador de Mi primera aplicación, elija el vínculo Crear nueva
tabla.
Se abre la ventana Diseñador de datos.
2. En la ventana Propiedades, en el cuadro de texto de la propiedad Nombre, escriba

Contacto y elija la tecla Entrar.
El nombre en la barra de título cambia a "Contacto" y en el Explorador de

soluciones cambia a "Contactos".
3. En la columna Nombre, elija el vínculo <Agregar propiedad>, escriba

NombreContacto y, después, elija la tecla Entrar.
El tipo de datos adecuado, String, aparece en la columna Tipo y la casilla

Obligatorio está activada. Los contactos deben tener un nombre.
4. En la columna Nombre, elija el vínculo <Agregar propiedad> y escriba

CompañíaContacto.
TeléfonoContacto.
6. En la columna Tipo, abra la lista y, a continuación, elija PhoneNumber.
PhoneNumber es un tipo comercial personalizado que representa un patrón común

para escribir y dar formato a números de teléfono.

CorreoElectrónicoContacto.
8. En la columna Tipo, abra la lista y, a continuación, elija EmailAddress.
EmailAddress es otro tipo comercial personalizado que representa una dirección de

correo electrónico con formato correcto.
9. Desactive la casilla de la columna Obligatorio del campo

CorreoElectrónicoContacto.
En este caso, puede escribir un contacto sin tener que proporcionar una dirección de
correo electrónico.
En este punto, su entidad debería tener un aspecto similar al de la siguiente

ilustración:
Acaba de crear una entidad de datos que contiene cuatro campos. Al escribir y guardar
datos en la aplicación de administración de contactos, las entradas de esos campos se
almacenan en una base de datos interna.
Cuando definió los datos en la entidad de datos, utilizó tipos comerciales personalizados
para el número de teléfono y la dirección de correo electrónico. Los tipos comerciales
personalizados son la manera más adecuada de especificar datos complejos que se utilizan
normalmente en las aplicaciones empresariales. Dado que muchos tipos comerciales
personalizados ya están definidos, no es necesario preocuparse por los detalles de la
implementación de los datos que se utilizan normalmente.
Además de los tipos comerciales personalizados que se compilan en LightSwitch, puede

utilizar tipos adicionales como extensiones. Obtendrá más información sobre ellos en una
lección posterior.
Pasos siguientes
En el paso siguiente, obtendrá información acerca de cómo crear una pantalla para mostrar
y modificar datos.
Próxima lección: Paso 3: Crear una pantalla en LightSwitch
Vea también
Conceptos
Paso 1: Crear un proyecto de LightSwitch
Otros recursos
Datos: La información que hay detrás de la aplicación
Extensiones: Agregar nuevas capacidades a LightSwitch
Paso 3: Crear una pantalla en LightSwitch

Visual Studio 2013
Otras versiones
En esta lección, se creará una pantalla para escribir, mostrar y cambiar los datos en la
aplicación de administración de contactos. Mediante el cuadro de diálogo Agregar nueva
pantalla de LightSwitch, podrá elegir una plantilla de pantalla y especificar los datos que se
van a mostrar.
Crear pantalla
Para crear una pantalla en la aplicación

1. En el Explorador de soluciones, elija el nodo Pantallas.
2. En la barra de menús, elija Proyecto, Agregar pantalla.
Aparecerá el cuadro de diálogo Agregar nueva pantalla.
3. En la lista Seleccione una plantilla de pantalla, elija Pantalla de rejilla editable.

4. En el cuadro de texto Nombre de pantalla, escriba ListaContactos.
5. En la lista Datos de pantalla, elija Contactos y elija el botón Aceptar.
Se abre el Diseñador de pantallas y aparece una representación del diseño y de los

comandos de la pantalla, según se muestra en la siguiente ilustración:
Acaba de crear una pantalla que muestra los datos de contacto en una cuadrícula que se
puede modificar. La configuración predeterminada para esta aplicación es correcta, aunque
generalmente la pantalla se personaliza en el Diseñador de pantallas. Por ejemplo, puede
ocultar un campo de identificador, hacer que un campo sea de solo lectura o cambiar el
diseño de algunos datos.
El Diseñador de pantallas no muestra cómo aparece la pantalla, aunque sí puede mostrar la

pantalla, e incluso cambiarla, si ejecuta la aplicación según se indica en una lección
posterior.
Pasos siguientes
En la lección siguiente, se ejecutará la aplicación y se comprobarán las funcionalidades.
Próxima lección: Paso 4: ejecutar y probar la aplicación
Vea también
Tareas
Cómo: Personalizar una pantalla de Silverlight en una aplicación en ejecución
Conceptos
Paso 2: Definir los datos en LightSwitch
Otros recursos
Pantallas: Interfaz de usuario de una aplicación de LightSwitch
Paso 4: ejecutar y probar la aplicación

Visual Studio 2013
Otras versiones
Ha creado su primera aplicación LightSwitch. En esta lección, ejecutará la aplicación y

escribirá algunos datos en la lista de contactos.
Ejecución y prueba
Para ejecutar y probar la aplicación
1. En la barra de menús, elija Depurar, Iniciar depuración.
Este comando ejecuta el programa y muestra la pantalla Lista de contactos.
Sugerencia
También puede presionar F5 para ejecutar la aplicación.
2. En la pantalla Lista de Contactos, elija el botón para agregar (+...).
Se abrirá el cuadro de diálogo Agregar Nuevo contacto. Puede ver campos para
escribir un nombre, compañía, número de teléfono o dirección de correo
electrónico.
3. En el cuadro de texto Nombre de contacto, escriba Almudena Benito y, a

continuación, presione Tab.
4. En el cuadro de texto Compañía del contacto, escriba Great Lakes Food Market y, a
5. En el cuadro de texto Teléfono del contacto, escriba 5035557555 y presione la tecla
TAB dos veces.
Observe cómo el número de teléfono se muestra con el formato correcto.
6. En el cuadro de texto Correo electrónico de contacto, escriba Benito@ejemplo y, a

El contorno rojo que aparece alrededor del campo indica un error.
7. Agregue .com al final de la dirección de correo electrónico y, a continuación,

presione Tab.
Observe que el contorno rojo desaparece, lo que indica que la dirección de correo
electrónico tiene el formato correcto.
8. Elija el botón Aceptar para cerrar el cuadro de diálogo y, a continuación, elija el

botón Guardar de la cinta de opciones Datos para guardar los datos.
9. En el cuadro de texto Buscar, escriba 505 y presione Entrar.
La cuadrícula está vacía porque no hay ningún contacto que coincida con 505.
10. En el cuadro de texto Buscar, cambie la entrada a 503 y, a continuación, presione

Entrar.
La cuadrícula muestra ahora un contacto que coincide, como muestra la siguiente
ilustración:
11. Cierre la aplicación en ejecución eligiendo el botón Cerrar en la esquina superior

derecha de la ventana de la aplicación.
12. En la barra de menús, elija Archivo, Guardar todo.
Esta acción guarda el proyecto para que pueda utilizarlo en lecciones futuras.
En esta lección, ejecutó el programa para comprobar cómo funciona. Ahora tiene una
aplicación totalmente funcional que implementa la entrada de datos, navegación,
validación, búsqueda y mucho más, todo sin escribir una sola línea de código. Se trata de
una de las funcionalidades más eficaces de LightSwitch; todo el código necesario está
integrado. Con esto se ahorra trabajo. Si tuviera que hacerlo usted, podría tener cientos o
incluso miles de líneas de código.
Evidentemente, la aplicación de administración de contactos es mucho más sencilla que la

mayoría de las aplicaciones que creará. Probablemente, necesitará pantallas que combinen
datos de varios orígenes, o que cambien la presentación según ciertas condiciones, y la
mayoría de las aplicaciones tendrán varias pantallas. Obtendrá información acerca de todos
estos aspectos y mucho más en las lecciones restantes.
LightSwitch reduce la necesidad de escribir código para escenarios comunes, pero también
habrá casos en los que tendrá que escribir código. Cada empresa tiene su propio conjunto
de reglas. Por ejemplo, puede que necesite establecer descuentos para cierto tipo de clientes
o que ciertas compras estén exentas de impuestos. Como desarrollador de una aplicación
empresarial, su labor consiste en comprender las reglas del negocio y expresarlas en el
código.
Pasos siguientes
Ha terminado su primera aplicación LightSwitch. En las siguientes lecciones, obtendrá más

información acerca de las entidades de datos y la conexión a los datos.
Próxima lección: Conectarse a datos en una aplicación de LightSwitch.
Vea también
Conceptos
Paso 3: Crear una pantalla en LightSwitch
Otros recursos
Trabajar con datos en LightSwitch (Paseo

guiado)
Las aplicaciones que se compilan en Visual Studio LightSwitch utilizan un modelo de

"formularios sobre datos". Los formularios, que se denominan pantallas en LightSwitch, se
utilizan para mostrar, escribir o actualizar los datos que están almacenados en una base de
datos o en otro origen de datos. En este conjunto de lecciones, aprenderá a conectarse a un
origen de datos, a modificar los tipos de datos que se utilizan para mostrar los datos, a
validar los datos o a definir las relaciones entre los orígenes de datos, entre otras cosas.
Nota
Esta lección parte del proyecto Mi primera aplicación que creó en la lección sobre cómo
crear la primera aplicación LightSwitch. Si el proyecto no está abierto aún, ábralo
señalando Archivoy haciendo clic después en Abrir proyecto.
Lecciones
Conectarse a datos en una aplicación de Muestra cómo conectarse a un origen de datos de
LightSwitch Open Data Protocol (OData).
Personalizar campos de entidades en Explica cómo mostrar los datos en un formato
LightSwitch diferente al tipo de almacenamiento.
Presentar una lista de opciones en una Muestra cómo crear una lista fija de valores para
aplicación de LightSwitch un campo de datos.
Validar datos en una aplicación de Muestra cómo validar los datos que escribe el
LightSwitch usuario.
Agregar una propiedad calculada en
Muestra cómo crear valores calculados.
una aplicación de LightSwitch
Definir relaciones en una aplicación de Muestra cómo definir las relaciones entre los
LightSwitch datos en orígenes de datos diferentes.
Vea también
Conceptos
Otros recursos
Conectarse a datos en una aplicación de
LightSwitch
Visual Studio 2013
Otras versiones
En la siguiente lección, aprenderá a conectarse a una base de datos externa para

proporcionar datos para una aplicación LightSwitch.
Conectarse a los datos
La mayoría de las aplicaciones empresariales utilizan el modelo de "formularios sobre

datos". Los formularios, que se denominan pantallas en LightSwitch, muestran y actualizan
los datos que están almacenados en una base de datos. Ya conoce cómo mostrar y actualizar
los datos de la base de datos local de LightSwitch. En las aplicaciones reales, es necesario
conectarse a los datos de una base de datos externa. Como primer paso, especifique una
conexión a la base de datos.
Nota
El servicio de datos Northwind de este ejemplo es de solo lectura. Puede ver los datos,
pero no actualizarlos.
Para adjuntar a un origen de datos
1. En el Explorador de soluciones, elija el nodo Orígenes de datos.

2. En la barra de menús, elija Proyecto, Agregar origen de datos.
Se abrirá el Asistente para adjuntar origen de datos.
3. En el Asistente para adjuntar origen de datos, elija Servicio OData y luego elija
Siguiente.
4. En la página Especificar información de conexión, en el cuadro Especifique el
extremo del servicio OData, escriba
http://services.odata.org/V3/Northwind/Northwind.svc.
5. En Información de inicio de sesión, elija el botón de opción Autenticación de
Windows y, a continuación, elija el botón Siguiente.
6. En la página Elija las entidades, expanda el nodo Entidades.
7. Elija las tablas Clientes, Detalles del pedido, Pedidos y Productos, y elija el botón
Finalizar.
El origen de datos NorthwindEntitiesData se agrega al proyecto y se crean las

entidades para Clientes, Pedidos y Detalles del pedido.
En este procedimiento, se ha establecido una conexión a la base de datos de ejemplo

Northwind, que se expuso a través de un servicio Open Data Protocol (OData). Debe
conocer el nombre de la base de datos o del servicio al que desea obtener acceso en sus
propias aplicaciones, así como la dirección del servidor donde se han hospedado.
También necesita permiso para obtener acceso y modificar la base de datos. Los permisos
se basan generalmente en las credenciales de Windows (el identificador de inicio de sesión
Windows) o en las credenciales personalizadas que asigna el administrador de bases de
datos.
En el Asistente para adjuntar origen de datos, podría haber elegido Base de datos,
SharePoint o Servicio RIA de WCF como origen de datos. Para una aplicación
LightSwitch, puede usar datos de una base de datos como SQL Server, de una lista de
SharePoint o de un servicio de aplicación de Internet enriquecida (RIA) de Windows
Communication Foundation (WCF) que esté diseñado para LightSwitch y se hospede en un
servidor web.
En el cuadro de diálogo Advertencias que aparece al elegir el botón Finalizar, los mensajes
advertían acerca de relaciones que no se pueden importar, además de las entidades
relacionadas que se van a agregar. Según la estructura del origen de datos, LightSwitch
permite tomar decisiones más acertadas para la aplicación. Obtendrá más información sobre
las relaciones en una lección posterior.
Pasos siguientes
En la siguiente lección, aprenderá a trabajar con las entidades de datos que acaba de crear.
Próxima lección: Personalizar campos de entidades en LightSwitch

Vea también
Tareas
Cómo: Conectarse a datos
Conceptos
Instrucciones para crear servicios RIA de WCF para LightSwitch
Otros recursos
Trabajar con datos en LightSwitch (Paseo guiado)
How to: Attach to a Sharepoint Data Source
Personalizar campos de entidades en

LightSwitch
Visual Studio 2013
Otras versiones
En esta lección aprenderá a establecer propiedades de presentación y a cambiar el tipo de

datos de campos individuales en una entidad de datos de LightSwitch.
Personalizar campos de entidad

Puede usar las propiedades de presentación para especificar cómo se muestran al usuario
los datos de un campo dado. Por ejemplo, puede especificar un nombre para mostrar
diferente para un campo.
Para establecer propiedades de campo
1. En el Explorador de soluciones, abra el menú contextual del nodo Clientes.lsml y, a

continuación, elija Abrir.
Se abre el Diseñador de datos.
2. En la barra Perspectiva, elija la pestaña DesktopClient.

3. En la ventana Propiedades, en la lista Propiedad de resumen, elija CompanyName.
4. En el Diseñador de datos, elija el campo CompanyName.
5. En la ventana Propiedades, elija la propiedad Nombre para mostrar y, después,
escriba Compañía en el cuadro de texto.
Sugerencia
Los nombres del campo de base de datos no pueden contener espacios y pueden
usar un carácter de subrayado para representar un espacio. Para asegurarse de que
los nombres de campo que se muestran son descriptivos, revíselos en las entidades
de la base de datos y cambie la propiedad Nombre para mostrar de los campos que
requieran un nombre más adecuado.
6. En la propiedad Descripción del campo ContactName, escriba Este es nuestro

contacto principal en esta compañía.
El valor de la propiedad Descripción aparece como información sobre herramientas

en la aplicación cuando un usuario señala un campo.
Los campos de una tabla de base de datos suelen almacenarse en un formato que resulte
eficaz para la base de datos, si bien tal vez no es lo que desea mostrar al usuario. Por
ejemplo, los campos que representan valores monetarios se almacenan normalmente como
tipo de datos Decimal, pero suelen aparecer como divisa en una aplicación.
Para cambiar los tipos de datos
1. En el Diseñador de datos, en la barra Perspectiva, elija la pestaña Servidor.

2. En la tabla Cliente, elija el campo Teléfono.
3. En la columna Tipo, abra la lista y, a continuación, elija PhoneNumber.
PhoneNumber es un tipo comercial personalizado que muestra un número de

teléfono en un formato estandarizado.
4. En el Explorador de soluciones, abra el menú contextual del nodo Order_Details y,
a continuación, elija Abrir.
5. En el Diseñador de datos, elija el campo UnitPrice.
6. En la columna Tipo, abra la lista y, a continuación, elija Money.
Money es otro tipo comercial personalizado para dar formato a los valores de divisa
y mostrarlos.
En esta lección se ha explicado cómo establecer propiedades para los campos de entidad y
cómo cambiar el tipo de datos de un campo. Se recomienda seguir estos pasos
inmediatamente después de agregar una entidad, si bien las propiedades y los tipos de datos
pueden cambiarse en cualquier momento durante el desarrollo de aplicaciones.
La primera propiedad que estableció fue la propiedad Resumen. Para las pantallas que
contienen listas, este campo aparece en la lista en lugar del campo de identificador
predeterminado.
La mayoría de las propiedades que pueden establecerse están relacionadas con la

apariencia, si bien hay otras disponibles para establecer reglas de validación y otras
características. La disponibilidad de las propiedades varía según el tipo de datos. En las
lecciones posteriores se describen otras propiedades.
Mediante un tipo de datos personalizado, puede presentar los datos de la manera más
adecuada para su aplicación sin cambiar ningún tipo en la base de datos subyacente. El tipo
Money muestra este principio al convertir el formato decimal de la base de datos en un
formato de divisa en la presentación. El usuario no tiene que hacer este trabajo y, además,
la base de datos retiene el formato decimal. Muchos tipos de datos personalizados
proporcionan propiedades específicas del tipo. Por ejemplo, la propiedad Symbol Mode del
tipo Money determina cómo aparece un símbolo de divisa.
Además de los tipos comerciales PhoneNumber y Money personalizados, LightSwitch

también proporciona los tipos EmailAddress, Hyperlink, Percentage, Web Address e
Image. También puede agregar otros tipos comerciales personalizados como extensiones,
como se mostrará en otra lección.
Nota
A menudo, las imágenes se almacenan en una base de datos como tipo de datos Binary. No
se puede mostrar un tipo Binary, pero puede cambiarse al tipo Image para fines de
presentación.
Pasos siguientes
En la lección siguiente aprenderá cómo presentar una lista de valores predeterminados al

usuario. Próxima lección: Presentar una lista de opciones en una aplicación de LightSwitch
Vea también
Tareas
Cómo: Definir campos de datos en una base de datos de LightSwitch
Cómo: Validar datos en una aplicación de LightSwitch
Otros recursos
Presentar una lista de opciones en una

aplicación de LightSwitch
Visual Studio 2013
Otras versiones
En esta lección, aprenderá a definir un campo de entidad para que los usuarios puedan
elegir un valor de una lista.
Crear una lista de opciones

A veces un campo de entidad representa datos que deben estar restringidos a un conjunto
pequeño de valores válidos. Por ejemplo, un campo de estado del pedido puede tener un
conjunto fijo de valores: pendiente de aprobación, listo para envío, enviado y pedido
pendiente. Para evitar que un usuario especifique un estado no válido, puede presentar estos
cuatro valores como lista de opciones.
Para crear una lista de opciones
1. En el Explorador de soluciones, abra el menú contextual del nodo Contactos.lsml y,

Se abre el Diseñador de datos y muestra la entidad Contactos.
2. En la columna Nombre, reemplace el marcador de posición<Agregar propiedad>

por TipoContacto y elija la tecla Intro.
3. En la columna Tipo, abra la lista y, a continuación, elija Integer.
4. En la columna Requerido, desactive la casilla.
5. En la ventana Propiedades, elija el vínculo Lista de opciones.
Se abre el cuadro de diálogo Lista de opciones.
6. En el cuadro de diálogo Lista de opciones, escriba los valores siguientes y, a

continuación, elija el botón Aceptar.
Valor Nombre para mostrar (Display Name)

0 Cliente existente
1 Nuevo cliente
2 Cliente potencial
7.
8. Cuando aparece este campo, los usuarios pueden abrir una lista que contiene los tres
valores de Nombre para mostrar especificados.
En este procedimiento se ha creado una lista de opciones que ofrece tres valores posibles.
Las opciones aparecen en tiempo de ejecución como una lista con tres valores de texto,
pero los datos siguen almacenados en su tipo de datos nativo, Integer. LightSwitch controla
la conversión automáticamente de modo que no es necesario escribir código alguno.
También puede crear listas de opciones en las que el valor y el nombre para mostrar sean
del mismo tipo de datos. Por ejemplo, puede proporcionar una lista fija de ciudades de
destino para una aplicación de viajes. En este caso, los valores presentados al usuario y los
valores almacenados en el origen de datos serían de tipo String. Si usa una lista de
opciones, los usuarios no podrán especificar una ciudad que no esté en la lista.
Pasos siguientes
En la lección siguiente aprenderá cómo validar una entrada de datos.
Próxima lección: Validar datos en una aplicación de LightSwitch
Vea también
Otros recursos
How to: Define a Choice List for a Entity Field
Validar datos en una aplicación de

LightSwitch
Visual Studio 2013
Otras versiones
En esta lección se muestra cómo validar los datos que un usuario escribe en una aplicación
LightSwitch.
Agregar la validación de datos
En la mayoría de las aplicaciones que implican la entrada de datos, es necesario validar los
datos antes de guardarlos. Por ejemplo, puede que desee comprobar si un número de
teléfono contiene el número correcto de dígitos o si un campo obligatorio no está vacío.
El Diseñador de datos contiene un ejemplo de un tipo de validación: cada campo de entidad

tiene una casilla Requerido. Si un campo está vacío pero marcado como necesario,
LightSwitch muestra una advertencia cuando el usuario intenta guardar los datos.
También puede administrar la validación en LightSwitch estableciendo las propiedades de

validación o escribiendo código de validación personalizada.
Para establecer propiedades de validación

2. En el Diseñador de datos, reemplace el marcador de posición <Agregar propiedad>
por EstadoContacto.
3. Asegúrese de que el tipo es String.
4. En la ventana Propiedades, establezca el valor de la propiedad Longitud máxima en
2.
Este valor garantiza que los usuarios puedan escribir más de dos caracteres en el
campo EstadoContacto.
Para agregar código de validación personalizado
1. En el Explorador de soluciones, abra el menú contextual para el nodo

Detalles_Pedido.lsml y, a continuación, elija Abrir.
2. En el Diseñador de datos, elija el campo Quantity.
3. En la ventana Propiedades, elija en el vínculo Validación personalizada.
Se abre el Editor de código y aparece un bloque de código para el método

Quantity_Validate.
4. Agregue el código siguiente al método Quantity_Validate que se encuentra

inmediatamente debajo de la línea de comentario.
Precaución
Agregue código Visual Basic o C#, según el lenguaje de programación elegido al

crear el proyecto.
5. C#
6. VB
7. Copiar
8. if (Quantity < 1)
9. {
10. results.AddPropertyError("Quantity must be greater than
zero.");
11. }
12.
13. Este código desencadena un error de validación cuando un usuario intente guardar
un valor menor que el del campo Quantity.
En esta lección se mostró cómo validar datos estableciendo las propiedades de validación o
escribiendo código de la validación. Puede establecer distintas propiedades de validación
para tipos de datos diferentes. Por ejemplo, el tipo String tiene una propiedad Longitud
máxima y el Integer tiene las propiedades Valor máximo y Valor mínimo. Todos los tipos
tienen una propiedad Es obligatorio, que se utiliza para la casilla Requerido en el Diseñador
de datos.
Las propiedades de validación para la entidad Clientes aparecen atenuadas y no se pueden

cambiar. Algunos campos como Dirección ya tienen un valor en la propiedad Longitud
máxima. No se puede establecer las propiedades de validación de una entidad a partir de un
origen de datos adjunto; únicamente se pueden establecer en las entidades que cree.
Puede agregar la validación para una entidad a partir de un origen de datos adjunto
escribiendo su propio código de validación. En cambio, no puede invalidar las propiedades
de validación existentes a menos que vaya a agregar una validación más restrictiva. Por
ejemplo, si un campo tiene una Longitud máxima de 30, no puede agregar código de
validación para establecer la longitud en 40. Sin embargo, sí puede agregar código para
restringir la longitud a menos de 30.
Pasos siguientes
En la lección siguiente, obtendrá información acerca de cómo agregar propiedades

calculadas a entidades de datos.
Próxima lección: Agregar una propiedad calculada en una aplicación de LightSwitch
Vea también
Tareas
Cómo: Validar datos en una aplicación de LightSwitch
Otros recursos
How to: Validate the Entity Data Entities
Agregar una propiedad calculada en una

Visual Studio 2013
Otras versiones
En esta lección se muestra cómo agregar una propiedad calculada a una entidad de datos en
una aplicación de LightSwitch.
Agregar una propiedad calculada
La mayoría de los datos de las aplicaciones empresariales se almacenan en una base de

datos o en otro origen de datos, pero también se puede usar una propiedad calculada para
proporcionar datos basados en un cálculo. Los datos pueden aparecer en una pantalla sin
almacenarse en una base de datos.
Por ejemplo, un total del pedido es una propiedad calculada para la que se escribe código a
fin de sumar las cantidades de artículos de línea, los impuestos y los gastos de envío.
Para agregar una propiedad calculada
1. En el Explorador de soluciones, abra el menú contextual del nodo Pedidos.lsml y, a

2. En el Diseñador de datos, reemplace el marcador de posición <Agregar propiedad>
por OrderTotal.
3. En la columna Tipo, abra la lista y, a continuación, elija Money.
En la ventana Propiedades, la propiedad EsCalculado está activa.
4. En la ventana Propiedades, elija el vínculo Editar método.
El Editor de código se abre y muestra el método OrderTotal_Compute.
5. En el método OrderTotal_Compute, agregue el siguiente código.
C#
VB
Copiar
foreach (Order_Detail od in Order_Details) {
result = result += (od.UnitPrice * od.Quantity);

}
result = result + Freight.Value;
Cuando aparezca un pedido en una pantalla, este código se ejecutará y calculará el

total del pedido.
En esta lección se ha explicado cómo agregar una propiedad calculada a una entidad para
calcular un valor. Es posible que haya observado que al agregar el campo OrderTotal a la
entidad Pedidos, dicho campo se marcó como Requerido. En la ventana Propiedades, la
opción EsCalculado se habilitó también automáticamente. Los campos calculados para las
entidades de un origen de datos asociado siempre son obligatorios y calculados.
El ejemplo de código usa una construcción For… Each para recorrer en iteración la entidad
Order_Detail. Para cada elemento de línea, el código multiplica el campo UnitPrice por el
campo Cantidad y después almacena el total acumulado en la variable de resultado. La
línea final del código agrega el valor del campo Carga al total acumulado. Para mejorar este
código, compruebe si el campo Carga tiene un valor. Tal como está escrito, el campo Carga
puede producir una excepción si un usuario lo deja vacío.
Las propiedades calculadas no siempre implican cálculos matemáticos. También puede usar
una propiedad calculada para concatenar dos cadenas. Por ejemplo, puede crear un campo
FullName que muestre un campo FirstName y un campo LastName conjuntamente. En este
caso, el código del método FullName_Compute se parecería al siguiente ejemplo.
C#
VB
Copiar
result = FirstName + " " + LastName
Para el valor de FirstName "Howard" y de LastName "Snyder", FullName aparecería en

una pantalla como "Howard Snyder".
También puede crear una propiedad calculada que use los valores de otras propiedades
calculadas. Por ejemplo, puede agregar una propiedad Impuesto a la entidad Pedidos y, a
continuación, escribir código para calcular el impuesto basado en un porcentaje de la
propiedad OrderTotal calculada.
Las propiedades calculadas también tienen algunas limitaciones. No se pueden usar en una
consulta y los usuarios finales no pueden ordenar una columna calculada ni realizar
búsquedas en ella.
Pasos siguientes
En la lección siguiente aprenderá a crear relaciones entre entidades de datos.
Próxima lección: Definir relaciones en una aplicación de LightSwitch
Vea también
Tareas
Cómo: Agregar un campo calculado en una base de datos de LightSwitch
Otros recursos
Definir relaciones en una aplicación de
LightSwitch
Visual Studio 2013
Otras versiones
En esta lección se muestra cómo definir una relación entre entidades de datos en una
aplicación de LightSwitch.
Definir una relación
Muchas aplicaciones usan información procedente de más de un origen de datos. Por

ejemplo, una aplicación en la que los usuarios realizan pedidos comerciales puede extraer
información del producto directamente desde la base de datos del fabricante. Con
LightSwitch puede definirse una relación entre entidades de distintos orígenes de datos,
siempre que los datos de un campo de uno de los orígenes se relacionen con los datos de un
campo del otro origen.
Para definir una relación

2. En la barra de herramientas del Diseñador de datos, elija el botón Relación.
Se abrirá el cuadro de diálogo Agregar nueva relación.
3. En la fila Nombre:, en la columna Hasta, elija Cliente.

4. En la fila Multiplicidad, elija Uno en la columna Desde y Cero o uno en la columna
Hasta.
5. En la sección Seleccione los campos de “Contacto” que se comparten con “Cliente”,
en la columna Contacto (externa), elija ContactPhone (PhoneNumber).
6. En la columna Cliente (principal), elija Phone (PhoneNumber) y después elija el
botón Aceptar.
Se ha definido una relación entre la entidad de contactos y la entidad de clientes. Si
un valor del campo Phone de la tabla Clientes coincide con un valor del campo
ContactPhone de la tabla Contactos, puede aparecer información sobre el cliente.
En esta lección se ha explicado cómo definir una relación entre entidades de diferentes
orígenes de datos. Seguramente habrá observado que la relación se indica en el diseñador
mediante una línea de puntos. La línea de puntos significa que la relación se establece entre
orígenes de datos distintos. Las relaciones entre entidades de un mismo origen de datos se
indican mediante una línea sólida.
También pueden definirse relaciones entre tipos dispares de orígenes de datos. Por ejemplo,
puede definirse una relación entre una entidad de datos que se haya creado en LightSwitch
y una lista de SharePoint.
Pasos siguientes
Esta lección es la última de la sección Datos del paseo guiado. En el siguiente conjunto de
lecciones, Crear pantallas, se enseña cómo crear pantallas en las que los usuarios puedan
mostrar y editar datos.
Vea también
Otros recursos
How to: Create a Relationship Between Entities
Crear pantallas
Las pantallas de LightSwitch sirven para mostrar, escribir o actualizar los datos que están
almacenados en una base de datos o en otro origen de datos. En este conjunto de lecciones,
aprenderá cómo crear una pantalla y modificar su aspecto tanto en un diseñador como en la
aplicación en ejecución.
Nota
Estas lecciones parten del proyecto Mi primera aplicación que modificó por última vez en
la lección sobre cómo definir relaciones. Si el proyecto no está abierto aún, ábralo desde el
menú Archivo, Abrir proyecto.
Lecciones
Crear una pantalla para mostrar datos en una Muestra cómo crear una pantalla de lista y
aplicación de LightSwitch detalles.
Personalizar la apariencia de la pantalla de Muestra cómo cambiar el diseño y el aspecto
una aplicación de LightSwitch de una pantalla.
Agregar una propiedad local a una Proporciona más información acerca de
aplicación de LightSwitch cómo personalizar pantallas.
Personalizar una aplicación de LightSwitch Muestra cómo realizar modificaciones
en ejecución mientras se ejecuta la aplicación.
Vea también
Conceptos
Otros recursos
Crear una pantalla para mostrar datos en

una aplicación de LightSwitch
Visual Studio 2013
Otras versiones
Personas que lo han encontrado útil: 0 de 1 - Valorar este tema
En esta lección se muestra cómo crear una pantalla, que es el elemento básico de la interfaz
de usuario para una aplicación LightSwitch. Los usuarios necesitan tener acceso a las
pantallas de la aplicación para interactuar con los datos. Algunas pantallas solo muestran
datos, aunque los usuarios pueden agregar, modificar y eliminar datos en otras pantallas.
Crear pantalla
Las pantallas de LightSwitch difieren de los formularios de las herramientas de desarrollo
tradicionales en que el diseño de pantallas está predefinido. Puede obtener una pantalla sin
necesidad de realizar modificaciones ni tener que escribir código. Sin embargo, si desea
personalizar o mejorar una pantalla, hay muchas formas de hacerlo.
Nota
Esta lección se basa en el proyecto MiPrimeraAplicación que se desarrolla en las lecciones

Trabajar con datos en LightSwitch (Paseo guiado). Si ya tiene el proyecto, ábralo ahora; en
caso contrario, complete las lecciones sobre cómo trabajar con datos en LightSwitch y, a
continuación, vuelva a esta lección.
Para crear una pantalla
1. En el Explorador de soluciones, seleccione el nodo Pantallas.

2. En la barra de menús, elija Proyecto, Agregar pantalla.
3. En el cuadro de diálogo Agregar nueva pantalla, en la lista Seleccione una plantilla
de pantalla:, elija Pantalla de lista y detalles.
4. En el cuadro de texto Nombre de pantalla, escriba PedidosPorCliente.
5. En la lista Datos de pantalla, elija NorthwindEntitiesData.Customers.
6. En la lista Datos adicionales que incluir:, active las casillas de detalles del cliente y
pedidos del cliente y, después, elija el botón Aceptar.
Se abre el Diseñador de pantallas y muestra una representación jerárquica de los

controles y los comandos para la pantalla.
En esta lección se ha mostrado cómo crear una pantalla de lista y detalles que muestra una
lista de clientes y una lista de pedidos para cada cliente. Es posible que haya observado en
el cuadro de diálogo Agregar nueva pantalla que había otras plantillas de pantalla
disponibles. Además de las plantillas incluidas en LightSwitch, hay otras plantillas
disponibles como extensiones. En una lección posterior, obtendrá más información sobre
las extensiones.
A primera vista, el Diseñador de pantallas puede parecer un poco complicado porque utiliza
una jerarquía en lugar de un paradigma WYSIWYG (lo que se ve es lo que se obtiene, por
sus siglas en inglés) para representar un diseño. Sin embargo, el modelo de jerarquía hace
que el diseño de pantallas en LightSwitch sea más rápido y flexible.
Sugerencia
Para ofrecer una vista previa de una pantalla en cualquier momento, presione F5 para
ejecutar la aplicación y mostrar la pantalla.
Pasos siguientes
En la siguiente lección, obtendrá información acerca de cómo cambiar el diseño y la

apariencia de la pantalla que acaba de crear.
Próxima lección: Personalizar la apariencia de la pantalla de una aplicación de LightSwitch
Vea también
Tareas
Cómo: Crear una pantalla de Silverlight
Otros recursos
Crear pantallas
Personalizar la apariencia de la pantalla

de una aplicación de LightSwitch
Visual Studio 2013
Otras versiones

En la siguiente lección obtendrá información acerca de cómo cambiar el diseño y la
apariencia de una pantalla en LightSwitch.
Personalizar la pantalla
El Diseñador de pantallas permite personalizar una pantalla de varias maneras. Por ejemplo,
puede cambiar el orden de visualización de los campos, cambiar el tipo de control que se
utiliza para presentar un campo o evitar que los usuarios modifiquen un campo.
Para ver una pantalla

PedidosPorCliente.lsml y, a continuación, elija Abrir.
2. Presione la tecla F5 para ejecutar la aplicación y en el menú de navegación, elija
Pedidos por cliente para mostrar el formulario.
Al seleccionar un cliente en la lista de Clientes de la izquierda, se muestran los

detalles sobre ese cliente y una lista de pedidos relacionados a la derecha.
3. En la esquina superior derecha de la ventana de aplicación, elija el botón Cerrar.
Para cambiar los nombres para mostrar
1. En el panel central del Diseñador de pantallas, elija el nodo superior Diseño de

columnas | Pedidos por cliente.
2. En la ventana Propiedades, establezca la propiedad Descripción en la opción que
permite seleccionar un cliente para ver sus pedidos.
Este mensaje aparece como información sobre herramientas para la pantalla al
ejecutar la aplicación.
3. Presione la tecla F5 para ejecutar la aplicación y, en el menú de navegación, elija

Pedidos por cliente para mostrar la pantalla. Para mostrar la información sobre
herramientas, elija “Pedidos por cliente” en la pestaña de la pantalla.
4. En la esquina superior derecha de la ventana de aplicación, elija el botón Cerrar
para cerrar la ventana.
Para cambiar los controles y el orden de visualización
1. Bajo el nodo Diseño de filas | Columna de detalles, elija el nodo de Compañía.

2. En la lista, elija Etiqueta.
Este cambio evita que los usuarios editen el campo Company cuando se ejecuta la
aplicación.
3. Mueva el nodo Teléfono debajo del nodo Compañía.
En este paso se cambia el orden de visualización en la pantalla.

Pedidos por cliente para mostrar la pantalla y comprobar los cambios.
Para deshabilitar los comandos de una cuadrícula de datos
1. Expanda el nodo Cuadrícula de datos | Pedidos.

2. Expanda el nodo Barra de comandos si aún no está expandido.
3. Elija el nodo Editar… y, a continuación, en la ventana Propiedades, desactive la
casilla Visible.
Mediante esta acción, se deshabilita el comando Editar para la cuadrícula de datos
de pedidos.
4. Repita el proceso para el nodo Eliminar.

Observe que los botones Editar y Eliminar ya no aparecen.

Para hacer que una pantalla sea de solo lectura
1. Expanda el nodo Cuadrícula de datos | Pedidos.

2. Expanda el nodo Barra de comandos.
3. Elija el nodo Agregar… y, a continuación, en la cinta de la barra de herramientas,
elija el botón Eliminar.
4. Expanda el nodo Cuadrícula de datos | Pedidos y, a continuación, elija Fila de
cuadrícula de datos | Pedido.
5. En la ventana Propiedades, active la casilla Usar controles de solo lectura.
Esto evita que los usuarios modifiquen los datos en la cuadrícula.

Observe que el botón Agregar ya no aparece y que, por lo tanto, no se pueden

modificar los datos de la cuadrícula.

En esta lección se mostró cómo realizar varias tareas para modificar el aspecto y el
comportamiento de la pantalla PedidosPorCliente. En la lección también se explicó cómo
interactúa el Árbol de contenido de pantalla del Diseñador de pantallas con la interfaz de
usuario de la pantalla en ejecución.
Al cambiar la Descripción de la pantalla, se proporciona ayuda al usuario final. Tal vez

recuerde que cambió la Descripción del campo ContactName en el Diseñador de entidades
en una lección anterior. Al establecer la Descripción en el Diseñador de entidades, el
cambio se propaga a todas las pantallas. En cambio, si se establece en el Diseñador de
pantallas, se cambia solo la pantalla con la que está trabajando.
Al cambiar el tipo de control para el campo Compañía de un cuadro de texto a una Etiqueta,
habrá observado que la lista de controles disponibles para cada campo solo incluye los
controles que son válidos para el tipo de datos subyacente del campo. Por ejemplo, para un
campo Text, puede elegir un cuadro de texto o una etiqueta. Si ha instalado una extensión
que incluye un control para mostrar Text, ese control también aparecerá en la lista. Las
extensiones se describen en otra lección.
Además de arrastrar un campo hacia otro lugar en una lista, en este caso, la lista de clientes,
también puede arrastrar los campos del panel izquierdo del Diseñador de pantallas al panel
del centro. Por ejemplo, si elimina el campo Ciudad accidentalmente, podría arrastrarlo
desde el nodo Clientes del panel izquierdo.
Al deshabilitar los comandos Editar y Eliminar en la cuadrícula Pedidos, habrá observado

que aún puede editar y eliminar los pedidos directamente en la cuadrícula. Para
solucionarlo, hicimos que la cuadrícula Pedidos sea de solo lectura estableciendo la
propiedad Usar controles de solo lectura. La propiedad Usar controles de solo lectura afecta
a todos los nodos que están debajo del árbol de contenido de pantalla. Por ejemplo, si
establece la propiedad Usar controles de solo lectura para el nodo de nivel superior
Cuadrícula | Pedidos por cliente, la pantalla entera se vuelve de solo lectura.
Nota
Cuando se establece la propiedad Usar controles de solo lectura, no se deshabilitan los
comandos Agregar, Editar o Eliminar. Los usuarios pueden modificar los datos cuando
estos comandos están habilitados.
Pasos siguientes
En la siguiente lección veremos cómo personalizar aún más la pantalla.
Próxima lección: Agregar una propiedad local a una aplicación de LightSwitch
Vea también
Tareas
Tutorial: Diseñar una pantalla de Silverlight en LightSwitch
Otros recursos
Crear pantallas
Agregar una propiedad local a una

Visual Studio 2013
Otras versiones

En esta lección, aprenderá a personalizar una pantalla en una aplicación de LightSwitch
mediante la adición de una propiedad local.
Agregar una propiedad local
Con el Diseñador de pantallas no solo puede personalizar los controles de una pantalla, sino
que también podrá agregar elementos de datos, por ejemplo, una propiedad local que puede
mostrar un valor calculado.
Para agregar una propiedad local
1. En el Explorador de soluciones, abra el menú contextual del nodo

OrdersByCustomers.lsml y, a continuación, elija Abrir.
2. En la cinta de la barra de herramientas, elija el botón Agregar elemento de datos.
3. En el cuadro de diálogo Agregar elemento de datos, elija el botón de opción
Propiedad local y después el botón Aceptar.
Un nuevo nodo denominado Property1 se agrega al panel izquierdo del Diseñador

de pantallas.
4. Elija el nodo Property1 y establezca la propiedad Nombre en NumberOfOrders.
El nombre también cambia en el panel izquierdo del diseñador.

5. Mueva el nodo NumberOfOrders justo debajo del nodo Barra de comandos bajo el
nodo Diseño de filas | Columna de detalles del panel central.
6. En la lista desplegable del nodo Number of Orders, cambie el tipo de control a
Etiqueta.
Orders By Customers para mostrar la pantalla y comprobar los cambios.
Observe que ahora el campo Number of Orders aparece en la parte superior de la

columna derecha y no se muestra ningún valor.

Para mostrar un valor para una propiedad local
1. En el panel izquierdo del Diseñador de pantallas, elija el nodo Pedidos.

2. En la cinta de la barra de herramientas, en la lista Escribir código, elija
Orders_Loaded.
El Editor de código se abre y muestra el método Orders_Loaded.
3. En el método Orders_Loaded, agregue el siguiente código.
C#
VB
Copiar
NumberOfOrders = Orders.Count.ToString();
Al seleccionar un cliente, este código calcula el número de pedidos de dicho cliente.

Ese valor se muestra para el campo Number of Orders.

Orders By Customers para mostrar la pantalla y comprobar los cambios.
Observe que, al elegir un cliente, el número de pedidos para dicho cliente se

muestra en el campo Number of Orders.

En esta lección se ha explicado cómo crear una propiedad local para mostrar un valor
calculado en una pantalla. En este caso, se ha usado el método Loaded de la colección de
pedidos para devolver el valor Count de los pedidos cada vez que se selecciona un cliente y
los pedidos para dicho cliente se cargan. Puede que haya observado que el código usa el
método ToString para convertir el valor Count en String. Esto es necesario porque la
propiedad local se definió como String en el cuadro de diálogo Agregar elemento de datos.
Si hubiera seleccionado Integer como tipo, la conversión no sería necesaria.
Además de usar una propiedad local para mostrar un valor calculado, también puede usarla
para recopilar un valor de entrada del usuario. Por ejemplo, puede crear una propiedad local
que muestre una lista de ciudades cuando un usuario especifica una región geográfica.
Pasos siguientes
En la lección siguiente aprenderá a cambiar el diseño y la apariencia de la aplicación en

ejecución.
Próxima lección: Personalizar una aplicación de LightSwitch en ejecución
Vea también
Tareas
Cómo: Agregar una propiedad local a una pantalla de Silverlight
Tutorial: Diseñar una pantalla de Silverlight en LightSwitch
Otros recursos
Personalizar una aplicación de
LightSwitch en ejecución
Visual Studio 2013
Otras versiones
En esta lección, aprenderá cambiar una aplicación de LightSwitch en ejecución.
Personalizar la aplicación en ejecución
En la lección anterior Personalizar la apariencia de la pantalla de una aplicación de

LightSwitch se mostraron varias maneras de personalizar una pantalla mediante el
Diseñador de pantallas. También se puede personalizar una pantalla mientras la aplicación
se ejecuta para poder comprobar los cambios inmediatamente.
Para habilitar la personalización
1. Presione la tecla F5 para ejecutar la aplicación.
La aplicación se abre y la pantalla ContactList aparece.
2. En la esquina inferior derecha de la ventana de la aplicación, elija el vínculo

Pantalla de diseño.
Aparece un panel de contenido de pantalla a la izquierda, con una barra de
herramientas, y un panel Propiedades bajo la ventana de la aplicación.
Para cambiar los nombres para mostrar:
1. En el panel de contenido de pantalla, elija el nodo Cuadrícula de datos| Contactos.

2. En la ventana Propiedades, establezca la propiedad Nombre para mostrar en
Contactos empresariales y, a continuación, elija la tecla TAB.
Observe que el texto del panel de contenido de pantalla cambia inmediatamente

para reflejar el nuevo valor.
3.
4. Elija el nodo Nombre de contacto y establezca la propiedad Nombre para mostrar de
este en Nombre.
5. Para los campos Empresa de contacto, Teléfono de contacto y Correo electrónico de
contacto, establezca los valores de la propiedad Nombre para mostrar en Empresa,
Teléfono y Dirección de correo electrónico respectivamente.
6. Elija el botón Guardar, en la esquina superior derecha de la ventana de la aplicación,
para guardar los cambios.
Con este paso se cierra el diseñador y se guardan los cambios de la aplicación en

ejecución.
Para cambiar los controles y el orden de visualización:

1. En la esquina inferior derecha de la ventana de la aplicación, elija el vínculo
2. En el panel de contenido de pantalla, expanda el nodo Fila de cuadrícula de datos |
Contacto y a continuación, elija el nodo Compañía.
3. En la lista, elija Etiqueta.
Este cambio impide que los usuarios modifiquen el campo Compañía en la pantalla.
4. Elija el nodo Teléfono.

5. En la barra de herramientas, elija el botón Bajar para colocar el nodo debajo del
campo Dirección de correo electrónico.
Observe que el campo Teléfono es ahora la última columna de la cuadrícula.
6. En la lista Agregar, elija ContactState.

7. En la ventana Propiedades, establezca el valor de la propiedad Nombre para mostrar
en Estado.
8. Elija el nodo de nivel superior Diseño de filas | Contactos.
9. En la barra de herramientas, elija el botón Agregar grupo.
Aparece el nuevo nodo Diseño de filas | Grupo y se selecciona.
10. En la lista Agregar, elija Elemento seleccionado.
Observe que un nuevo grupo de presentación aparece bajo la cuadrícula con campos
para el contacto seleccionado.
11. En la ventana Propiedades, elija el botón de opción Usar controles de solo lectura.
Los nuevos campos se muestran como controles Etiqueta.
12. En la ventana Propiedades, elija la lista Posición de etiqueta y seleccione Ninguno.
Se quitan las etiquetas de campo.
13. Elija el botón Guardar, en la esquina superior derecha de la ventana de la aplicación,

para guardar los cambios.
El diseñador se cierra y se guardan los cambios de la aplicación en ejecución.

En esta lección se ha explicado cómo realizar varias tareas para modificar el aspecto y el
comportamiento de la pantalla ContactList en la aplicación en ejecución. Los pasos son
similares a los empleados para realizar las mismas tareas en el Diseñador de pantallas en
tiempo de diseño, si bien hay pequeñas diferencias. Por ejemplo, no puede cambiar el
Nombre para mostrar de una pantalla en la aplicación en ejecución. No existen reglas
respecto a si las modificaciones deben realizarse en tiempo de ejecución o en tiempo de
diseño; es una cuestión de elección personal.
En esta lección también se ha explicado cómo establecer nombres para mostrar, cambiar los
tipos de control y el orden, agregar nuevos grupos y campos, establecer posiciones de
etiquetas y configurar campos únicamente de exploración. Es posible personalizar otros
muchos elementos de la pantalla, tanto en la aplicación en ejecución como en el Diseñador
de pantallas. Para obtener más información, vea Pantallas: Interfaz de usuario de una
Pasos siguientes
En el siguiente conjunto de lecciones, aprenderá a crear consultas y a usarlas en las

pantallas.
Próxima lección: Filtrar datos con consultas
Vea también
Otros recursos
Crear pantallas
How to: Customize a Screen in a Running Application
Filtrar datos con consultas

En LightSwitch, las consultas le permiten trabajar con un subconjunto de datos. Por

ejemplo, en lugar de mostrar todos los clientes, puede utilizar una consulta para mostrar
únicamente los clientes de un determinado país o región.
En este conjunto de lecciones obtendrá información acerca de cómo crear consultas simples
y parametrizadas, y cómo aplicarlas a las pantallas.
Nota
la lección Personalizar la aplicación en ejecución. Si el proyecto no está abierto aún,
ábralo desde el menú Archivo, Abrir proyecto.
Lecciones
Crear una consulta básica en Muestra cómo crear una consulta básica en el
LightSwitch Diseñador de consultas.
Crear una pantalla basada en una Muestra cómo crear una pantalla para mostrar los
consulta resultados de una consulta.
Crear una consulta parametrizada en Muestra cómo crear una consulta que incluya un
LightSwitch valor determinado en tiempo de ejecución.
Usar una consulta parametrizada en Muestra cómo visualizar los resultados de una
una pantalla de LightSwitch consulta parametrizada.
Vea también
Conceptos
Otros recursos
Consultas: Recuperar información de un origen de datos
Crear una consulta básica en LightSwitch
Visual Studio 2013
Otras versiones
En esta lección se muestra cómo crear una consulta de LightSwitch que devuelve un
subconjunto de clientes.
Crear una consulta
Una consulta devuelve datos que cumplen un conjunto de criterios. Por ejemplo, una
consulta puede devolver una lista de clientes ubicados en Estados Unidos. En este ejemplo,
los clientes son los datos y estar ubicados en Estados Unidos o Canadá es el criterio.
Nota
Esta lección se basa en el proyecto MiPrimeraAplicación que se desarrolla en la lección

Trabajar con datos en LightSwitch (Paseo guiado) y se modifica en Crear pantallas. Si ha
completado las lecciones previas, abra el proyecto ahora; de lo contrario, complete los
requisitos previos y, después, vuelva a esta lección.
Para crear una consulta

OrdersByCustomer.lsml y, a continuación, elija Abrir.
2. En el panel izquierdo del Diseñador de pantallas, elija el nodo Clientes y el vínculo
Editar consulta.
3. En el Diseñador de consultas, elija el vínculo Agregar filtro.
Se agrega una condición de filtro a la sección Filtro. Aparecen varias listas y un

cuadro de texto al lado de la condición de filtro.
4. En la primera lista, elija Donde.

5. En la segunda lista, elija País.
6. En la tercera lista, elija = (igual a).
7. En la cuarta lista, elija Literal.
8. En el cuadro de texto, escriba EE. UU. y elija de nuevo el vínculo Agregar filtro.
9. En la primera lista, elija O.
10. En la segunda lista, elija País.
12. En la cuarta lista, elija Literal.
13. En el cuadro de texto, escriba Canadá.
Esta consulta devolverá todos los registros de Clientes en los que el valor del campo
País sea igual a los valores literales "EE. UU." o "Canadá".
14. Elija el vínculo Agregar ordenación.

15. En la primera lista, elija Ciudad.
Los resultados se ordenarán por Ciudad en orden alfabético.
Al abrir la pantalla Orders by Customers, observe que solo aparecen clientes de

EE. UU. o Canadá y que los resultados se ordenan por ciudad.
En esta lección se ha explicado cómo crear una consulta que devuelve un subconjunto de
clientes. En la sección de filtro de la consulta se especificó una condición y en la sección de
ordenación se especificó cómo ordenar los resultados. Traducida al lenguaje natural, la
consulta diría: "Déme una lista de todos los clientes de EE. UU. o Canadá, ordenada por
ciudad".
En la primera lista de filtros, puede elegirse entre Donde o Donde no. Si se cambia la
cláusula a Donde no, la consulta devuelve clientes de cualquier lugar excepto EE. UU. o
Canadá.
La tercera lista de filtros contiene operadores que pueden aplicarse a la consulta. Por
ejemplo, si se hubiera elegido un campo numérico en la segunda lista, podría seleccionarse
> (es mayor que) para devolver solamente los registros que superan una cantidad
especificada.
La cuarta lista de filtros contiene tres opciones: Literal, Propiedad y Parámetro. Tal y como
se muestra en esta lección, Literal quiere decir que el criterio es un valor literal. Si se
hubiera elegido Propiedad, se habría mostrado una lista de los campos de la entidad
Clientes para poder filtrar los resultados por propiedad. Por ejemplo, podría devolver todos
los clientes cuyo ContactName coincida con CompanyName. La opción Parámetro se
describe en la lección Crear una consulta parametrizada en LightSwitch.
La sección de ordenación de una consulta determina el orden en que los resultados se

muestran inicialmente en una pantalla de la aplicación en ejecución. El usuario puede
cambiar el criterio de ordenación posteriormente.
Pasos siguientes
En la lección siguiente aprenderá cómo crear una pantalla basada en una consulta.
Próxima lección: Crear una pantalla basada en una consulta
Vea también
Tareas
Cómo: Agregar, quitar y modificar una consulta
Cómo: Extender una consulta usando código
Otros recursos
Crear una pantalla basada en una consulta

Visual Studio 2013
Otras versiones
En esta lección se creará una pantalla de LightSwitch basada en una consulta. Al crear la
consulta primero, puede limitar los tipos de datos que se muestran en la pantalla asociada.
Crear una pantalla basada en una consulta
En una lección anterior, Crear una consulta básica en LightSwitch, se mostraba cómo usar
una consulta para filtrar los resultados en una pantalla creada originalmente a partir de una
entidad Clientes. Al crear una pantalla basada directamente en una consulta, puede
restringir la cantidad de datos que aparecen y controlar el criterio de ordenación.
Para crear una pantalla a partir de una consulta
1. En el Explorador de soluciones, abra el menú contextual del nodo Productos.lsml y,

a continuación, elija Agregar consulta.
Aparece el Editor de consultas.
2. En la ventana Propiedades, asigne a la consulta el nombre CurrentProducts.

5. En la segunda lista, elija Discontinued.
Observe que el valor de lista final cambia a False.

6. En el Diseñador de consultas, elija el vínculo Agregar ordenación.
7. En la primera lista, elija ProductName.
8. En el Diseñador de consultas, en la barra de herramientas, elija el botón Agregar
pantalla.
Aparecerá el cuadro de diálogo Agregar nueva pantalla.
9. En la lista Seleccione una plantilla de pantalla, elija Pantalla de lista y detalles.

10. En el cuadro de texto Nombre de pantalla, escriba CurrentProductList.
11. En la lista Datos de pantalla, elija – CurrentProducts y elija el botón Aceptar.
Al abrir la pantalla Current Product List, observe que únicamente se muestran los
productos que no se han suspendido y que se enumeran en orden alfabético.
En esta lección se ha explicado cómo crear una consulta y, después, crear una pantalla para
mostrar los resultados, en este caso, productos que no se han suspendido. Si se hubiera
creado la pantalla a partir de la entidad Productos, los resultados habrían incluido productos
suspendidos. Al crear una consulta primero, puede limitar los datos que se muestran en la
pantalla asociada.
Este tipo de consulta se conoce como consulta global; se puede reutilizar en varias
pantallas. Una consulta global también se puede usar como origen de una nueva consulta
global siempre que ambas devuelvan el mismo tipo de entidad.
Pasos siguientes
En la lección siguiente aprenderá cómo crear una consulta parametrizada.
Próxima lección: Crear una consulta parametrizada en LightSwitch
Vea también
Tareas
Otros recursos
Crear una consulta parametrizada en

LightSwitch
Visual Studio 2013
Otras versiones
En esta lección se muestra cómo crear una consulta parametrizada en una aplicación de
LightSwitch.
Crear una consulta parametrizada
Una consulta parametrizada determina qué datos se van a devolver mediante la evaluación
de uno o más valores cuando se ejecuta la aplicación. Por ejemplo, una consulta
parametrizada puede devolver una lista de productos que pertenecen a una categoría
determinada identificada por un parámetro. El parámetro puede establecerse mediante
programación, pero la mayoría de las aplicaciones usan parámetros que reflejan valores
establecidos por un usuario.
Para crear una consulta parametrizada
1. En el Explorador de soluciones, elija el nodo Products.lsml.

2. En la barra de menús, elija Proyecto, Agregar consulta.
Se abre el Editor de consultas.

3. En la ventana Propiedades, asigne a la consulta el nombre ProductsByCategory.
6. En la segunda lista, elija Category.CategoryID.
8. En la cuarta lista, elija Parámetro.
9. En la lista final, elija Agregar nuevo.
Se crea un parámetro denominado CategoryID, de tipo Integer, y se agrega a la

sección Parámetros del Editor de consultas.
En esta lección se ha explicado cómo crear una consulta parametrizada que devuelve un
subconjunto de productos. En tiempo de ejecución, se proporciona un cuadro CategoryID
para que un usuario pueda especificar un valor numérico para el parámetro CategoryID. Por
ejemplo, si el usuario especifica 1 en el cuadro, se devolverán todos los productos de la
categoría Bebidas. Si el usuario especifica 2, se devolverán Condimentos.
El valor del parámetro puede escribirse en un cuadro de texto o seleccionarse en una lista.
También puede proporcionarlo otra entidad en una pantalla. Por ejemplo, cuando un
producto se selecciona en una pantalla, puede usar su CategoryID como parámetro para
devolver el resto de productos de la misma categoría.
Pasos siguientes
En la siguiente lección aprenderá a usar la consulta parametrizada que acaba de crear en

una pantalla.
Próxima lección: Usar una consulta parametrizada en una pantalla de LightSwitch
Vea también
Tareas
Cómo: Proporcionar un valor a un parámetro de consulta

Otros recursos
Usar una consulta parametrizada en una

pantalla de LightSwitch
Visual Studio 2013
Otras versiones
En esta lección aprenderá a filtrar datos en una pantalla usando una consulta parametrizada.
Usar una consulta parametrizada
En la lección anterior, se creó una consulta para filtrar productos en función de un

parámetro CategoryID. En tiempo de ejecución, este parámetro se puede usar para aplicar
el filtro a otra entidad que contenga un campo CategoryID. Por ejemplo, puede usar la
consulta parametrizada para mostrar todos los productos incluidos en la misma categoría
que el producto que aparece en la pantalla.
El valor del parámetro puede proporcionarse como propiedad en el Diseñador de pantallas

en tiempo de diseño o por parte del usuario en tiempo de ejecución. En este ejemplo, el
valor se asignará en tiempo de diseño.
Para agregar una consulta parametrizada a una pantalla

CurrentProductList.lsml y, a continuación, elija Abrir.
2. En la barra de herramientas del Diseñador de pantallas, elija el botón Agregar
elemento de datos.
3. En el cuadro de diálogo Agregar elemento de datos, elija el botón de opción
Consulta.
4. En la columna Nombre, elija NorthwindEntitiesData.ProductsByCategory y elija el
botón Aceptar.
Aparece un nodo ProductsByCategoryCollection en el panel izquierdo.
5. Bajo el nodo Parámetros de la consulta, elija el nodo CategoryID.

6. En la ventana Propiedades, establezca la propiedad Enlace de parámetros en
CurrentProducts.SelectedItem.Category.CategoryID.
7. En el Diseñador de pantallas, elija el nodo Diseño de filas | Columna de detalles.
8. En la lista Agregar, elija ProductsByCategory.
Aparece un nodo Cuadrícula de datos | ProductsByCategory en el árbol de

contenido de pantalla.
9. Elija la tecla F5 para ejecutar la aplicación y ver los resultados.
Al abrir la pantalla CurrentProductList, observe que todos los productos con el

mismo CategoryID que el producto actualmente seleccionado se muestran en la
nueva cuadrícula.
En este procedimiento, se ha usado la consulta parametrizada creada en la última lección

para mostrar una lista de productos. La consulta se agregó a una pantalla existente, la
pantalla CurrentProductList. La propiedad Valor del parámetro de la consulta especifica el
valor CategoryID de la ProductCollection existente en la pantalla y proporciona el
parámetro en tiempo de ejecución. Como resultado, cada vez que un producto se selecciona
en la lista ProductCollection, se muestra una lista de productos que tienen un valor
CategoryID coincidente.
Pasos siguientes
En el siguiente conjunto de lecciones, aprenderá cómo trabajar con menús y comandos.
Próxima lección: Crear menús y comandos

Vea también
Tareas
Cómo: Proporcionar un valor a un parámetro de consulta
Otros recursos
Crear menús y comandos

Los menús de LightSwitch permiten que los usuarios muestren pantallas, y los comandos
les permiten realizar una acción. Puede crear comandos y mostrarlos como botones en una
pantalla o en la barra de herramientas de la aplicación.
En este conjunto de lecciones aprenderá a crear comandos y a personalizar menús.
Nota
la lección sobre cómo usar consultas parametrizadas en una pantalla. Si el proyecto no está
abierto aún, ábralo desde el menú Archivo, Abrir proyecto.
Lecciones
Agregar un comando a una pantalla de Muestra cómo crear un comando y cómo
LightSwitch mostrarlo en una pantalla.
Agregar un comando de shell a una barra de
Muestra cómo crear un comando y cómo
herramientas de la aplicación en
mostrarlo en la barra de herramientas.
LightSwitch
Personalizar elementos de menú en una Muestra cómo modificar el menú de
aplicación de LightSwitch navegación.
Agregar un grupo de menús a una aplicación Muestra cómo crear nuevos grupos de
de LightSwitch menús.
Configurar la pantalla de inicio de una Muestra cómo seleccionar la pantalla que se
aplicación de LightSwitch muestra cuando el usuario abre la aplicación.
Vea también
Tareas
Cómo: Agregar un comando personalizado a una pantalla de Silverlight
Cómo: Crear elementos de menú y grupos de navegación en LightSwitch
Conceptos
Agregar un comando de shell a una barra

de herramientas de la aplicación en
LightSwitch
Visual Studio 2013
Otras versiones

En esta lección se muestra cómo agregar un comando a la barra de herramientas de la
aplicación y cómo escribir código que se ejecuta cuando un usuario elige el comando. El
comando ejecuta una consulta parametrizada y después muestra los resultados en una
pantalla de búsqueda.
Agregar un comando Shell
En la lección anterior, se agregó un comando que aparece en la barra de comandos de una

pantalla. También se puede programar un botón de la barra de herramientas para realizar
otras tareas, por ejemplo, abrir otra pantalla, aplicar un filtro a los datos o incluso enviar un
correo electrónico.
Para agregar una consulta parametrizada
1. En el Explorador de soluciones, elija el nodo Clientes.lsml.

2. En la barra de menús, elija Proyecto, Agregar consulta.
3. En la ventana Propiedades, establezca la propiedad Nombre en MatchCustomer.
5. En la segunda lista, elija NombreContacto.
7. En la lista final, elija Agregar nuevo.
Se agrega un nuevo parámetro denominado NombreContacto, de tipo String, a la

sección Parámetros del Editor de consultas.
Para agregar una pantalla de búsqueda
1. En el Explorador de soluciones, abra el menú contextual del nodo Pantallas y, a

continuación, elija Agregar pantalla.
2. En el cuadro de diálogo Agregar nueva pantalla, en la lista Seleccione una plantilla
de pantalla, elija Pantalla de búsqueda de datos.
3. En el cuadro de texto Nombre de pantalla, escriba BuscarCliente.
4. En la lista Datos de pantalla, elija – CoincidirConCliente y elija el botón Aceptar.
5. En el panel izquierdo del Diseñador de pantallas, elija el nodo
NombreDeContactoDelCliente.
6. En la ventana Propiedades, active la casilla Es un parámetro.
Para agregar un comando a la barra de herramientas de la aplicación
1. En el Explorador de soluciones, abra el menú contextual del nodo ListaDeContactos

y, a continuación, elija Abrir.
2. En el Diseñador de pantallas, expanda el nodo Barra de comandos de pantalla.
3. En la lista Agregar, elija Botón Nuevo.
4. En el cuadro de diálogo Agregar botón, elija el botón de opción Nuevo método,
asigne al botón el nombre Buscar y, después, elija el botón Aceptar.
5. En la ventana Propiedades, establezca la propiedad Descripción en Buscar el
contacto seleccionado en la lista de clientes.
6. Elija el vínculo Elegir imagen.
7. En el cuadro de diálogo Seleccionar imagen, elija el botón Importar.
8. En el cuadro de diálogo Abrir, navegue hasta un directorio que contenga imágenes,
elija una imagen y, a continuación, elija el botón Abrir.
9. Elija el botón Aceptar para cerrar el cuadro de diálogo Seleccionar imagen.
10. En el panel izquierdo, elija el nodo Buscar.
11. En la ventana Propiedades, elija el vínculo Editar código de ejecución.
El Editor de código se abre y muestra el método Find_Execute().
12. En el método Find_Execute(), agregue el siguiente código.
C#
VB
Copiar
Application.ShowSearchCustomer(Contacts.SelectedItem.ContactName);
Cuando un usuario hace clic en el botón que se acaba de crear, este código muestra
la pantalla ShowSearchCustomer.
Compruebe el nuevo comando; para ello, elija Howard Snyder en la lista Contactos
y, a continuación, elija el botón Buscar.
Aparece la pantalla BuscarCliente y muestra los datos de Mercado de alimentos
Great Lakes. Al elegir Mercado de alimentos Great Lakes en la columna Compañía,
aparece una pantalla con detalles del cliente.
En esta lección se ha explicado cómo crear una consulta parametrizada que devuelve los
Clientes que coinciden con un parámetro NombreContacto y cómo crear una pantalla de
búsqueda basada en la consulta. Es posible que haya observado que la pantalla
BuscarCliente no aparece en el menú de navegación de la aplicación en ejecución. Las
pantallas basadas en consultas parametrizadas solo se pueden abrir ejecutando un comando
y no se pueden agregar al menú.
Después se ha mostrado cómo agregar un comando a la pantalla ListaDeContactos, cómo

asignarle un Nombre para mostrar, una Descripción y una Imagen, y cómo agregar el
código que se ejecuta cada vez que se elige el botón de comando. El código ejecuta el
método ShowSearchCustomer, que muestra la pantalla BuscarCliente. El código entre
paréntesis es el parámetro para el método. En este caso, el parámetro es NombreContacto
para el elemento seleccionado en la colección Contactos.
Es posible que haya observado que el comando únicamente aparece en la barra de

herramientas de la aplicación cuando la pantalla Lista de contactos está seleccionada. Dado
que los comandos que se agregan a la barra de herramientas son específicos de la pantalla,
debe crear un comando individual para cada pantalla.
Pasos siguientes
En la lección siguiente aprenderá a agregar un elemento al menú de navegación.
Próxima lección: Personalizar elementos de menú en una aplicación de LightSwitch
Vea también
Tareas
Cómo: Agregar un comando personalizado a una pantalla de Silverlight
Otros recursos
Personalizar elementos de menú en una

Visual Studio 2013
Otras versiones
En esta lección se muestra cómo cambiar el menú de navegación en una aplicación de

LightSwitch.
Personalización de menús
Cuando se ejecuta una aplicación, el menú de navegación muestra las pantallas que el
usuario puede mostrar. Puede agregar o quitar elementos de menú, cambiar el texto del
menú y cambiar el orden en que aparecen los elementos.
Para agregar o quitar un elemento de menú

2. En la barra de menús, elija Proyecto, Editar navegación de pantalla.
Aparece la pestaña Navegación de pantalla del diseñador DesktopClient.
3. En la pestaña Navegación de pantalla, bajo el nodo Tareas, abra el menú contextual

del nodo Lista de productos actual y elija Eliminar.
El elemento de menú Lista de productos actual desaparece del menú de navegación.
4. En la lista Incluir pantalla, elija Lista de productos actual.

El elemento de menú Lista de productos actual aparece en la parte inferior de la
sección Tareas del menú de navegación.
Para cambiar el texto del menú
1. Abra el menú contextual del nodo Lista de contactos, elija Cambiar nombre y,
después, asigne al campo el nombre Contactos.
2. Use los mismos pasos para cambiar el nombre del nodo Lista de productos actual a
Productos.
Para reordenar los elementos de menú
1. Elija el nodo Productos.

2. En el margen derecho del diseñador, elija el botón Subir.
El elemento de menú Productos se sitúa sobre el elemento de menú Pedidos por

cliente.
3. Elija la tecla F5 para ejecutar la aplicación y compruebe los cambios en el menú de

navegación.
Al quitar y agregar elementos del menú de navegación anteriormente en esta lección, puede
que haya notado que la lista Incluir pantalla contiene dos elementos adicionales: Usuarios y
Roles. Estos se relacionan con la autenticación y la autorización, que se describen en otra
lección. La lista Incluir pantalla también contiene pantallas que ya están en el menú de
navegación. Aunque puede agregar un segundo elemento de menú para una pantalla,
simplemente tendría elementos duplicados porque ambos abren la misma instancia de la
pantalla.
Al cambiar de nombre un elemento de menú, solo se ve afectado el nombre que aparece en

la aplicación en ejecución. El nombre de la pantalla real permanece sin cambios.
Al reordenar elementos de menú mediante los botones Subir y Bajar, solo puede reordenar
los elementos de ese grupo (en este caso, el grupo Tareas). En la lección siguiente se
describen los grupos de menús.
Puede que también haya observado que el elemento de menú de lista de Contactos está en
negrita, lo que indica que la pantalla Contactos aparece en primer lugar cuando se inicia la
aplicación. En una lección posterior, Configurar la pantalla de inicio de una aplicación de
LightSwitch, se enseña cómo cambiar la pantalla de inicio.
Pasos siguientes
En la lección siguiente aprenderá a crear grupos de menús.
Próxima lección: Agregar un grupo de menús a una aplicación de LightSwitch
Vea también
Tareas
Otros recursos
Agregar un grupo de menús a una

Visual Studio 2013
Otras versiones
En esta lección, aprenderá cómo agrupar elementos en el menú de navegación para una
Agregar un grupo de menús

En la lección anterior, aprendió a personalizar elementos en el menú de navegación,
compuesto de un grupo de menú único denominado Tareas. Es posible que, cuantas más
pantallas se agreguen a la aplicación, desee agrupar las pantallas similares para presentar
una vista más lógica al usuario.
Para agregar un grupo de menús

3. En el Diseñador de aplicaciones, elija el nodo Agregar grupo.
Se abre un nuevo grupo de menús denominado Grupo.
4. Llame al grupo Información del producto.

5. Con el nodo Información del producto seleccionado, elija el botón Subir para mover
dicho nodo sobre el nodo Administración.
6. En la lista Incluir pantalla bajo el nodo Información del producto, elija Productos.
7. Abra el menú contextual del nodo Productos bajo el nodo Tareas y después elija
Eliminar.
8. Abra el menú contextual del nodo Tareas, elija Cambiar nombre y, a continuación,
escriba Administración de clientes.
El grupo de menús Administración de clientes contiene los elementos de menú

Contactos y Pedidos por cliente. El grupo de menús Información del producto
contiene el elemento de menú Productos.
En este procedimiento ha aprendido a agregar un grupo de menús al menú de navegación,

reordenar grupos, mover elementos de menú entre grupos y cambiar el nombre de los
grupos. El proceso es similar a trabajar con elementos de menú.
En algunos casos, es posible que desee que una pantalla esté disponible desde varios grupos
de menús. Por ejemplo, una pantalla de búsqueda de inventario puede ser útil para un
empleado que trabaja con clientes o productos. No es necesario quitar un elemento de menú
de un grupo para agregarlo a otro; un elemento de menú puede aparecer en más de un
grupo.
Pasos siguientes
En la siguiente lección aprenderá a cambiar la pantalla de inicio.
Próxima lección: Configurar la pantalla de inicio de una aplicación de LightSwitch
Vea también
Tareas
Otros recursos
Configurar la pantalla de inicio de una

Visual Studio 2013
Otras versiones
En esta lección, se explicará cómo cambiar la pantalla de inicio de una aplicación

LightSwitch.
Configurar la pantalla de inicio

Cuando los usuarios ejecutan una aplicación, lo que primero aparece es la pantalla de
inicio. De forma predeterminada, la primera pantalla que crea se establece como pantalla de
inicio. En muchos casos, puede que desee mostrar una pantalla diferente al inicio. Por
ejemplo, si la mayoría de los usuarios realizan la entrada de pedidos, probablemente desee
mostrar una pantalla de entrada de pedidos cuando se inicie la aplicación.
Para cambiar la pantalla de inicio

3. En el Diseñador de aplicaciones, elija el nodo Pedidos por cliente.

4. En la parte inferior del Diseñador de aplicaciones, elija el botón Establecer.
Aparece el nodo Pedidos por cliente en negrita, lo que significa que es ahora la
pantalla de inicio.
5. Elija la tecla F5 para ejecutar la aplicación y comprobar los cambios.
Cuando la aplicación se inicie, aparecerá primero la pantalla Pedidos por cliente.
En esta lección, se explicó cómo cambiar la pantalla de inicio de la aplicación. No es

necesario que la pantalla de inicio esté en el primer grupo de menús. No obstante, solo el
primer grupo de menús aparece siempre expandido, y es posible que el elemento de menú
de la pantalla de inicio no aparezca. No es obligatorio establecer una pantalla de inicio. Si
elige el nodo de pantalla de inicio actual y, a continuación, elige el botón Borrar, aparece
un shell de aplicación vacío cuando la aplicación se inicia.
Pasos siguientes
En el siguiente conjunto de lecciones, aprenderá a establecer más propiedades para la

aplicación.
Próxima lección: Cambiar la configuración de la aplicación
Vea también
Otros recursos
Administrar la configuración en LightSwitch
Cambiar la configuración de la aplicación

Visual Studio 2013
Otras versiones
Las propiedades del proyecto de LightSwitch permiten administrar la configuración de la

aplicación y agregar iconos e imágenes.
En este conjunto de lecciones, obtendrá información sobre cómo establecer propiedades de

proyecto adicionales.
Nota
la lección Configurar la pantalla de inicio. Si el proyecto no está abierto aún, ábralo desde
el menú Archivo, Abrir proyecto.
Lecciones
Establecer propiedades de la aplicación en Muestra cómo establecer las propiedades
LightSwitch generales del proyecto.
Agregar un icono de programa a una Muestra cómo agregar imágenes a la
aplicación de LightSwitch aplicación.
Vea también
Tareas
Cómo: Administrar la configuración de la aplicación en LightSwitch
Conceptos
Establecer propiedades de la aplicación en

LightSwitch
Visual Studio 2013
Otras versiones
En esta lección, aprenderá a establecer propiedades adicionales de las aplicaciones en

LightSwitch.
Establecer propiedades de la aplicación
En lecciones anteriores, aprendió a establecer propiedades de aplicación para la navegación

de pantalla, el control de acceso y las extensiones. Se pueden establecer varias propiedades
más para las aplicaciones relacionadas con el nombre para mostrar, la versión de la
aplicación y el tipo de cliente.
Para cambiar el nombre para mostrar de la aplicación
1. En el Explorador de soluciones, abra el menú contextual del nodo Propiedades y, a

2. En el Diseñador de aplicaciones, elija la pestaña Propiedades generales y, a
continuación, elija el vínculo Editar propiedades de DesktopClient.
Se abre el diseñador DesktopClient.
3. En el cuadro de texto Nombre de la aplicación, escriba Aplicación Northwind.
Para cambiar la versión de la aplicación
 En el Explorador de soluciones, abra el menú contextual del nodo Propiedades y, a

 En la pestaña Propiedades generales, elija la propiedad Versión de la aplicación.
 En el segundo cuadro de texto, escriba 1000.
Para cambiar el tipo de cliente
1. En el Explorador de soluciones, abra el menú contextual del nodo Propiedades y, a

3. En el diseñador DesktopClient, elija la pestaña Tipo de cliente.
4. En la sección Cliente, elija el botón de opción Web.
Ahora la aplicación se ejecuta dentro del explorador web y su título es Aplicación

Northwind.
En esta lección ha aprendido cómo establecer propiedades adicionales de las aplicaciones.

El nombre predeterminado de una aplicación es el nombre del proyecto. El nombre de
proyecto no puede contener espacios. Por tanto, resulta conveniente cambiar la propiedad
Nombre de la aplicación por un nombre más fácil de leer.
La versión de la aplicación se compone de un número de versión principal y otro de versión

secundaria. Normalmente, el número de versión secundaria debe cambiarse cada vez que se
publique la aplicación (por ejemplo, después de corregir un error). El número de versión
principal suele cambiarse cuando se realiza una modificación importante, como agregar
pantallas. En esta lección, la versión secundaria se establece en 1000 para poder publicar
miles de actualizaciones de la versión 1 de la aplicación.
Puede establecer la propiedad Tipo de cliente para un cliente de escritorio o un cliente de

explorador para la aplicación. Un cliente de escritorio se instala en un equipo local y se
abre desde el menú Inicio. Una aplicación de explorador se instala en un servidor remoto y
se abre desde una dirección URL. En una topología local, tanto la aplicación como la base
de datos de aplicación se encuentran en el equipo local; la base de datos no se puede
compartir. En una topología de Internet Information Services o Microsoft Azure, la base de
datos de aplicación se encuentra en un servidor para que varios usuarios puedan tener
acceso a ella.
La propiedad Tipo de cliente puede cambiarse en cualquier momento, incluso después de

implementar la aplicación.
Precaución
Si la aplicación incluye código con acceso a recursos locales, como el sistema de archivos,
dicho código podría producir errores en tiempo de ejecución en un cliente web. Así,
deberá quitar o marcar como comentario todo código que tenga acceso a recursos locales
antes de cambiar una aplicación para un cliente web.
Pasos siguientes
En la lección siguiente aprenderá cómo establecer propiedades para los iconos y las
imágenes de los programas.
Próxima lección: Agregar un icono de programa a una aplicación de LightSwitch
Vea también
Tareas
Conceptos
Agregar un icono de programa a una
Visual Studio 2013
Otras versiones
En esta lección aprenderá a agregar un icono de programa a la aplicación LightSwitch. Este

icono aparecerá junto al nombre de la aplicación en el menú Inicio, en la barra de tareas o
en cualquier otra parte.
Agregar un icono
Para agregar un icono de programa
1. En el Explorador de soluciones, abra el menú contextual para el nodo Propiedades

3. En la pestaña Propiedades del cliente, elija el botón Seleccionar a la derecha del
campo Icono de aplicación.
4. En el cuadro de diálogo Seleccionar imagen, elija el botón Importar.
5. En el cuadro de diálogo Abrir, vaya al directorio que contiene los archivos de
imagen .png, elija cualquier imagen y, a continuación, elija el botón Abrir.
Nota
Las imágenes de icono deben ser archivos .png que miden 32 por 32 píxeles.
6. Elija el botón Aceptar para cerrar el cuadro de diálogo Seleccionar imagen.
En esta lección ha aprendido cómo agregar imágenes a la aplicación. La propiedad Icono de
aplicación toma un archivo .png que puede crear mediante Paint u otro programa de
gráficos. El icono aparece en el menú Inicio, en la barra de tareas cuando la aplicación se
está ejecutando o en cualquier otro lugar en el que pueda aparecer un icono de programa.
El Icono de aplicación se almacena como un recurso en la aplicación. El mismo recurso de

imagen puede aparecer en varios lugares de la aplicación.
Pasos siguientes
En el siguiente conjunto de lecciones, obtendrá información sobre cómo habilitar la

autenticación y la autorización en la aplicación.
Próxima lección: Habilitar autorización y crear permisos
Vea también
Tareas
Conceptos
Habilitar autorización y crear permisos

Las características de autorización y de autenticación de LightSwitch sirven para controlar

el acceso a las pantallas y a los datos. Por ejemplo, puede crear un permiso para ver una
pantalla de nómina y el administrador de la aplicación puede conceder o denegar ese
permiso a los grupos de usuarios definidos como roles.
En este conjunto de lecciones, aprenderá a habilitar la autenticación y a crear permisos.
Nota
la lección Agregar un logotipo y un icono. Si el proyecto no está abierto aún, ábralo desde
el menú Archivo, Abrir proyecto.
Lecciones
Habilitar la autenticación en LightSwitch Muestra cómo autenticar usuarios.
Muestra cómo crear un permiso para ver una
Crear permisos en LightSwitch
pantalla.
Restringir el acceso a una pantalla de Muestra cómo aplicar un permiso en el
LightSwitch código.
Usar permisos de depuración para probar Muestra cómo ejecutar la aplicación con un
código de LightSwitch conjunto de permisos.
Vea también
Tareas
Cómo: Habilitar la autenticación en una aplicación de cliente de Silverlight
Conceptos
Habilitar la autenticación en LightSwitch

Visual Studio 2013
Otras versiones
En esta lección se muestra cómo habilitar la autenticación para una aplicación LightSwitch.
Habilitar la autenticación
La mayoría de las aplicaciones empresariales incluyen características de seguridad para

evitar que los usuarios sin autorización consulten, manipulen o eliminen datos. En
LightSwitch, puede aumentar la seguridad de su aplicación mediante la implementación de
la autenticación, según la cual los usuarios se deben identificar para obtener acceso a la
aplicación. El primer paso para proteger la aplicación consiste en habilitar la autenticación.
Para habilitar la autenticación

2. En el Diseñador de aplicaciones, elija la pestaña Control de acceso.
3. En la lista Seleccione el tipo de autenticación que desea usar:, elija el botón de
opción Usar autenticación de Windows.
A partir de ahora, la aplicación requerirá que los usuarios se autentiquen para tener
acceso a la aplicación.
En esta lección se muestra cómo habilitar la autenticación de Windows para una aplicación.
Con la autenticación de Windows, la aplicación autentica a un usuario en función de las
mismas credenciales que el usuario proporciona para iniciar sesión en el equipo que está
ejecutando la aplicación. No se requiere ningún nombre de usuario adicional ni contraseña.
Nota
Mientras desarrolla la aplicación, no se le solicitará ningún nombre de usuario y

contraseña; la sesión se inicia automáticamente como un usuario de prueba.
La otra opción de autenticación es Usar autenticación de formularios, que controla la propia

aplicación. El administrador de la aplicación mantiene una lista de usuarios autorizados y
contraseñas, y los usuarios deben proporcionar un nombre de usuario y una contraseña para
tener acceso a la aplicación. La autenticación de formularios representa una buena opción
cuando varios usuarios comparten un equipo con una misma una cuenta.
Pasos siguientes
En la siguiente lección, aprenderá a restringir el acceso a partes de la aplicación en lugar de

a toda la aplicación.
Próxima lección: Crear permisos en LightSwitch
Vea también
Tareas
Otros recursos
Crear permisos en LightSwitch

Visual Studio 2013
Otras versiones
En esta lección aprenderá a crear permisos para una aplicación LightSwitch.

Crear permisos
Puede utilizar los permisos para restringir el acceso a determinadas partes de una aplicación
como, por ejemplo, una pantalla que permita a los usuarios modificar datos. Por ejemplo,
en una aplicación de nóminas se puede permitir a los empleados que vean la información de
su nómina, pero no que la modifiquen. No obstante, se puede configurar un supervisor de
nóminas que tenga permisos para ver y cambiar la información de nómina de cualquier
empleado. Puede definir permisos que otorguen más accesos al supervisor.
Para crear un permiso

Se abre el Diseñador de aplicaciones.

3. En la cuadrícula Defina o seleccione los permisos que se usarán para la depuración,
sustituya el marcador de posición <Agregar nuevo permiso> por
Can_View_Products.
4. En la columna Nombre para mostrar, escriba Ver productos.
5. En la columna Descripción, escriba Permite el acceso a la pantalla de productos y, a
continuación, elija la tecla Entrar.
En esta lección, ha aprendido a definir un permiso para la aplicación. Puede asignar un

permiso a un usuario o a un grupo de usuarios, y el permiso puede habilitar o deshabilitar
pantallas cuando se carga la aplicación.
Puede crear permisos tan específicos como sea necesario. Además, puede crear un permiso
para cada pantalla de la aplicación, o puede aplicar un permiso único a varias pantallas. Por
ejemplo, puede crear un permiso Administrador que permita a los administradores obtener
acceso a varias pantallas.
Pasos siguientes
En la lección siguiente, obtendrá información sobre cómo aplicar el permiso que acaba de
crear para restringir el acceso a una pantalla.
Próxima lección: Restringir el acceso a una pantalla de LightSwitch

Vea también
Tareas
Otros recursos
Restringir el acceso a una pantalla de

LightSwitch
Visual Studio 2013
Otras versiones
En esta lección, aprenderá a aplicar un permiso para restringir el acceso a una pantalla en
una aplicación LightSwitch.
Restringir acceso
En la lección anterior, creó un permiso para ver productos. Este permiso es un objeto al que
se puede hacer referencia en el código que se escribe para comprobar los permisos para una
pantalla. Si el permiso está asignado al usuario actual, se muestra el elemento de menú para
la pantalla en tiempo de ejecución.
Para utilizar un permiso

2. En el Diseñador de aplicaciones, elija el vínculo Editar propiedades de
DesktopClient.
3. En el Diseñador de DesktopClient, elija la pestaña Navegación de pantalla.
4. Abra el menú contextual para el nodo Productos y, a continuación, elija Editar
código de CurrentProductList_CanRun.
Aparece el Editor de código y muestra el método CurrentProductList_CanRun.
5. En el Editor de código, escriba el siguiente código en el método

CurrentProductList_CanRun:
C#
VB
Copiar
if (this.User.HasPermission(Permissions.Can_View_Products))
{
result = true;
}
else
{
result = false;
}
Este código se evalúa cada vez que se inicia la aplicación.
En esta lección, obtuvo información acerca de cómo aplicar un permiso para restringir el
acceso a una pantalla. Cada pantalla tiene un método CanRun que se puede utilizar para
comprobar permisos. En este caso, el código ejecuta el método HasPermission, y
comprueba si el permiso Can_View_Products está asignado al usuario actual. Si lo está, el
método devuelve un valor result equivalente a True, y si no lo está, devuelve un valor result
igual a False. Cuando la aplicación se carga, utiliza el valor result para determinar si se
debería mostrar el elemento de menú Productos.
Este es solo un ejemplo del código que se podría escribir para el método CanRun. También
puede escribir código para comprobar varias condiciones o el estado de otros objetos al
tomar una decisión.
Pasos siguientes
En la siguiente lección, aprenderá a utilizar los permisos de depuración para probar el

código.
Próxima lección: Usar permisos de depuración para probar código de LightSwitch
Vea también
Tareas
Otros recursos
Usar permisos de depuración para probar

código de LightSwitch
Visual Studio 2013
Otras versiones
En esta lección, aprenderá a probar el código de permisos mediante el uso de permisos de

depuración. Al usar permisos de depuración, puede simular la experiencia de los usuarios
finales según sus roles y permisos.
Uso de permisos de depuración
En la lección anterior, escribió el código que determinó los permisos para ver la pantalla
Productos. El administrador de la aplicación asigna permisos a los roles. Para probar el
código, es posible que desee ejecutar la aplicación como un usuario con permiso y sin
permiso. Para ello, establezca los permisos de depuración que le permitan ejecutar la
aplicación como un usuario con dichos permisos mientras prueba o depura la aplicación.
Para establecer permisos de depuración

Se abrirá el .

3. En la cuadrícula Defina o seleccione los permisos que se usarán para la depuración,
elija el permiso Can_View_Products y active la casilla Concedido para depuración.
4. Elija la tecla F5 para ejecutar la aplicación.
En el menú de navegación, aparece el menú Productos en el grupo Información del

producto.
5. En la esquina superior derecha de la aplicación en ejecución, elija el botón Cerrar

para volver al modo de diseño.
6. Elija el permiso Can_View_Products y desactive la casilla Concedido para
depuración.
7. Elija la tecla F5 para ejecutar de nuevo la aplicación.
El menú Productos y el grupo Información del producto no aparecen porque está

ejecutando la aplicación sin el permiso Can_View_Products necesario.
En esta lección ha aprendido cómo establecer permisos de depuración y cómo probar la

aplicación. Los permisos de depuración le permiten ejecutar la aplicación y simular lo que
verá un usuario final, según los roles y permisos. Sin esta capacidad, se tendrían que crear
varias identidades de usuario, cerrar la aplicación y, a continuación, volver a iniciar sesión
con una identidad diferente.
En este ejemplo, se definió un solo permiso, aunque muchas aplicaciones requieren varios
permisos para fines diferentes. Puede identificar varios permisos de depuración para probar
diferentes combinaciones y asegurarse de que la aplicación funciona como realmente
pensaba.
Pasos siguientes
En el siguiente conjunto de lecciones aprenderá a implementar, a instalar y a administrar la

aplicación.
Próxima lección: Distribuir la aplicación
Vea también
Tareas
Otros recursos
Distribuir la aplicación
Visual Studio 2013
Otras versiones

El último paso para crear una aplicación LightSwitch consiste en hacer que esté disponible
para los usuarios.
En este conjunto de lecciones, obtendrá información acerca de cómo publicar e

implementar una aplicación.
Nota
la lección para definir roles y asignar permisos. Si el proyecto no está abierto aún, ábralo
desde el menú Archivo, Abrir proyecto.
Lecciones
Publicar una aplicación de LightSwitch Muestra cómo implementar la aplicación.
Ejecutar una aplicación de LightSwitch Muestra cómo instalar y probar la aplicación.
Cambiar una aplicación de LightSwitch Muestra cómo depurar un error de la aplicación y
y publicarla otra vez cómo volver a implementarla.
Actuar como administrador de una Muestra cómo agregar usuarios y permisos a la
aplicación de LightSwitch aplicación implementada.
Vea también
Tareas
Conceptos
Otros recursos
Implementación: Distribuir y mantener la aplicación
Publicar una aplicación de LightSwitch
Visual Studio 2013
Otras versiones
En esta lección, aprenderá a publicar una aplicación LightSwitch y a implementarla para los
usuarios finales.
Publicación
Después de crear una aplicación LightSwitch, el paso final consiste en publicarla mediante
el Asistente para publicación de aplicaciones de LightSwitch. Después de publicar la
aplicación, puede implementarla para los usuarios finales de varias formas.
Para publicar una aplicación
1. En el Explorador de soluciones, elija el nodo Mi primera aplicación.

2. En la barra de menús, elija Compilar, Administrador de configuración.
Se abre el cuadro de diálogo Administrador de configuración.
3. En la lista Configuración de soluciones activas, elija Liberar y, a continuación, elija

el botón Cerrar.
Este paso evita que las utilidades de depuración se distribuyan con la aplicación.
4. En la barra de menús, elija Compilar, Publicar Mi primera aplicación.
Aparecerá el Asistente para publicación de aplicaciones de LightSwitch.
5. En la página Este es el Asistente para publicación de LightSwitch, elija el botón de

opción Aplicación completa y, a continuación, elija el botón Siguiente.
6. En la página Servicios de aplicación, elija el botón de opción Escritorio local y, a
continuación, elija el botón Siguiente.
7. En la página Especificar preferencia de publicación, en el cuadro de texto ¿Dónde
desea colocar los archivos de la aplicación?, acepte la ubicación predeterminada (la
ruta de acceso a su proyecto más Publicar\).
Mediante esta configuración se publica la aplicación en el subdirectorio Publicar del
directorio de su proyecto.
8. En la lista ¿Cómo desea publicar la base de datos predeterminada?, elija el botón de

opción Publicar directamente en la base de datos ahora y elija el botón Siguiente.
9. En la página Configuración de seguridad, en la sección ¿Debe crear LightSwitch el
administrador de aplicaciones?, elija el botón de opción Sí, crear un administrador
de aplicaciones.
10. En el cuadro de texto Nombre de usuario, escriba su nombre de usuario de
Windows y elija el botón Siguiente.
11. En la página Conexiones de datos, en el cuadro de texto Especifique la conexión de
usuario, escriba Data Source=(LocalDB)\v11.0;Initial
Catalog=ApplicationData;Integrated Security=True.
12. En el cuadro de texto Publicar esquema de la base de datos, escriba Data
Source=(LocalDB)\v11.0;Initial Catalog=ApplicationData;Integrated Security=True
y elija el botón Siguiente.
13. En la página Requisitos previos de instalación, acepte la configuración
predeterminada y elija el botón Publicar.
La aplicación se publicará.
Sugerencia
Puede supervisar el progreso en la barra de estado situada en la parte inferior de

Visual Studio. Cuando el proceso finalice, aparece el mensaje Publicación correcta.
En esta lección, ha aprendido cómo publicar una aplicación. Los pasos para publicar una
aplicación son diferentes a los que se siguen en otros tipos de aplicaciones.
En la tercera página del asistente, especificó la ubicación en la que desea publicar la

aplicación (en este caso, el subdirectorio Publicar predeterminado). Puede escribir cualquier
ruta de acceso al archivo o a la red válida como ubicación de la publicación.
También puede elegir la opción Publicar directamente en la base de datos ahora, que instala
la base de datos de la aplicación en SQL Server durante la instalación. Utilice esta opción
cuando SQL Server ya esté instalado y configurado en los equipos en los que se instalará la
aplicación.
La casilla Crear un archivo de script para instalar y configurar la base de datos permite
crear un archivo de script que se ejecute durante la instalación, después de instalar y
configurar SQL Server. Utilice esta opción cuando desee instalar SQL Server como parte
de la instalación o cuando vaya a publicar una aplicación en una base de datos existente.
En la página Configuración de seguridad, ha decidido implementar la autenticación con la

aplicación y definir una cuenta de usuario de administrador y una contraseña
predeterminados. Esta cuenta de usuario proporciona automáticamente el permiso de
administración de seguridad, que permite que el administrador de aplicaciones agregue
usuarios y asigne roles.
Nota
Solo debe implementar la información de autenticación la primera vez que implemente la

aplicación. Se producirá un error en la operación de publicación si intenta implementar la
información de autenticación de nuevo.
En la página Conexiones de datos, escribió dos cadenas de conexión. En este caso, se

trataba de cadenas de conexión para la instancia local de SQL Server LocalDB, que se
instaló con LightSwitch. Si va a publicar en otro equipo, debe proporcionar la cadena de
conexión para la instancia de SQL Server de ese equipo. En ese caso, es conveniente
realizar la instalación con un archivo de script.
En la página Requisitos previos de instalación, decidió instalar únicamente los requisitos

previos predeterminados, es decir, los elementos que se muestran en negrita. Si tiene la
certeza de que los equipos en los que se instalará la aplicación tienen dependencias
adicionales, también puede instalarlas como requisitos previos. Los requisitos previos se
pueden descargar de Internet o de un recurso compartido de red que contenga los archivos
necesarios.
Pasos siguientes
En la lección siguiente, instalará y ejecutará la aplicación.
Próxima lección: Ejecutar una aplicación de LightSwitch
Vea también
Conceptos
Cómo: Implementar una aplicación de LightSwitch de dos niveles
Otros recursos
Ejecutar una aplicación de LightSwitch

Visual Studio 2013
Otras versiones
En la siguiente lección, instalará y ejecutará la aplicación LightSwitch.
Ejecutar la aplicación
En la lección anterior, aprendió a publicar la aplicación. A continuación, la instalará en su

equipo local y la probará para asegurarse de que se comporta de la forma prevista.
Para instalar y probar la aplicación
1. En el Explorador de archivos, busque la carpeta Publicar en su carpeta de proyecto.
Sugerencia
Para encontrar la carpeta de proyecto, elija el nodo MiPrimeraAplicación en el

Explorador de soluciones y, a continuación, en la ventana Propiedades, busque la
propiedad Carpeta de proyecto.
2. Abra el archivo Setup.exe.

3. En el cuadro de diálogo de instalación de la aplicación: advertencia de seguridad,
elija el botón Instalar para instalar la aplicación.
Después de que la instalación haya terminado, aparece la aplicación Northwind con

la pantalla de Pedidos por cliente abierta.
4. En el menú de navegación, elija Contactos.
Se abrirá la pantalla Contactos.
5. Escriba algunos datos y compruebe que la aplicación se comporta exactamente

como cuando la ejecutó desde Visual Studio.
6. Elija el botón Eliminar para eliminar los contactos de la pantalla Contactos, elija el
botón Guardar y, a continuación, el botón Buscar.
7. En el mensaje de error que aparece, elija el botón Aceptar y luego cierre la
aplicación.
En esta lección ha aprendido cómo instalar y ejecutar la aplicación. Ahora que se ha

instalado, puede ejecutar la aplicación de nuevo eligiendo la opción de la aplicación
Northwind en el menú Inicio.
Se recomienda probar la instalación y el comportamiento en tiempo de ejecución de una

aplicación antes de implementarla para los usuarios. Cuando pruebe la aplicación, hágalo
en un equipo que tenga una configuración similar a la que posiblemente tengan los
usuarios. De hecho, si copia los archivos de la aplicación Northwind y los instala en otro
equipo, probablemente no funcionará. Este es el comportamiento esperado porque las
cadenas de conexión que utilizó son específicas de su equipo local.
Es posible que haya observado que la pantalla Productos no está disponible. Dado que
inició sesión como administrador, el rol de administrador no tiene el permiso para ver
productos.
Probablemente también haya observado que, al elegir el botón Buscar, aparece un mensaje
de error. Este mensaje indica un error en la aplicación y debe volver atrás y corregirlo antes
de entregar la aplicación a los usuarios.
Pasos siguientes
En la siguiente lección, modificará la aplicación y publicará una versión modificada.
Próxima lección: Cambiar una aplicación de LightSwitch y publicarla otra vez
Vea también
Conceptos
Otros recursos
Cambiar una aplicación de LightSwitch y

publicarla otra vez
Visual Studio 2013
Otras versiones
En esta lección, aprenderá a solucionar un error en una aplicación LightSwitch y a

publicarla de nuevo posteriormente.
Depurar una aplicación
En la lección anterior, Ejecutar una aplicación de LightSwitch, se mostró cómo instalar y

probar la aplicación. En esa lección, también se identificó un error en el botón Buscar en la
pantalla ListaContactos. Si la entidad Contactos no contiene ningún registro, se produce un
error o una excepción cuando se elige el botón. En esta lección se muestra cómo depurar la
aplicación para encontrar el error y cómo corregirlo agregando código en el método
Button_Execute(). Este código permite detectar la excepción y mostrar un mensaje que
describa el problema.
Para solucionar el error

ListaContactos.lsml y, a continuación, elija Abrir.
2. En la barra de herramientas, abra la lista Escribir código y, a continuación, elija
Find_Execute.
Se abre el Editor de código y muestra el método Find_Execute().
3. Resalte la línea de código que contiene

Application.ShowSearchCustomer(Contacts.SelectedItem.ContactName).
4. En la barra de menús, elija Depurar, Alternar puntos de interrupción.
Se resalta la línea de código y aparece un glifo de punto de interrupción rojo en el

margen izquierdo.
5. Elija la tecla F5 para ejecutar la aplicación.

6. En el Menú de navegación, elija el elemento Contactos para abrir la pantalla
Contactos.
7. En la barra de herramientas, elija el botón Buscar.
Aparece el Editor de código y se resalta el punto de interrupción.
8. En la barra de menús, elija Depurar, Paso a paso por instrucciones.
Nota
Si aparece un cuadro de diálogo con un mensaje que indica que se pasó por alto
información de forma automática, elija el botón No para continuar.
9. Aparece el mensaje El código de usuario no controló NullReferenceException.

10. En la barra de menús, seleccione Depurar, Detener depuración.
11. En el método Find_Execute(), sustituya el código existente por el siguiente código.
C#
VB
Copiar
try
{
Application.ShowSearchCustomer(Contacts.SelectedItem.ContactName);
}
catch (Exception ex)
{
this.ShowMessageBox("No contacts exist to be found");
}
Este código muestra un mensaje si se produce una excepción.
12. Resalte la línea de código que contiene

Application.ShowSearchCustomer(Contacts.SelectedItem.ContactName.
13. En la barra de menús, elija Depurar, Alternar puntos de interrupción.
14. Elija la tecla F5 para ejecutar de nuevo la aplicación.
15. En el Menú de navegación, elija el elemento Contactos para abrir la pantalla
Contactos.
16. En la barra de herramientas, elija el botón Buscar.
Aparece el Editor de código y se resalta el punto de interrupción.
17. En la barra de menús, elija Depurar, Paso a paso por instrucciones.
Observe que no se muestra el mensaje de excepción, y que el resaltado pasa a la

siguiente línea de código.
18. En la barra de menús, elija de nuevo Depurar, Paso a paso por instrucciones.
Observe que el resaltado se mueve a la línea de código del bloque Catch.
19. En la barra de menús, elija Depurar, Paso a paso por instrucciones por tercera vez.
Aparece la ventana de la aplicación y se muestra un mensaje indicándole que

seleccione un contacto para buscar.
20. Elija el botón Aceptar para cerrar el cuadro de mensaje.
Se abre el Editor de código y se resalta el código End Try (llave de cierre en C#).
21. Elija la tecla F5 para reanudar la ejecución de la aplicación y luego elija el botón
Cerrar.
Para volver a publicar y probar la aplicación

2. En el Diseñador de aplicaciones, elija la pestaña Propiedades generales y, después,
elija el campo Versión de la aplicación.
3. En el segundo cuadro de texto, escriba 1001 y elija el botón Publicar.
4. En el Asistente para publicación de aplicaciones de LightSwitch, elija el botón
Publicar para volver a publicar la aplicación.
Espere hasta que se muestre el mensaje Publicación correcta en la barra de estado.
5. En el menú Inicio, elija la opción de aplicación Northwind para abrir la aplicación.
Aparece un mensaje y la aplicación se actualiza automáticamente a la nueva

versión. Después de completarse la instalación aparece la aplicación Northwind.
6. En el Menú de navegación, elija el menú Contactos para abrir la pantalla Contactos.

7. En la barra de herramientas, elija el botón Buscar y compruebe que se muestra el
mensaje para seleccionar un contacto para buscar que agregó anteriormente.
8. Elija el botón Cerrar para cerrar la aplicación.
En esta lección se explicó cómo depurar, actualizar y volver a publicar una aplicación. El
primer paso consiste en establecer un punto de interrupción en el método Find_Execute().
Cuando la aplicación se ejecuta, se detiene antes de la línea de código en el punto de
interrupción para que pueda recorrer el código paso a paso y ejecutar solo esa línea.
El código deja de ejecutarse en ese punto y muestra un mensaje de excepción Null

Reference Exception. Las excepciones Null Reference Exception se producen cuando el
código hace referencia a un objeto que no existe; en este caso, el objeto es el valor de
ContactName para SelectedItem.
Después, en esta lección se demostró cómo corregir el código agregando un bloque

Try…Catch. En un bloque Try…Catch, se ejecuta primero el código del bloque Try. Si se
produce una excepción, se ejecuta el código del bloque Catch. En este caso, muestra un
cuadro de mensaje al usuario.
Después de explicar cómo solucionar el error, se indicó cómo examinar de nuevo el código
para comprobar que se controla la excepción, que el código se ejecuta en el bloque Catch y
que se muestra el cuadro de mensaje. Es recomendable agregar un bloque Try…Catch en
cualquier parte del código donde se pueda producir una excepción.
Finalmente, en la lección se explicó cómo actualizar el número de Versión de la aplicación
y cómo volver a publicar la aplicación posteriormente. Observe que cuando instaló la
aplicación, no se le solicitó permiso para instalar. El permiso se concedió la primera vez
que instaló la aplicación y no se requiere para las actualizaciones.
Pasos siguientes
En la siguiente lección, verá cómo usar las características de administración en la

aplicación.
Próxima lección: Actuar como administrador de una aplicación de LightSwitch
Vea también
Conceptos
Otros recursos
Depurar: Buscar y corregir errores
Actuar como administrador de una

Visual Studio 2013
Otras versiones
En esta lección se muestra cómo realizar tareas administrativas, tales como agregar roles y
usuarios, en una aplicación LightSwitch.
Actuar como administrador
Para realizar tareas administrativas
1. En el menú Inicio, elija la opción de la aplicación Northwind.
Se abre la aplicación Northwind.
2. En el menú Navegación, expanda el nodo Administración.
Aparecen dos elementos de menú: Roles y Usuarios.
Para asignar un permiso a un rol existente
1. En Administración, elija el menú Roles para abrir la pantalla Roles.
En el panel Roles, aparece el rol Administrador. En el panel Permisos, aparece el

permiso Administración de seguridad. En el panel Usuarios y grupos de este rol,
aparece su nombre de usuario.
2. En el panel Permisos, elija el botón Agregar y luego, en la lista Permisos, elija Ver
productos.
3. En la barra de herramientas de aplicaciones, elija el botón Guardar.
4. Cierre la aplicación y ábrala de nuevo.
Compruebe que aparece la pantalla Productos.
Para agregar un nuevo rol
1. En Administración, elija el menú Roles.

2. En el panel Roles, elija el botón Agregar.
3. En el cuadro de diálogo Agregar nuevo rol, escriba Manager y elija el botón
Aceptar.
4. En el panel Permisos, elija el botón Agregar y luego, en la lista Permisos, elija Ver
productos.
Ahora se muestran dos roles, Administrador y Manager, en el panel Roles.
Para agregar a usuarios
1. En Administración, elija el menú Usuarios.

Aparece el perfil de usuario Administrador.
2. En el panel Usuarios y grupos, elija el botón Agregar.

3. En el panel derecho, en el cuadro de texto Nombre, escriba el nombre de un usuario
en su dominio.
Si el nombre de usuario es válido, el cuadro de texto Nombre completo incluirá el

nombre.
4. En el panel Roles, elija el botón Agregar y, en la lista Rol, elija Manager.

Ahora, se muestran dos usuarios en el panel Usuarios y grupos.
6. En el panel Usuarios y grupos, elija el botón Agregar.

7. En el panel derecho, en el cuadro de texto Nombre, escriba el nombre de otro
usuario en su dominio.
Este usuario no tiene asignado ningún rol y solo tendrá acceso a las pantallas de
administración de clientes.
En esta lección se ha explicado cómo iniciar sesión como administrador para agregar roles
y usuarios posteriormente. Una vez definido un rol, puede asignarlo a varios usuarios para
que todos tengan los mismos permisos. También puede asignar un rol a cualquier grupo de
seguridad válido de Active Directory.
Cuando agregó el tercer usuario, es posible que observara que no asignó ningún rol. Un
usuario o grupo al que no se le ha asignado ningún rol no tiene permisos, y solo puede ver
las pantallas para las que no se han asignado permisos.
En este ejemplo se utiliza la autenticación de Windows. Si utiliza la autenticación de

formularios, debe crear un Nombre de usuario, un Nombre completo y una Contraseña
únicos para el usuario. Cuando se utiliza la autenticación de Windows, no es necesario
especificar contraseñas.
Pasos siguientes
En la siguiente lección, aprenderá a utilizar las extensiones.
Próxima lección: Usar extensiones para mejorar LightSwitch
Vea también
Conceptos
Otros recursos
Usar extensiones para mejorar

LightSwitch
Visual Studio 2013
Otras versiones
Las extensiones permiten agregar funcionalidades a LightSwitch con tipos de empresa,

controles, temas y shells de aplicación personalizados.
En este conjunto de lecciones, aprenderá a adquirir, a administrar y a usar extensiones.
Nota
la lección sobre cómo ejercer de administrador de aplicaciones. Si el proyecto no está
abierto aún, ábralo desde el menú Archivo, Abrir proyecto.
Lecciones
Adquirir e instalar extensiones para
Muestra cómo adquirir y administrar extensiones.
LightSwitch
Aplicar extensiones de tema y shell Muestra cómo utilizar extensiones de shell y de
en LightSwitch temas en una aplicación.
Vea también
Conceptos
Otros recursos
Adquirir e instalar extensiones para

LightSwitch
Visual Studio 2013
Otras versiones
En esta lección, aprenderá a buscar y a instalar extensiones para LightSwitch.
Adquirir e instalar extensiones

Puede utilizar extensiones para agregar funcionalidades a LightSwitch. El Administrador de
extensiones le permite buscar y descargar extensiones directamente desde LightSwitch.
Una vez finalizada la descarga, las extensiones aparecen en la pestaña Extensiones del
Diseñador de aplicaciones. A continuación, podrá habilitarlas o deshabilitarlas según sea
necesario.
Para descargar una extensión
1. En la barra de menús, elija Herramientas, Extensiones y actualizaciones.
Se abre el cuadro de diálogo Extensiones y actualizaciones, en el que se muestran

las extensiones que se han instalado.
2. Elija el nodo Galería en línea.
Aparece una lista con las extensiones disponibles en el panel central.
3. Elija la extensión que desea descargar y luego elija el botón Descargar.

4. En el cuadro de diálogo Descargar e instalar, lea el contrato de licencia (si existe) y
luego elija el botón Instalar si está de acuerdo con los términos.
La extensión se instala y aparece en el nodo Instalado del cuadro de diálogo

Extensiones y actualizaciones.
5. Elija el botón Reiniciar ahora para reiniciar Visual Studio.
Visual Studio se cierra y se reinicia. La extensión está disponible, aunque aún no

está habilitada en el Diseñador de aplicaciones.
Para habilitar una extensión

2. En el Diseñador de aplicaciones, elija la pestaña Extensiones.
La extensión que acaba de instalar aparece en la lista Extensiones.
3. Active la casilla de la extensión para habilitarla y usarla en el proyecto actual.

4. (Opcional) Active la casilla Usar en proyectos nuevos para habilitar la extensión
para todos los proyectos futuros.
En esta lección, aprendió a descargar, a instalar y a habilitar extensiones. Se pueden
descargar extensiones de la Galería en línea o puede buscarlas en otros sitios web. También
se pueden instalar extensiones desde otros soportes, como un CD. Si adquiere extensiones
de otros orígenes, siga las instrucciones especiales para instalarlas.
Si deshabilita una extensión que se utiliza en el proyecto actual, los tipos de datos, los
controles, los temas o los shells personalizados se revierten a su configuración
predeterminada.
Cuando se desinstala una extensión mediante el Administrador de extensiones, la extensión

ya no aparece en la pestaña Extensiones del Diseñador de aplicaciones.
Pasos siguientes
En la lección siguiente, obtendrá información acerca de cómo cambiar el aspecto y el

comportamiento de la aplicación mediante extensiones de shell y de temas.
Próxima lección: Aplicar extensiones de tema y shell en LightSwitch
Vea también
Conceptos
Cómo: Agregar o quitar extensiones
Cómo: Usar extensiones en un proyecto de LightSwitch
Otros recursos
Usar extensiones para mejorar LightSwitch
Aplicar extensiones de tema y shell en

LightSwitch
Visual Studio 2013
Otras versiones
En esta lección se explica cómo utilizar extensiones de shell y de temas en LightSwitch.
Cambiar shells y temas
Mediante el uso de extensiones de shell y de temas, puede modificar la apariencia y el

comportamiento de la aplicación cambiando únicamente una opción. Una extensión de
temas cambia la apariencia visual de las pantallas y los controles de la aplicación, de
manera similar al cambio que experimenta el escritorio de Windows cuando un usuario
aplica un tema. Una extensión de shell cambia el diseño del shell de la aplicación, por
ejemplo, mostrando una barra de herramientas o una cinta de opciones en una ubicación
diferente.
Para aplicar una extensión de temas

2. En el Diseñador de aplicaciones, elija el vínculo Editar propiedades de
DesktopClient de Mi primera aplicación.
3. En la lista Tema, elija la extensión de tema que desea aplicar.
4. Elija la tecla F5 para ejecutar la aplicación y, a continuación, compruebe los
cambios.
Para aplicar una extensión de shell

En el Diseñador de aplicaciones, elija el vínculo Editar propiedades de

DesktopClient de Mi primera aplicación.
2. En la lista Shell, elija la extensión de shell que desea aplicar.

3. Elija la tecla F5 para ejecutar la aplicación y, a continuación, compruebe los
cambios.
Las extensiones de shell y de temas aparecen únicamente en el Diseñador de aplicaciones si

están habilitadas para el proyecto actual. Si ha descargado e instalado una extensión y no
aparece en la lista, abra la pestaña Extensiones del Diseñador de aplicaciones para
comprobar que la extensión está habilitada.
Pasos siguientes
En la última lección, aprenderá a tener acceso a los recursos adicionales para obtener más
información sobre LightSwitch.
Próxima lección: Recursos adicionales
Vea también
Conceptos
Cómo: Agregar o quitar extensiones
Cómo: Usar extensiones en un proyecto de LightSwitch
Otros recursos
Usar extensiones para mejorar LightSwitch
Recursos adicionales
Visual Studio 2013
Otras versiones
Enhorabuena si ha completado las lecciones del paseo guiado de LightSwitch. Las

lecciones mostraron cómo utilizar las capacidades básicas de LightSwitch para crear y
modificar una aplicación. No obstante, LightSwitch le permitirá implementar otras muchas
funcionalidades, y posiblemente ahora disponga ya de los conocimientos para crear su
propia aplicación. Este documento contiene los vínculos a algunos recursos de la
comunidad donde puede obtener información real y compartir ideas.
Recursos de la comunidad
Centro para desarrolladores
Contiene recursos con más información sobre LightSwitch.
de LightSwitch
Póngase en contacto con otros desarrolladores de
Foros de LightSwitch
LightSwitch y pregunte y responda a preguntas de desarrollo.
Blog del equipo de Obtenga las últimas noticias directamente de los miembros
LightSwitch del equipo de producto de LightSwitch.
Ejemplos de Visual Studio Encuentre los ejemplos de código que puede reutilizar en la
LightSwitch Galería de código de MSDN.
Vea también
Tareas
Tutorial: Crear la aplicación Vision Clinic en LightSwitch
Conceptos
Tutorial: Crear la aplicación Vision Clinic
en LightSwitch
Visual Studio 2013
Otras versiones
Personas que lo han encontrado útil: 1 de 1 -

Valorar este tema
En este tutorial se muestra el proceso de principio a fin para crear una aplicación en
LightSwitch. Usará muchas de las características de LightSwitch para crear una aplicación
para una aplicación de Vision Clinic ficticia. La aplicación incluye capacidades para
programar citas y la creación de facturas.
Requisitos previos
Descargue la base de datos PrescriptionContoso desde MSDN Code Gallery.
Pasos
 Crear un proyecto
Cree el proyecto de aplicación.
 Definir tablas
Agregue las entidades Paciente, Factura

y Detalles de factura.
 Crear una lista de opciones
Cree una lista de valores.
 Definir una relación

Vincule tablas relacionadas.
 Agregar otra entidad
Agregue la entidad Cita.
 Crear pantalla
Cree una pantalla para mostrar

información sobre cualquier paciente.
 Ejecutar la aplicación
Ejecute la aplicación y escriba datos.
 Conectar a una base de datos
Conecte a una base de datos externa.
 Realizar cambios en las entidades
Modifique las entidades Productos y

Descuento del producto.
 Crear una pantalla Lista y detalles
Cree una pantalla para mostrar los

productos.
 Cambiar el diseño de la pantalla
Modifique el diseño de la pantalla Lista

de productos.
 Realizar cambios en tiempo de

ejecución
Realice cambios en la aplicación en

ejecución.
 Crear una consulta
Cree una consulta parametrizada y

enlácela a una pantalla.
 Agregar un campo calculado

Cree un campo calculado y agréguelo a
una pantalla.
 Crear una relación entre bases de datos
Cree una relación virtual entre las

entidades en bases de datos diferentes.
 Crear la pantalla Facturas
Cree una pantalla para mostrar las

facturas.
 Modificar la pantalla Facturas
Cambie el diseño de la pantalla Facturas

de la aplicación en ejecución.
 Agregar lógica de pantalla
Escriba código para calcular fechas.
 Agregar más campos calculados
Cree más campos calculados y

agréguelos a la pantalla Facturas.
 Agregar un cliente móvil
Agregue pantallas para ver pacientes y

citas en un dispositivo móvil.
Crear un proyecto
Como primer paso para crear una aplicación de LightSwitch, creará un proyecto para esa
aplicación.
Para crear un proyecto
1. En la barra de menús, elija Archivo,

Nuevo proyecto.
Aparece el cuadro de diálogo Nuevo
proyecto.
2. En la lista Plantillas instaladas, expanda

el nodo Visual Basic o Visual C# y elija
el nodo LightSwitch.
3. En el panel central, elija la plantilla
Aplicación de escritorio de LightSwitch.
4. En el cuadro de texto Nombre, escriba
Vision Clinic y elija el botón Aceptar.
Se abre la ventana Diseñador de Vision

Clinic y se agregan a la ventana del
Explorador de soluciones las carpetas
necesarias para el proyecto.
Definir tablas
En LightSwitch, las tablas se conocen como entidades; modelan el objeto que los datos
representan (en este caso, una colección de pacientes). Las aplicaciones LightSwitch
utilizan un modelo de "formularios sobre datos", es decir, formularios o pantallas que
muestran los datos de una o más fuentes. LightSwitch incluye una base de datos intrínseca
donde se pueden almacenar los datos de la aplicación. En el paso siguiente, creará una tabla
de base de datos para almacenar información del paciente.
Para crear la entidad Paciente
1. En la ventana Diseñador de Vision

Clinic, elija el vínculo Crear nueva
tabla.
Se abre el Diseñador de datos. En

Solution Explorer, aparece un nodo
Table1Items bajo el nodo Data Sources
en el proyecto Vision Clinic.Server.
2. En la ventana Propiedades, llame a la

tabla Paciente y elija la tecla Entrar.
El nombre de la barra de título

Diseñador de datos cambia a "Paciente"
y el nombre del Explorador de
soluciones cambia a "Paciente.lsml".
3. En la columna Nombre del Diseñador

de datos, elija el vínculo <Agregar
propiedad>, escriba Nombre y elija la
tecla Entrar.
Observe que el tipo de datos adecuado,

String, aparece en la columna Tipo y
que la casilla Requerido está activada.
Los usuarios deben especificar un
nombre para cada paciente.
4. En la columna Nombre, elija el vínculo

<Agregar propiedad> y escriba Calle.
<Agregar propiedad> y escriba Calle2.
6. En la columna Requerido, desactive la
casilla.
La segunda línea de una dirección es

opcional.

<Agregar propiedad> y escriba Ciudad.
<Agregar propiedad> y escriba Estado o
provincia.
<Agregar propiedad> y escriba Código
postal.
<Agregar propiedad> y escriba
TeléfonoPrincipal.
11. En la columna Tipo, abra la lista y, a
continuación, elija PhoneNumber.
PhoneNumber es un tipo comercial

personalizado que representa un patrón
común para escribir y dar formato a
números de teléfono.

casilla.
TeléfonoSecundario.
continuación, elija PhoneNumber.
casilla.
<Agregar campo> y escriba Correo
electrónico.
continuación, elija EmailAddress.
EmailAddress es otro tipo comercial

personalizado que representa una
dirección de correo electrónico con
formato correcto.

casilla.
NúmeroPóliza.
20. En la ventana Propiedades, establezca el
valor de la propiedad Longitud máxima
en 12.
Este valor evitará que los usuarios

escriban un número de póliza con más
de 12 caracteres.
21. En la ventana Propiedades, desactive la
casilla Habilitar propiedades creadas o
modificadas.
Puede utilizar propiedades creadas y

modificadas para crear una traza de
auditoría para la tabla, que registre
quién creó un registro o lo editó más
recientemente. No obstante, no las
necesita para esta entidad.

Guardar todo para guardar su trabajo.
A continuación creará dos entidades más para representar una factura y partidas detalladas
de la factura.
Para crear las entidades Factura y DetallesFactura
1. En el Explorador de soluciones, elija el

nodo Data Sources y en la barra de
menús elija Proyecto, Agregar tabla.
Se abre una nueva instancia del

Diseñador de datos.
2. En la ventana Propiedades, establezca la
propiedad Nombre en Factura y, a
continuación, elija la tecla Entrar.
<Agregar propiedad> , escriba
FechaFactura y elija la tecla Tabulador.
continuación, elija DateTime.
<Agregar propiedad>, especifique
VecimientoFactura y elija la tecla Tab.
EstadoFactura y elija la tecla Tab.
continuación, elija Integer.
FechaEnvío y elija la tecla Tab.
propiedad Nombre en DetallesFactura y,
a continuación, elija la tecla Entrar.
Cantidad y elija la tecla Tab.
continuación, elija Integer.
PrecioUnitario.
continuación, elija Money.
Money es otro tipo comercial

personalizado que representa formatos
de divisa correctos.
17. En la ventana Propiedades, escriba $ en

el cuadro de texto Símbolo de divisa.
Crear una lista de opciones
En el paso siguiente, creará una lista de opciones para la entidad Invoice. Al crear una lista
de opciones, puede mostrar al usuario un conjunto fijo de valores entre los que elegir.
Para crear una lista de opciones
1. En el Explorador de soluciones, abra el

menú contextual para el nodo
Facturas.lsml y, a continuación, elija
Abrir.
2. En el Diseñador de datos, elija el campo
EstadoFactura.
3. En la ventana Propiedades, elija el
vínculo Lista de opciones.
4. En el cuadro de diálogo Lista de

opciones, escriba los valores siguientes
y, a continuación, elija el botón Aceptar.

0 Activo
1 Pagado
2 Vencido
5. Cuando este campo aparece en una
pantalla, el usuario puede abrir una lista
y elegir cualquiera de los tres valores de
Nombre para mostrar especificados.
Definir una relación
En el paso siguiente, definirá las relaciones entre las entidades Paciente, Factura y Detalles
de factura.
Para definir relaciones

Abrir.
2. En la barra de herramientas del
Diseñador de datos, elija el botón
Relación.
Aparecerá el cuadro de diálogo Agregar

nueva relación.
3. En la fila Nombre:, elija la columna

Para, abra la lista, elija Paciente y elija
el botón Aceptar.
Se crea una relación uno a varios entre

las entidades Patient e Invoice. Un
paciente puede tener varias facturas.

Relación.
Se abrirá el cuadro de diálogo Agregar

nueva relación.
5. En la fila Nombre:, elija la columna

Para, abra la lista y elija Detalles de
factura.
6. En la fila Multiplicidad:, elija la
columna De, abra la lista y elija Uno.
7. En la fila Multiplicidad:, elija la
columna Para, abra la lista, elija Muchos
y elija el botón Aceptar.

las entidades Invoice e InvoiceDetail.
Una factura puede tener varios detalles.

Crear la entidad Cita
En el paso siguiente, agregará una entidad más para representar una cita y, a continuación,
agregará una relación y una lista de opciones.
Para agregar la entidad Cita

cuadro de texto Nombre y escriba Cita.
3. En el Diseñador de datos, elija el texto
del marcador de posición <Agregar
propiedad> en la columna Nombre y
escriba HoraDeCita.
5. En el Diseñador de datos, elija el texto
del marcador de posición <Agregar
propiedad> en la columna Nombre y
escriba FechaDeCita.
continuación, elija Date.
7. En la columna Nombre, elija el
marcador de posición <Agregar
propiedad> y, a continuación, escriba
TipoDeCita.
continuación, elija Short Integer.
9. En la columna Nombre, elija el texto del
marcador de posición <Agregar
propiedad> y, a continuación, escriba
NotasDelDoctor.
10. Acepte el tipo predeterminado, String, y
desactive la casilla Obligatorio.
Relación.
12. En el cuadro de diálogo Agregar nueva
relación, elija la columna Para en la fila
Nombre:.
13. Abra la lista, elija Paciente y, a

las entidades Patient y Appointment.
Cada paciente puede tener varias citas.

AppointmentType.
vínculo Lista de opciones.
16. En el cuadro de diálogo Lista de
opciones, escriba los valores siguientes
y, a continuación, haga clic en el botón
Aceptar.

0 Anual
1 Seguimiento
2 Emergencia
17.
18. En la barra Perspectiva, elija la pestaña
DesktopClient.
19. En la ventana Propiedades , abra la lista
Propiedad de resumeny, a continuación,
elija HoraDeCita.
Esta propiedad define el campo que

aparecerá cuando se muestre una lista de
citas.

Crear pantalla
En el procedimiento siguiente, creará una pantalla para mostrar una lista de pacientes.

nodo Pantallas y, en la barra de menús,
elija Proyecto, Agregar pantalla.
Se abre el cuadro de diálogo Agregar

nueva pantalla.
2. En la lista Seleccione una plantilla de

pantalla, elija Pantalla de rejilla editable.
3. En el cuadro de texto Nombre de
pantalla, escriba ListaDePacientes.
4. En la lista Datos de pantalla, elija
Pacientes y, después, elija el botón
Aceptar.
El Diseñador de pantallas se abre y
muestra una representación jerárquica
del diseño de la pantalla.

Crear una pantalla de cita
En el procedimiento siguiente, creará una pantalla para programar citas.
Para crear la pantalla
1. En el Explorador de soluciones, en el
proyecto Vision Clinic.Server, abra el
menú contextual para el nodo Citas.lsml
DesktopClient y a continuación, en la
barra de herramientas, elija el botón
Pantalla.
pantalla, en la lista Seleccione una
plantilla de pantalla:, elija Pantalla de
nuevos datos.
4. En la lista Datos de pantalla, elija Cita y
elija el botón Aceptar.
5. En el Diseñador de pantallas, en el panel
central, elija el nodo HoraDeCita.
6. En la ventana Propiedades, desactive la
casilla Mostrar fecha.
Este cambio mostrará únicamente la

sección de fecha y hora del control
Selector de fecha y hora.
Ejecutar la aplicación y escribir datos
Ahora tiene una aplicación operativa. En el paso siguiente, la ejecutará e incorporará

algunos datos.
Para ejecutar la aplicación
1. Elija la tecla F5 para iniciar la

aplicación.
2. En la aplicación en ejecución, elija la
pantalla ListaDePacientes y, a
continuación, elija el botón de agregar
(+).
Aparecerá el cuadro de diálogo Agregar

nuevo paciente.
3. Escriba los datos de un nuevo paciente y

especifique un valor no válido en el
campo Correo electrónico (por ejemplo,
juan#ejemplo.com).
Cuando se mueva fuera del campo

aparece un borde rojo. El tipo comercial
EmailAddress tiene reglas de validación
integradas que pueden detectar una
dirección de correo electrónico con
formato incorrecto.
4. Corrija el error, finalice la entrada de

datos y, a continuación, elija el botón
Aceptar.
En la barra de herramientas de la
aplicación, el botón Guardar está ahora
habilitado.
5. Agregue varios pacientes más.

6. Elija el botón Guardar para guardar los
datos.
Ahora, puede reorganizar las columnas

en la cuadrícula ListaDePacientes y
puede ordenar en cualquier columna.
7. En la barra de menús, elija Tareas, Crear

nueva cita.
Se abre la pantalla Crear nueva cita.
8. Escriba los datos para una cita eligiendo

un paciente de la lista Paciente y una
fecha y hora posterior a la actual.
9. Agregue varias citas más para hoy más
tarde y, a continuación, elija el botón
Guardar para guardar los datos.
10. En la esquina superior derecha de la
aplicación en ejecución, elija el botón
Cerrar para volver al modo de diseño.
Conectar a una base de datos
En el paso siguiente, se conectará a una base de datos externa que contiene información del
producto.
Nota
Antes de realizar este paso, debe descargar la base de datos PrescriptionContoso de
Tutorial y ejemplo de LightSwitch en Visual Studio 2012 Vision Clinic y, a continuación,
instalar la base de datos siguiendo las instrucciones del archivo Install.htm.
Para adjuntar a un origen de datos

nodo Orígenes de datos.
2. En la barra de menús, elija Proyecto,
Agregar origen de datos.
3. En el Asistente para adjuntar origen de
datos, elija el icono Base de datos y, a
continuación, elija el botón Siguiente.
Se abrirá el cuadro de diálogo Elegir

origen de datos.
Nota
Si previamente se ha conectado a una base de datos de Visual Studio, este cuadro
de diálogo no aparece y puede omitir el paso siguiente.
4. En la lista, elija Microsoft SQL Server y

elija el botón Continuar.
5. En el cuadro de diálogo Propiedades de
conexión, escriba los valores en la tabla
siguiente y, a continuación, haga clic en
el botón Aceptar.
Campo Valor
Nombre del servidor (localdb)\v11.0
Conexión con el servidor Uso de autenticación de Windows
Seleccione o escriba el nombre de la base de
C:\Temp\PrescriptionContoso.mdf
datos:
6.
7. Aparece la página del asistente Elija los
objetos de base de datos.
8. Expanda el nodo Tablas, elija las tablas
Producto y DescuentoDeProducto y, a
continuación, elija el botón Finalizar.
El origen de datos
C_TEMP_PRESCRIPTIONCONTOSO
_MDFData se agrega al proyecto y se
crean entidades para Productos y
DescuentosDeProducto.

C_TEMP_PRESCRIPTIONCONTOSO
_MDFData, elija Cambiar nombre y, a
continuación, escriba
PrescriptionContoso.
Modificar las entidades Productos y
DescuentoDeProducto
En el paso siguiente, cambiará las entidades DescuentoDeProducto y Productos.
Para modificar las entidades DescuentoDeProducto y Producto

DescuentosDeProducto.lsml y, a
2. Elija el campo Descuento y cambie el
Tipo a Money.
Productos.lsml y, a continuación, elija
Abrir.
5. En el Diseñador de Datos, elija el
campo PVR y cambie Tipo a Money.
7. Elija el campo ImagenDelProducto y
cambie el Tipo a Image.
Crear una pantalla Lista y detalles
En el paso siguiente, creará una pantalla para mostrar la información de productos.
Para crear una pantalla de lista y detalles
1. En el Diseñador de datos, en la barra

Perspectiva, elija la pestaña
DesktopClient y, a continuación, en la
Pantalla.
nueva pantalla.

pantalla:, elija Pantalla de lista y
detalles.
pantalla, escriba ListaDeProductos.
PrescriptionContoso.Productos.
5. En la lista Datos adicionales que
incluir:, active las casillas Detalles del
producto y DescuentosDeProducto de
producto y, a continuación, elija el
botón Aceptar.
Cambiar el diseño de la pantalla
En el paso siguiente, cambiará el formato de la pantalla ListaDeProductos.
Para personalizar el diseño
1. En el Diseñador de pantallas, en el
Árbol de contenido de pantalla, elija el
nodo Diseño de filas | Detalles del
producto.
2. En la lista Diseño de filas, elija Imagen
y texto.
3. En la lista para cada campo situada
debajo del nodo Imagen y texto, elija los
siguientes valores:
Campo Valor
(IMAGEN) Imagen del producto
(TÍTULO) Nombre de producto
(SUBTÍTULO) PVR
(DESCRIPCIÓN) Descripción
4.
5. Elija la tecla F5 para ejecutar la
aplicación y ver los resultados.
6. En la aplicación en ejecución, en la
barra de menús, elija Tareas, Lista de
productos para mostrar la pantalla
ListaDeProductos.
Mantenga la aplicación abierta. En el

paso siguiente, realizará modificaciones
en la aplicación en ejecución.
Realizar cambios en la aplicación en ejecución
En el paso siguiente, modificará la pantalla Lista de productos mientras se ejecuta la

aplicación.
Para personalizar una pantalla en tiempo de ejecución
1. En la esquina inferior derecha de la

pantalla Lista de productos, elija el
vínculo de Pantalla de diseño.
2. En el panel izquierdo, elija el nodo
Cuadrícula de datos | Descuentos de
productos.
3. En la ventana Propiedades, establezca el
valor de la propiedad Nombre para
mostrar en Descuentos Contoso.
El nombre también cambia en la

ventana de la aplicación.
4. Elija el campo PVR y establezca la

propiedad Descripción en Precio
sugerido antes de cualquier descuento.
5. Elija el botón Guardar para volver a la

aplicación en ejecución y ver los
cambios.
Por ejemplo, puede señalar el campo

PVR para mostrar la descripción.

Crear una consulta
En el paso siguiente, creará una consulta parametrizada y la enlazará a una pantalla.
Para crear una consulta parametrizada

Agregar consulta.
Se abre el Diseñador de consultas.

cuadro de texto Nombre y escriba
ProductosRelacionados.
3. En el Diseñador de consultas, elija el
vínculo Agregar filtro.
Se agrega una condición de filtro a la

sección Filtro.
4. En la segunda lista, elija Categoría.

6. En la quinta lista, elija Agregar nuevo.
Se agrega un nuevo Parameter con el

nombre Category y el tipo String a la
sección Parámetros.
ListaDeProductos.lsml y, a
Diseñador de pantallas, elija el botón
Agregar elemento de datos.
9. En el cuadro de diálogo Agregar
elemento de datos, elija el botón de
opción Consulta.
10. En la columna Nombre, elija
PrescriptionContoso.ProductosRelacion
ados y elija el botón Aceptar.
Aparece un nodo
ProductosRelacionados en el panel
izquierdo.
11. En Parámetros de la consulta, elija el

nodo Categoría.
propiedad Enlace de parámetros en
Productos.SelectedItem.Categoría.
13. En el panel central, expanda el nodo
Agregar bajo el nodo Cuadrícula de
datos | Descuentos Contoso y, a
continuación, elija Productos
relacionados.

Si se abre la pantalla Lista de productos,

aparece una lista de productos
relacionados para cada producto
seleccionado.

Agregar un campo calculado
En el paso siguiente, agregará un campo que utiliza un valor calculado. El valor calculado
será el precio de un producto una vez aplicado un descuento.
Para agregar un campo calculado

menú contextual para el nodo de entidad
Abrir.
Perspectiva, elija la pestaña Servidor.
3. Elija el vínculo <Agregar propiedad>,
escriba PrecioActual y, a continuación,
elija la tecla Tab.
En la ventana Propiedades, en la sección

General, la casilla Es calculado está
activada de forma predeterminada.

vínculo Editar método.
El Editor de código se abre y aparece el

método CurrentPrice_Compute.
7. Agregue el código siguiente al

controlador de eventos:
C#
VB
Copiar
decimal rebates =
default(decimal);
foreach (var item in

ProductRebates)
{
if
(item.RebateStart <=
System.DateTime.Today &&
item.RebateEnd >=
System.DateTime.Today)
{
rebates +=
item.Rebate.Value;
}
}
result = this.MSRP -
rebates;

En el procedimiento siguiente, agregará el campo calculado a la pantalla ListaDeProductos.
Para agregar un campo calculado a una pantalla

menú contextual para el nodo de
pantalla ListaDeProductos.lsml y, a
2. En el panel izquierdo del Diseñador de
pantallas, mueva el nodo PrecioActual
bajo el nodo (Descripción) | Descripción
en el panel central.
4. En la pantalla ListaDeProductos,
modifique el campo Descuento o el
campo PVR.
El PrecioActual se vuelve a calcular.

Crear una relación entre bases de datos
En el paso siguiente, creará una relación virtual entre las entidades de dos bases de datos y
mostrará datos a partir de dos orígenes en una pantalla única de lista y detalles.
Para crear una relación entre bases de datos

DetallesDeFactura.lsml y elija Abrir.
2. En el Diseñador de datos, en la barra de
herramientas, elija el botón Relación.
Se abrirá el cuadro de diálogo Agregar

nueva relación.
3. En la columna Para, elija el campo

Nombre, abra la lista y, a continuación,
elija Producto.
Una nueva sección aparece en la parte

inferior del cuadro de diálogo. La
sección muestra los campos
relacionados en las dos entidades. Si es
necesario, puede cambiar los campos
relacionados a otro campo del mismo
tipo de datos o definir varios campos
relacionados como claves.
4. Elija el botón Aceptar para guardar la
relación.
El diseñador muestra la nueva relación

como una línea de puntos. Esta línea
indica que las entidades se encuentran
en orígenes de datos diferentes, en este
caso InvoiceDetails es de la base de
datos intrínseca y Products es de la base
de datos PrescriptionContoso.

Crear una pantalla para mostrar facturas

En el paso siguiente, creará una nueva pantalla para mostrar facturas.

nodo Pantallas y, en la barra de menús,
elija Proyecto, Agregar pantalla.

nueva pantalla.

pantalla:, elija Pantalla de lista y
detalles.
pantalla, escriba PantallaDeFactura.
Facturas.
5. En la lista Datos adicionales que
incluir:, elija Detalles de la factura y
DetallesFactura de factura y, a
6. Expanda el nodo Fila de cuadrícula de

datos | Detalles de factura y, a
continuación, elimine el nodo Id. de
producto del producto.
7. Para reordenar los campos, mueva los
nodos Cantidad y PrecioUnitario bajo el
nodo Producto.
aplicación.
9. En la barra de menús, elija Tareas,
Pantalla de la factura para mostrar la
pantalla.
10. En el panel Facturas, elija el botón
agregar (+) y escriba algunos datos de la
factura.
El campo EstadoFactura proporciona

una lista desplegable de valores y el
campo Paciente contiene un botón que
abre un cuadro de diálogo que muestra
los pacientes.
11. En el panel Detalles de factura, elija el

botón de agregar +… y escriba algunos
datos de detalle de factura.
El campo Producto proporciona una

lista de productos de la base de datos
PrescriptionContoso.

datos de la factura y mantenga la
aplicación abierta.
En el procedimiento siguiente, realizará

modificaciones en la aplicación en
ejecución.
Modificar la pantalla Facturas
En el siguiente paso, modificará la pantalla Facturas de la aplicación en ejecución.
Para modificar una pantalla en la aplicación en ejecución

1. En la esquina inferior derecha de la
Pantalla de la factura, elija el vínculo
2. En el panel izquierdo, elija el nodo Lista
| Facturas, abra la lista Lista y, a
continuación, elija DataGrid.
3. Elija el nodo Paciente y, a continuación,
elija la flecha hacia arriba en el margen
izquierdo para mover el nodo sobre el
nodo Fecha de factura.
4. Elija el botón Guardar para volver a la

aplicación en ejecución y ver los
cambios.
Definir la lógica de pantalla

En el paso siguiente, agregará código para definir la lógica predeterminada para las fechas
de factura.
Para definir la lógica de pantalla

Abrir.
herramientas, abra la lista Escribir
código y, a continuación, elija
Invoice_Created.
El Editor de código se abre y muestra el

método Invoice_Created.
3. En el método Invoice_Created, agregue

el código siguiente para establecer el
comportamiento predeterminado para
las fechas:
C#
VB
Copiar
InvoiceDate =
System.DateTime.Today;
InvoiceDue =
System.DateTime.Today.AddDays(30
);
ShipDate =
System.DateTime.Today.AddDays(3)
;

Abrir.
InvoiceDate.
6. En la barra de herramientas, abra la lista
Escribir código y, a continuación, elija
InvoiceDate_Changed.
7. En el método InvoiceDate_Changed,
agregue el siguiente código para
actualizar las fechas cuando se cambie
FechaFactura:
C#
VB
Copiar
InvoiceDue =
InvoiceDate.AddDays(30);
// If the ShipDate is
earlier than the new
InvoiceDate, update it
if (ShipDate < InvoiceDate)
{
ShipDate =
InvoiceDate.AddDays(2);
}

Producto.
10. En la barra de herramientas, abra la lista
Escribir código y, a continuación, elija
Product_Changed.
11. En el Editor de código, agregue el
siguiente código para establecer el
precio por unidad y cantidad
predeterminada:
C#
VB
Copiar
UnitPrice =
Product.CurrentPrice;
Quantity = 1;

aplicación, abrir la pantalla Factura y
agregar una factura.
Ahora, los campos de fecha, precio y
cantidad se actualizan automáticamente.

cambios.
Agregar más campos calculados
En el paso siguiente, agregará los campos calculados para los subtotales, totales e
impuestos a las entidades DetallesDefactura y Facturas.
Para agregar campos calculados

2. En el Diseñador de datos, elija el
vínculo <Agregar propiedad>,
especifique SubTotal y, a continuación,
elija la tecla Tab.
5. En la ventana Propiedades, en la sección
Propiedades generales, active la casilla
Es calculado y después elija el vínculo
Editar método.

método SubTotal_Compute.
6. Agregue el código siguiente para

calcular el SubTotal:
C#
VB
Copiar
result = Quantity * UnitPrice;

Abrir.
especifique Impuesto y, a continuación,
elija la tecla Tab.
11. En la ventana Propiedades, active la
casilla Es calculado y después elija el

método Tax_Compute.
12. Reemplace el método Tax_Compute por

el código siguiente para calcular el valor
de Tax:
C#
VB
Copiar
partial void Tax_Compute(ref

decimal result)
{
result = GetSubTotal() *
(decimal)0.095;
}
protected decimal GetSubTotal()
{
return
this.InvoiceDetails.Sum(i =>
i.SubTotal);
}

Abrir.
especifique Total y, a continuación, elija
la tecla Tab.
17. En la ventana Propiedades, active la
casilla Es calculado y después elija el

método Total_Compute.
18. Agregue el código siguiente para

calcular el valor de Total:
C#
VB
Copiar
result = GetSubTotal() + Tax;

En el paso siguiente, agregará los nuevos campos a la pantalla Facturas.
Para agregar campos a una pantalla

PantallaDeFactura.lsml y, a
2. En el panel central, expanda el nodo
Diseño de filas | Detalles de factura,
expanda la lista Agregar y, a
continuación, elija Impuesto.
El campo Impuesto aparece en la

sección Pila Vertical |
DetallesDeFactura.
3. Abra la lista Agregar de nuevo y, a
continuación, elija el campo Total.
aplicación y, a continuación, abra la
pantalla Pantalla de la factura.
Los campos Impuesto y Total aparecen

ahora en cada fila de la factura.
5. Elija el vínculo Pantalla de diseño para

cambiar al modo de personalización.
6. En el panel izquierdo, expanda el nodo
Fila de cuadrícula de datos | Detalle de
factura, expanda la lista Agregar y, a
continuación, elija Subtotal.
7. Elija el botón Guardar para guardar el
cambio.
Ahora aparece un campo Subtotal en la

cuadrícula Detalles de factura.
Agregar un cliente móvil
Hasta ahora, las pantallas creadas están optimizadas para la entrada de datos en un equipo
de escritorio. Algunas tareas de la clínica, tales como ver la información de los pacientes o
las citas próximas, son más adecuadas para dispositivos móviles. Puede utilizar
LightSwitch para crear pantallas que los usuarios puedan ver en un explorador en la
mayoría de las tabletas y los teléfonos. En el paso siguiente, creará pantallas de cliente
HTML para examinar pacientes y citas.
Para agregar un proyecto de cliente HTML

menú contextual para el nodo Vision
Clinic y, a continuación, elija Agregar
cliente.
2. En el cuadro de diálogo Agregar cliente,
elija el elemento Cliente HTML y, a
Se agrega un proyecto
VisionClinic.HTMLClient a la solución.
Para agregar una pantalla para examinar pacientes
proyecto Vision Clinic.Server, abra el
Pacientes.lsml y, a continuación, elija
Abrir.
HTMLClient y a continuación, en la
Pantalla.

nueva pantalla.
pantalla, elija Pantalla Examinar datos.
Pacientes y, después, elija el botón
Aceptar.
Para personalizar la pantalla de examinar
nodo Lista |Pacientes.
2. En la lista Lista, elija Lista de mosaicos.
Esta opción mostrará un icono para cada

paciente. De forma predeterminada, el
icono muestra todos los campos para el
paciente.
3. Bajo el nodo Diseño de filas | Paciente,

elimine todos los campos excepto
Nombre, Apellidos y Número de póliza.
proyecto Vision Clinic.HTMLClient,
abra el menú contextual para el nodo
ExaminarPacientes.lsml y, a
continuación, elija Establecer como
pantalla principal.
aplicación.
Si se cambia el tamaño de la ventana del

explorador, la organización de iconos
cambia cuando la ventana se estrecha,
optimizando la vista para pantallas de
dispositivos más pequeños, como los
teléfonos.

A continuación, agregará una pantalla

para ver los detalles del paciente.
Para agregar una pantalla de detalles
nodo Lista de mosaicos |Pacientes.
Acciones , elija el vínculo Puntear
elemento: Ninguno.
3. En el cuadro de diálogo Editar acción
ItemTap, expanda la lista ShowTab,
elija viewSelected y, a continuación,
pantalla, acepte los valores
predeterminados y elija el botón
Aceptar.
aplicación.
6. En la pantalla Examinar pacientes, elija
un paciente para abrir la pantalla Ver
paciente.
Observe que los campos Teléfono

principal, Teléfono secundario y Correo
electrónico son hipervínculos. Estos
campos se basan en tipos comerciales
personalizados y la capacidad de iniciar
una llamada telefónica o de enviar un
correo electrónico está integrada en los
controles personalizados para estos
tipos.

A continuación, agregará una pantalla

basada en consulta para ver las citas
siguientes.
Para crear una consulta

y, a continuación, elija Agregar
consulta.
2. En la ventana Propiedades, escriba
PróximasCitas en el cuadro de texto
Nombre.
3. En el Diseñador de consultas, elija el
vínculo Agregar filtro.
4. En la tercera lista, elija >= (mayor o
igual que).
5. En la cuarta lista, elija Global.
6. En la quinta lista, elija Hoy.
7. Elija el vínculo Agregar filtro de nuevo.
8. En la segunda lista, elija HoraDeCita.
9. En la tercera lista, elija >= (mayor o
igual que).
10. En la cuarta lista, elija Global.
11. En la quinta lista, elija Ahora.
12. Elija el vínculo Agregar ordenación y, a
continuación, acepte los valores
predeterminados de FechaDeCita y
Ascendente.
13. Elija de nuevo el vínculo Agregar
ordenación y, a continuación, acepte los
valores predeterminados de HoraDeCita
y Ascendente.
Para crear una pantalla de cita

Perspectiva, elija la pestaña
HTMLClient.
3. En la ventana Propiedades, abra la lista
para Propiedad de resumen y, a
continuación, elija HoraDeCita.
herramientas, elija el botón Pantalla.
pantalla, en la lista Seleccione una
plantilla de pantalla:, elija Pantalla
Examinar datos.
PróximasCitas y elija el botón Aceptar.
Para crear una pantalla de detalle de cita
nodo Listas | Próximas citas.
Acciones , elija el vínculo Puntear
elemento: Ninguno.
3. En el cuadro de diálogo Editar acción
ItemTap, expanda la lista ShowTab,
elija viewSelected y, a continuación,
pantalla, acepte los valores
predeterminados y elija el botón
Aceptar.
Para agregar navegación de pantalla

menú contextual para el nodo Vision
Clinic.HTMLClient y, a continuación,
elija Editar navegación de pantalla.
2. En el Diseñador de aplicaciones, elija el
vínculo Incluir pantalla y, a
continuación, elija Examinar pacientes.
3. Elija el vínculo Incluir pantalla de
nuevo y, a continuación, elija Examinar
próximas citas.
aplicación.
la flecha abajo junto a la barra de título
y, a continuación, elija Examinar
próximas citas para abrir la pantalla
Citas.
Observe que la pantalla Citas tiene

ahora un botón atrás, que puede elegir
para volver a la pantalla Pacientes.
Observe también que, cuando se cambia
el tamaño de la ventana del explorador,
el menú de navegación sigue estando
disponible, pero se trunca el título.
Corregirá ese problema agregando
código JavaScript en el procedimiento
final.

Para modificar el título de la pantalla

ExaminarPróximasCitas.lsml y, a
2. En el Diseñador de pantallas, en la barra
de herramientas, abra la lista Escribir
código y, a continuación, elija created.
3. En el Editor de código, agregue el
siguiente código al método created:
JavaScript
Copiar
screen.details.displayName =
"Appointments";

aplicación.
la flecha abajo junto a la barra de título
y, a continuación, elija Examinar
próximas citas para abrir la pantalla
Citas.
Observe que el título es ahora Citas.

Este procedimiento completa el tutorial de la aplicación Vision Clinic. Ahora debe tener los
conocimientos básicos del proceso de principio a fin para crear una aplicación de
LightSwitch.
En este punto podría publicar la aplicación en IIS (Internet Information Services) o en

Microsoft Azure, para poner la aplicación a disposición de otros usuarios.
En este tutorial se han mostrado las capacidades básicas de LightSwitch, pero puede utilizar
esta aplicación para hacer mucho más. Cuando empiece a crear sus propias aplicaciones,
puede obtener información sobre más funciones en la documentación del producto.
Vea también
Conceptos
Otros recursos

Introduccion A LightSwitch

Cargado por

Copyright:

Formatos disponibles

Introduccion A LightSwitch

Cargado por

Información del documento

Descripción original:

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Introduccion A LightSwitch

Cargado por

Copyright:

Formatos disponibles

Introducción a LightSwitch

Visual Studio 2013

Este tema aún no ha recibido ninguna valoración - Valorar este tema

Puede compilar aplicaciones empresariales rápidamente centrándose en la lógica de

Para obtener una introducción rápida al entorno de desarrollo de LightSwitch y sus

Entorno de desarrollo de LightSwitch

Este tema aún no ha recibido ninguna valoración - Valorar este tema

Puede crear una aplicación de LightSwitch mediante el entorno de desarrollo integrado

Familiarizarse con el entorno de desarrollo

La parte principal del IDE está compuesta de diseñadores o ventanas correspondientes a

El diseñador de LightSwitch aparece al crear un proyecto. Contiene vínculos que se

El Diseñador de pantallas es donde crea la interfaz de usuario para su aplicación. El

La ventana Propiedades es donde se establecen las propiedades para los elementos

El Editor de código es donde se escribe el código de la aplicación. Se abre una

Este tema aún no ha recibido ninguna valoración - Valorar este tema

El paseo guiado de LightSwitch consta de un conjunto de lecciones diseñado para presentar

En el primer conjunto de lecciones, aprenderá a compilar una aplicación sencilla en cuatro

Primera lección: Crear la primera aplicación de LightSwitch.

Entorno de desarrollo de LightSwitch

Crear la primera aplicación de

Cuatro sencillos pasos

El proceso se describe en los cuatro pasos siguientes.

Definir los datos

Paso 1: Crear un proyecto de LightSwitch

Este tema aún no ha recibido ninguna valoración - Valorar este tema

En el primer proyecto, crearemos una aplicación para administrar la información de

Para crear un proyecto en una aplicación

1. En el menú Inicio, elija Visual Studio 2013.

Aparece el cuadro de diálogo Nuevo proyecto.

3. En la lista de plantillas, expanda el nodo de Visual Basic o de Visual C# y, a

Aparece la ventana Diseñador de Mi primera aplicación, y se agregan las carpetas

Acaba de crear un proyecto para una aplicación de administración de contactos con la

Próxima lección: Paso 2: Definir los datos en LightSwitch

Proyectos: El contenedor para la aplicación de LightSwitch

Paso 2: Definir los datos en LightSwitch

Este tema aún no ha recibido ninguna valoración - Valorar este tema

En esta lección, se definirán los datos para la aplicación de administración de contactos

Definir los datos

Para crear una entidad en la aplicación

Se abre la ventana Diseñador de datos.

2. En la ventana Propiedades, en el cuadro de texto de la propiedad Nombre, escriba

El nombre en la barra de título cambia a "Contacto" y en el Explorador de

3. En la columna Nombre, elija el vínculo <Agregar propiedad>, escriba

El tipo de datos adecuado, String, aparece en la columna Tipo y la casilla

4. En la columna Nombre, elija el vínculo <Agregar propiedad> y escriba

PhoneNumber es un tipo comercial personalizado que representa un patrón común

7. En la columna Nombre, elija el vínculo <Agregar propiedad> y escriba

EmailAddress es otro tipo comercial personalizado que representa una dirección de

9. Desactive la casilla de la columna Obligatorio del campo

En este punto, su entidad debería tener un aspecto similar al de la siguiente

Además de los tipos comerciales personalizados que se compilan en LightSwitch, puede

Datos: La información que hay detrás de la aplicación

Extensiones: Agregar nuevas capacidades a LightSwitch

Paso 3: Crear una pantalla en LightSwitch

Este tema aún no ha recibido ninguna valoración - Valorar este tema

Para crear una pantalla en la aplicación

Aparecerá el cuadro de diálogo Agregar nueva pantalla.

3. En la lista Seleccione una plantilla de pantalla, elija Pantalla de rejilla editable.