EntitySet (Elemento) (CSDL)

Artículo
02/27/2011

El elemento EntitySet en el lenguaje de definición de esquemas conceptuales es un contenedor lógico para las instancias de un tipo de entidad y las instancias de cualquier tipo que se derive de ese tipo de entidad. La relación entre un tipo de entidad y un conjunto de entidades es análoga a la relación entre una fila y una tabla en una base de datos relacional. Igual que una fila, un tipo de entidad define un conjunto de datos relacionados y, lo mismo que una tabla, un conjunto de entidades contiene instancias de esa definición. Un conjunto de entidades proporciona una construcción para agrupar las instancias del tipo de entidad para que se pueden asignar a las estructuras de datos relacionadas en un origen de datos. Para obtener más información, vea EntityContainerMapping (Elemento) (MSL) y EntitySetMapping (Elemento) (MSL).

Se pueden definir varios conjuntos de entidades para un tipo de entidad determinado.

Nota:
Entity Data Model Designer (Entity Designer) no admite modelos conceptuales que contienen varios conjuntos de entidades por tipo.

El elemento EntitySet puede tener los elementos secundarios siguientes (en el orden mostrado):

Elemento Documentation (cero o más elementos)
Elementos Annotation (cero o más elementos)

Atributos aplicables

En la tabla siguiente se describen los atributos que pueden aplicarse al elemento EntitySet.

Nombre de atributo	Es necesario	Valor
Name	Sí	El nombre del conjunto de entidades.
EntityType	Sí	El nombre completo del tipo de entidad para el que el conjunto de entidades contiene las instancias.

Nota:
Se puede aplicar cualquier número de atributos de anotación (atributos XML personalizados) al elemento EntitySet.Sin embargo, es posible que los atributos personalizados no pertenezcan a ningún espacio de nombres XML reservado para CSDL.Dos atributos personalizados cualesquiera no pueden tener nombres completos idénticos.

Ejemplo

En el ejemplo siguiente se muestra un elemento EntityContainer con tres elementos EntitySet y dos elementos :

<EntityContainer Name="BooksContainer" >
  <EntitySet Name="Books" EntityType="BooksModel.Book" />
  <EntitySet Name="Publishers" EntityType="BooksModel.Publisher" />
  <EntitySet Name="Authors" EntityType="BooksModel.Author" />
  <AssociationSet Name="PublishedBy" Association="BooksModel.PublishedBy">
    <End Role="Book" EntitySet="Books" />
    <End Role="Publisher" EntitySet="Publishers" />
  </AssociationSet>
  <AssociationSet Name="WrittenBy" Association="BooksModel.WrittenBy">
    <End Role="Book" EntitySet="Books" />
    <End Role="Author" EntitySet="Authors" />
  </AssociationSet>
</EntityContainer>

Es posible definir varios conjuntos de entidades por tipo (MEST). En el ejemplo siguiente se define un contenedor de entidad con dos conjuntos de entidades para el tipo de entidad Book:

<EntityContainer Name="BooksContainer" >
  <EntitySet Name="Books" EntityType="BooksModel.Book" />
  <EntitySet Name="FictionBooks" EntityType="BooksModel.Book" />
  <EntitySet Name="Publishers" EntityType="BooksModel.Publisher" />
  <EntitySet Name="Authors" EntityType="BooksModel.Author" />
  <AssociationSet Name="PublishedBy" Association="BooksModel.PublishedBy">
    <End Role="Book" EntitySet="Books" />
    <End Role="Publisher" EntitySet="Publishers" />
  </AssociationSet>
  <AssociationSet Name="BookAuthor" Association="BooksModel.BookAuthor">
    <End Role="Book" EntitySet="Books" />
    <End Role="Author" EntitySet="Authors" />
  </AssociationSet>
</EntityContainer>

Vea también

Conceptos

Información general de Entity Framework
Especificación CSDL
EntityContainer (Elemento) (CSDL)

Otros recursos

Especificaciones CSDL, SSDL y MSL
ADO.NET Entity Data Model Tools
entity set (Entity Data Model)