Clase IncludeAttribute

Artículo
03/18/2011

Especifica que la asociación debe ser parte de las entidades de cliente generadas por el código.

Espacio de nombres: System.ServiceModel.DomainServices.Server
Ensamblado: System.ServiceModel.DomainServices.Server (en system.servicemodel.domainservices.server.dll)

Uso

'Uso
Dim instance As IncludeAttribute

Sintaxis

'Declaración
<AttributeUsageAttribute(AttributeTargets.Property Or AttributeTargets.Field, AllowMultiple:=True, Inherited:=True)> _
Public NotInheritable Class IncludeAttribute
    Inherits Attribute

[AttributeUsageAttribute(AttributeTargets.Property|AttributeTargets.Field, AllowMultiple=true, Inherited=true)] 
public sealed class IncludeAttribute : Attribute

[AttributeUsageAttribute(AttributeTargets::Property|AttributeTargets::Field, AllowMultiple=true, Inherited=true)] 
public ref class IncludeAttribute sealed : public Attribute

/** @attribute AttributeUsageAttribute(AttributeTargets.Property|AttributeTargets.Field, AllowMultiple=true, Inherited=true) */ 
public final class IncludeAttribute extends Attribute

AttributeUsageAttribute(AttributeTargets.Property|AttributeTargets.Field, AllowMultiple=true, Inherited=true) 
public final class IncludeAttribute extends Attribute

Ejemplo

En el ejemplo siguiente se muestra el atributo IncludeAttribute aplicado a un miembro que es parte de una jerarquía.

<MetadataTypeAttribute(GetType(SalesOrderHeader.SalesOrderHeaderMetadata))>  _
Partial Public Class SalesOrderHeader
    
    Friend NotInheritable Class SalesOrderHeaderMetadata
        
        Private Sub New()
            MyBase.New
        End Sub
        
        <Include()> _
        <Composition()> _
        Public SalesOrderDetails As EntityCollection(Of SalesOrderDetail)
        
    End Class
End Class

[MetadataTypeAttribute(typeof(SalesOrderHeader.SalesOrderHeaderMetadata))]
public partial class SalesOrderHeader
{
    internal sealed class SalesOrderHeaderMetadata
    {
        private SalesOrderHeaderMetadata()
        {
        }

        [Include]
        [Composition]
        public EntitySet<SalesOrderDetail> SalesOrderDetails;

    }
}

En el ejemplo siguiente se muestra cómo incluir los resultados en la consulta.

Public Function GetSalesOrders() As IQueryable(Of SalesOrderHeader)
    Return Me.ObjectContext.SalesOrderHeaders.Include("SalesOrderDetails")
End Function

public IQueryable<SalesOrderHeader> GetSalesOrders()
{
    return this.ObjectContext.SalesOrderHeaders.Include("SalesOrderDetails");
}

Notas

Cuando se aplica a una asociación de entidad, este atributo especifica que la asociación debe ser parte de las entidades de cliente generadas por el código, y que las entidades relacionadas deben incluirse al serializar los resultados en el cliente. En el método de consulta, es preciso garantizar que las entidades asociadas se carguen realmente; para ello, se usa el método Include en la consulta. Este atributo también se puede usar para especificar proyecciones de miembro.

Jerarquía de herencia

System.Object
System.Attribute
System.ServiceModel.DomainServices.Server.IncludeAttribute

Seguridad para subprocesos

Cualquier miembro estático público (Compartidos en Visual Basic) de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Plataformas

Plataformas de desarrollo

Microsoft Windows XP Home Edition, Windows XP Professional, Windows Server 2003 , Windows Server 2008 y Windows 2000

Plataformas de destino

Change History

Vea también

Referencia

Miembros IncludeAttribute
Espacio de nombres System.ServiceModel.DomainServices.Server

Share via