InheritanceMappingAttribute Classe

Définition

public ref class InheritanceMappingAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true, Inherited=false)]
public sealed class InheritanceMappingAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true, Inherited=false)>]
type InheritanceMappingAttribute = class
    inherit Attribute

Public NotInheritable Class InheritanceMappingAttribute
Inherits Attribute

Héritage

Object

Attribute

InheritanceMappingAttribute

Attributs

AttributeUsageAttribute

Exemples

Cet exemple montre le mappage d’héritage pour une hiérarchie où la classe mappée supérieure (Shape) est abstraite.

public enum ShapeType
{
    Square = 0, Circle = 1
}
[Table(Name = "Shape")]
[InheritanceMapping(Code = ShapeType.Square, Type = typeof(Square),
    IsDefault = true)]
[InheritanceMapping(Code = ShapeType.Circle, Type = typeof(Circle))]

abstract public class Shape
{
    [Column(IsDiscriminator = true)]
    public ShapeType ShapeType = 0;
}

public class Square : Shape
{
    [Column]
    public int Side = 0;
}
public class Circle : Shape
{
    [Column]
    public int Radius = 0;
}

Public Enum ShapeType As Integer
    Square = 0
    Circle = 1
End Enum

<Table(Name:="Shape")> _
<InheritanceMapping(Code:=ShapeType.Square, Type:=GetType(Square), _
    IsDefault:=True)> _
<InheritanceMapping(Code:=ShapeType.Circle, Type:=GetType(Circle))> _
Public MustInherit Class Shape
    <Column(IsDiscriminator:=True)> _
        Public ShapeType As ShapeType = 0
End Class

Public Class Square
    Inherits Shape
    <Column()> _
    Public Side As Integer = 0
End Class

Public Class Circle
    Inherits Shape
    <Column()> _
    Public Radius As Integer = 0
End Class

L’exemple suivant montre l’inclusion de classes non mappées. Vous pouvez placer des classes non mappées n’importe où dans la hiérarchie.

// Unmapped and not queryable.
class A {  }

// Mapped and queryable.
[Table]
[InheritanceMapping(Code = "B", Type = typeof(B),
IsDefault = true)]
[InheritanceMapping(Code = "D", Type = typeof(D))]
class B: A {  }

// Unmapped and not queryable.
class C: B {  }

// Mapped and queryable.
class D: C {  }

// Unmapped and not queryable.
class E: D {  }

' Unmapped and not queryable.
Class A
End Class

' Mapped and queryable.
<Table()> _
<InheritanceMapping(Code:="B", Type:=GetType(B), _
IsDefault:=True)> _
<InheritanceMapping(Code:="D", Type:=GetType(D))> _
Class B
    Inherits A
End Class

' Unmapped and not queryable.
Class C
    Inherits B
End Class

' Mapped and queryable.
Class D
    Inherits C
End Class

' Unmapped and not queryable.
Class E
    Inherits D
End Class

Remarques

Un InheritanceMappingAttribute est spécifié par classe mappée.

Notez les points suivants lorsque vous mappez des hiérarchies d’héritage :

• Toutes les classes d’une hiérarchie doivent être mappées à une seule table.

• La table d’une hiérarchie d’héritage doit être déclarée sur le type mappé qui se trouve en haut de la hiérarchie. Vous ne pouvez pas spécifier la table ou les attributs de mappage dans une classe dérivée de la classe supérieure.

• Vous pouvez utiliser une interface dans une hiérarchie, mais LINQ ne la mappe pas.

• Vous pouvez ignorer une classe dans la hiérarchie lorsque vous mappez des classes, mais vous pouvez uniquement interroger des classes mappées.

Pour une matérialisation correcte, les valeurs de code de discriminateur doivent être uniques et correspondre aux valeurs de la base de données. Une ligne avec une valeur de code de discriminateur qui ne correspond pas exactement (même par casse) instancie la classe à l’aide IsDefault de la valeur définie sur true.

Constructeurs

Propriétés

Méthodes

Implémentations d’interfaces explicites

S’applique à