InheritanceMappingAttribute Klas

Definitie

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

Overname

Object

Attribute

InheritanceMappingAttribute

Kenmerken

AttributeUsageAttribute

Voorbeelden

In dit voorbeeld ziet u overnametoewijzing voor een hiërarchie waarin de bovenste, toegewezen klasse (Shape) abstract is.

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

In het volgende voorbeeld ziet u de opname van niet-toegewezen klassen. U kunt niet-toegewezen klassen overal in de hiërarchie plaatsen.

// 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

Opmerkingen

Er wordt één InheritanceMappingAttribute opgegeven per toegewezen klasse.

Let op het volgende wanneer u overnamehiërarchieën toe wijzen:

• Alle klassen in een hiërarchie moeten worden toegewezen aan één tabel.

• De tabel voor een overnamehiërarchie moet worden gedeclareerd op het toegewezen type dat zich boven aan de hiërarchie bevindt. U kunt de tabel- of toewijzingskenmerken niet opgeven in een klasse die is afgeleid van de topklasse.

• U kunt een interface in een hiërarchie gebruiken, maar LINQ wijst deze niet toe.

• U kunt een klasse in de hiërarchie overslaan wanneer u klassen toe wijzen, maar u kunt alleen query's uitvoeren op toegewezen klassen.

Voor de juiste materialisatie moeten de codewaarden van de discriminator uniek zijn en overeenkomen met de waarden in de database. Een rij met een discriminatorcodewaarde die niet exact overeenkomt (zelfs door casing) instantiëert de klasse met behulp van IsDefault ingesteld op true.