InheritanceMappingAttribute Třída

Definice

Obor názvů:

System.Data.Linq.Mapping

Sestavení:

System.Data.Linq.dll

Mapuje hierarchii dědičnosti v aplikaci LINQ to SQL.

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

Dědičnost

Object

Attribute

InheritanceMappingAttribute

Atributy

AttributeUsageAttribute

Příklady

Tento příklad ukazuje mapování dědičnosti pro hierarchii, kde je nejvyšší mapovaná třída (Shape) abstraktní.

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

Následující příklad ukazuje zahrnutí nemapovaných tříd. Nemapované třídy můžete umístit kdekoli v hierarchii.

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

Poznámky

Jedna InheritanceMappingAttribute je určena pro každou mapovanou třídu.

Při mapování hierarchií dědičnosti mějte na paměti následující:

• Všechny třídy v hierarchii musí být namapovány na jednu tabulku.

• Tabulka hierarchie dědičnosti musí být deklarována na mapovaném typu, který je v horní části hierarchie. Nelze zadat atributy tabulky nebo mapování ve třídě, která je odvozena z nejvyšší třídy.

• Rozhraní můžete použít v hierarchii, ale LINQ ho nemapuje.

• Třídu v hierarchii můžete při mapování tříd přeskočit, ale dotazovat se můžete pouze na mapované třídy.

Pro správnou materializaci musí být diskriminující hodnoty kódu jedinečné a musí odpovídat hodnotám v databázi. Řádek s diskriminátorovou hodnotou kódu, která se přesně neshoduje (ani pomocí velikostí) vytvoří instanci třídy pomocí IsDefault nastavené na truehodnotu .

Konstruktory

Name	Description
InheritanceMappingAttribute()	Inicializuje novou instanci InheritanceMappingAttribute třídy.

Vlastnosti

Name	Description
Code	Získá nebo nastaví diskriminující hodnotu kódu v mapované dědičné hierarchii.
IsDefault	Získá nebo nastaví, zda objekt tohoto typu v instanci v případě, že diskriminující hodnota neodpovídá zadané hodnotě.
Type	Získá nebo nastaví typ třídy v hierarchii.
TypeId	Při implementaci v odvozené třídě získá jedinečný identifikátor pro tento Attribute. (Zděděno od Attribute)

Metody

Name	Description
Equals(Object)	Vrátí hodnotu, která určuje, zda je tato instance rovna zadanému objektu. (Zděděno od Attribute)
GetHashCode()	Vrátí kód hash pro tuto instanci. (Zděděno od Attribute)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
IsDefaultAttribute()	Při přepsání v odvozené třídě určuje, zda hodnota této instance je výchozí hodnotou pro odvozenou třídu. (Zděděno od Attribute)
Match(Object)	Při přepsání v odvozené třídě vrátí hodnotu, která určuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

Name	Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mapuje sadu názvů na odpovídající sadu identifikátorů pro rozesílání. (Zděděno od Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Načte informace o typu objektu, který lze použít k získání informací o typu pro rozhraní. (Zděděno od Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Získá počet rozhraní typu informací, které objekt poskytuje (0 nebo 1). (Zděděno od Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Poskytuje přístup k vlastnostem a metodám vystaveným objektem. (Zděděno od Attribute)