How to: Map Entities to Database Tables (Entity Data Model Tools)

This topic describes how to map an entity type to a database table by using the ADO.NET Entity Data Model Designer (Entity Designer). The Mapping Details window enables you map an entity to one or more tables, define conditions for the mapping, and specify the column to property mappings.


This topic focuses on how to map an entity type to a single database table. However, an entity type can be mapped to multiple database tables. For an example of how to do this, see Walkthrough: Mapping an Entity to Multiple Tables (Entity Data Model Tools).

The following table describes the fields in the Mapping Details window when an entity type is selected on the design surface.

Name Description


Contains an alphabetized list of all columns in the table.


Shows the mapping or condition operator.


Displays the entity property that is mapped to the column.

If the field is blank, this means that the column is currently not mapped to a scalar property.

When you click the field, it becomes a drop-down list that displays all the scalar properties.

To add a mapping

  1. Right-click an entity type on the design surface or in the Model Browser and select Table Mappings.

    The table mappings are displayed in the Mapping Details window.

  2. In the Mapping Details window, click Add a Table or View.

    The field becomes a drop-down list that contains all the tables in the storage model that are not already included in the current mapping.

  3. Select a table from the list.

    A Maps to <Table Name> node is added to the window. This node contains default mappings between table columns and entity properties.The wizard checks whether column names match property names. If they match, the default mapping is between the column and property of the same name.

    An additional Add a Table or View row appears underneath the new mapping node. This enables you to add another table to the mapping.

  4. Expand the Maps to <Table Name> node.

    You can use the Add a Condition option to add a condition. Conditions enable the mapping system to map a particular type in the hierarchy to or from rows in a table, based on the values of the selected condition columns. Entity types can define a set of conditions for each table to which they are mapped. For more information, see How to: Add or Delete Conditions (Entity Data Model Tools).

    A Column Mappings node also appears.

  5. Expand the Column Mappings node.

    A list of all the columns in the table appears. The default properties (if any) to which the columns map are listed under the Value/Property heading.

  6. Select the column you want to map, and then right-click the corresponding Value/Property field.

    A drop-down list of all the scalar properties is displayed.

  7. Select the appropriate property.

  8. Repeat steps 6 and 7 for each table column.

To delete a table mapping

  1. Click the Maps to <Table Name> node.

    The field becomes a drop-down list.

  2. Select Delete.

To delete a column mapping

  1. Select the column that you want to map, and then click the Value/Property field.

    The field becomes a drop-down list.

  2. Select Delete.

See Also

Other Resources

Entity Data Model Tools Tasks
Entity Data Model Tools Scenarios