Configurar el Asistente del origen de datos (control EntityDataSource)

Artículo
10/22/2014

Actualización: noviembre 2007

El Asistente para la configuración de orígenes de datos del control EntityDataSource en el marco de ASP.NET es un asistente de dos páginas que se utiliza para inicializar el origen de datos. En la primera página del asistente, puede seleccionar una conexión con nombre del archivo WebConfig o agregar una cadena de conexión que identifique la base de datos. El contenido de la segunda página del asistente depende de si utiliza una instrucción Select configurada mediante las opciones del asistente u otro texto de comando de su propio diseño.

Página uno del asistente

La siguiente ilustración muestra la primera página del asistente. La Conexión con nombreAdvWksSalesEntities del archivo Web.config del proyecto está seleccionada en la lista desplegable. La selección en lista desplegable DefaultContainerName también es AdvWksSalesEntities. La cadena de conexión de una implementación de Entity Data Model (EDM), de forma predeterminada, la identifica EntityContainer en el esquema del diseño. Para obtener más información sobre el tipo EntityContainer, vea ADO.NET Entity Framework. La primera página del asistente tiene un aspecto similar al siguiente:

Para obtener más información sobre las propiedades de EntityDataSource que inicializa la primera página del asistente, vea Configurar el control EntityDataSource.

Página dos del asistente

La segunda página del asistente tiene dos posibles vistas; se muestra una u otra dependiendo de si la propiedad Select tiene asignado o no un valor.

Vista simple del asistente de selección

La vista simple del asistente Select se muestra cuando la propiedad Select del control EntityDataSource está sin asignar o cuando la propiedad Select tiene asignada una lista separada por comas de propiedades de entidad reconocidas del formulario: item.[Property1], item.[Property2], con o sin corchetes de escape. El posible conjunto de propiedades para los valores DefaultContainerName, EntitySetName y EntityTypeFilter deben estar todos reconocidos como valores válidos en el modelo de datos utilizado por la aplicación.

En la vista simple del asistente de selección, el usuario selecciona EntitySetName, opcionalmente escribe EntityTypeFilter y selecciona las propiedades que desea mostrar en el control de datos. EntityTypeFilter solo se necesita si se utilizan tipos derivados en una jerarquía de herencia.

Cuando el usuario activa Seleccionar todo (valor de entidad) se devuelven entidades completas en lugar de resultados que contienen propiedades individuales. Los valores de entidad son actualizables y también permiten a los controles enlazados a datos mostrar y modificar las propiedades clave de entidades relacionadas y miembros de tipo complejo.

La ilustración siguiente muestra la vista Select simple de la página dos del asistente.

Vista avanzada del asistente de selección

La vista avanzada del asistente Select, como aparece a continuación, se muestra cuando la propiedad Select está establecida en cualquier valor distinto de las opciones mostradas por la vista simple.

Las casillas Habilitar inserción automática, Habilitar actualización automática y Habilitar eliminación automática tienen cada una dos posibles valores. Para la página simple del asistente Select, si está seleccionada una opción diferente a Seleccionar todo en la lista de propiedades, estas casillas estarán desactivadas y deshabilitadas en la página avanzada del asistente Select. Para la vista avanzada del asistente Select, estas casillas estarán desactivadas y deshabilitadas en cuanto se especifique algo en el cuadro de texto Select, como muestra la instrucción Select personalizada en la ilustración.

Nota:
Como en Entity Framework, al utilizar Select, se crea una proyección de los datos. Las proyecciones no son actualizables. No se puede establecer Select si están habilitadas Habilitar eliminación automática, Habilitar inserción automática o Habilitar actualización automática.