InheritanceMappingAttribute Clase

Definición

Espacio de nombres:

System.Data.Linq.Mapping

Ensamblado:

System.Data.Linq.dll

Asigna una jerarquía de herencia en una aplicación de 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

Herencia

Object

Attribute

InheritanceMappingAttribute

Atributos

AttributeUsageAttribute

Ejemplos

En este ejemplo se muestra la asignación de herencia de una jerarquía donde la clase asignada superior (Shape) es abstracta.

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

En el ejemplo siguiente se muestra la inclusión de clases no asignadas. Puede colocar clases no asignadas en cualquier lugar de la jerarquía.

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

Comentarios

Se especifica uno InheritanceMappingAttribute por clase asignada.

Tenga en cuenta lo siguiente al asignar jerarquías de herencia:

• Todas las clases de una jerarquía deben asignarse a una sola tabla.

• La tabla de una jerarquía de herencia debe declararse en el tipo asignado que se encuentra en la parte superior de la jerarquía. No se pueden especificar los atributos de tabla o asignación de una clase derivada de la clase superior.

• Puede usar una interfaz en una jerarquía, pero LINQ no la asigna.

• Puede omitir una clase en la jerarquía al asignar clases, pero solo puede consultar con clases asignadas.

Para la materialización correcta, los valores de código discriminador deben ser únicos y coincidir con los valores de la base de datos. Una fila con un valor de código discriminador que no coincide exactamente (incluso mediante mayúsculas y minúsculas) crea instancias de la clase mediante el uso IsDefault de establecido en true.

Constructores

InheritanceMappingAttribute()

Inicializa una nueva instancia de la clase InheritanceMappingAttribute.

Propiedades

Code	Obtiene o establece el valor de código del discriminador en una jerarquía de herencia asignada.
IsDefault	Obtiene o establece si se crean instancias de un objeto de este tipo cuando el valor del discriminador no coincide con el valor especificado.
Type	Obtiene o establece el tipo de la clase en la jerarquía.
TypeId	Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Heredado de Attribute)

Métodos

Equals(Object)	Devuelve un valor que indica si esta instancia es igual que un objeto especificado. (Heredado de Attribute)
GetHashCode()	Devuelve el código hash de esta instancia. (Heredado de Attribute)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IsDefaultAttribute()	Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada. (Heredado de Attribute)
Match(Object)	Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado. (Heredado de Attribute)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío. (Heredado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Obtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz. (Heredado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1). (Heredado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Proporciona acceso a las propiedades y los métodos expuestos por un objeto. (Heredado de Attribute)