Principal (Elemento) (SSDL)

En el lenguaje de definición de esquemas de almacenamiento (SSDL), el elemento Principal es un elemento secundario del elemento ReferentialConstraint que define el extremo principal de una restricción de clave externa (también llamada restricción referencial). El elemento Principal especifica la columna (o columnas) de clave principal de una tabla a las que hace referencia otra columna (o columnas). Los elementos PropertyRef especifican a qué columnas se hace referencia. El elemento Dependent especifica columnas que hacen referencia a las columnas de clave principal que se especifican en el elemento Principal.

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

• PropertyRef (uno o varios)

• Elementos Annotation (cero o más)

Atributos aplicables

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

Nombre de atributo	Es necesario	Valor
Role	Sí	El mismo valor que el atributo Role (si se utiliza) del elemento End correspondiente; de lo contrario, el nombre de la tabla que contiene la columna a la que se hace referencia.

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 siguiente ejemplo se muestra un elemento Association que utiliza un elemento ReferentialConstraint para especificar las columnas que participan en la restricción de clave externa FK_CustomerOrders. El elemento Principal especifica la columna CustomerId de la tabla Customer como el extremo principal de la restricción.

<Association Name="FK_CustomerOrders">
  <End Role="Customers" 
       Type="ExampleModel.Store.Customers" Multiplicity="1">
    <OnDelete Action="Cascade" />
  </End>
  <End Role="Orders" 
       Type="ExampleModel.Store.Orders" Multiplicity="*" />
  <ReferentialConstraint>
    <Principal Role="Customers">
      <PropertyRef Name="CustomerId" />
    </Principal>
    <Dependent Role="Orders">
      <PropertyRef Name="CustomerId" />
    </Dependent>
  </ReferentialConstraint>
</Association>

Vea también

Conceptos

Información general de Entity Framework
Especificación SSDL

Otros recursos

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