Principal (Elemento) (CSDL)

Artículo
02/27/2011

En el lenguaje de definición de esquemas conceptuales (CSDL), el elemento Principal es un elemento secundario del elemento ReferentialConstraint y define el extremo principal de una restricción referencial. Un elemento ReferentialConstraint define una funcionalidad similar a una restricción de integridad referencial en una base de datos relacional. Del mismo modo que una columna (o columnas) de una tabla de base de datos puede hacer referencia a la clave principal de otra tabla, una propiedad (o propiedades) de un tipo de entidad puede hacer referencia a la clave de entidad de otro tipo de entidad. El tipo de entidad al que se hace referencia se denomina extremo principal de la restricción. El tipo de entidad que hace referencia al extremo principal se denomina extremo dependiente de la restricción. Los elementos PropertyRef se utilizan para especificar a qué claves hace referencia el extremo dependiente.

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

PropertyRef (uno o varios elementos)
Elementos Annotation (cero o más elementos)

Atributos aplicables

En la tabla siguiente se describen los atributos que se pueden aplicar al elemento Principal.

Nombre de atributo	Es necesario	Valor
Role	Sí	Nombre del tipo de entidad del extremo principal de la asociación.

Nota:
Se puede aplicar cualquier número de atributos de anotación (atributos XML personalizados) al elemento Principal.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 ReferentialConstraint que se usa como parte de la definición de la asociación PublishedBy. La propiedad Id del tipo de entidad Publisher constituye el extremo principal de la restricción referencial.

<Association Name="PublishedBy">
  <End Type="BooksModel.Book" Role="Book" Multiplicity="*" >
  </End>
  <End Type="BooksModel.Publisher" Role="Publisher" Multiplicity="1" />
  <ReferentialConstraint>
    <Principal Role="Publisher">
      <PropertyRef Name="Id" />
    </Principal>
    <Dependent Role="Book">
      <PropertyRef Name="PublisherId" />
    </Dependent>
  </ReferentialConstraint>
</Association>

Vea también

Conceptos

Información general de Entity Framework
Especificación CSDL
Schema (Elemento) (CSDL)
Association (Elemento) (CSDL)
Dependent (Elemento) (CSDL)

Otros recursos

Especificaciones CSDL, SSDL y MSL
ADO.NET Entity Data Model Tools