Classe IncludeAttribute

Article
03/18/2011

Spécifie que l'association doit faire partie de toutes les entités générées par du code sur le client.

Espace de noms: System.ServiceModel.DomainServices.Server
Assembly : System.ServiceModel.DomainServices.Server (dans system.servicemodel.domainservices.server.dll)

Utilisation

'Utilisation
Dim instance As IncludeAttribute

Syntaxe

'Déclaration
<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

Exemple

L'exemple suivant illustre l'attribut IncludeAttribute appliqué à un membre appartenant à une hiérarchie.

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

    }
}

L'exemple suivant montre comment inclure les résultats dans la requête.

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");
}

Notes

Lorsqu'il est appliqué à une association d'entité, cet attribut spécifie que l'association doit faire partie de toutes les entités générées par du code sur le client, et que toutes les entités associées doivent être incluses lors de la sérialisation des résultats vers le client. Dans la méthode de requête, vous devez vous assurer que les entités associées sont effectivement chargées en utilisant la méthode Include sur la requête. Cet attribut peut également être utilisé pour spécifier des projections de membres.

Hiérarchie d'héritage

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

Sécurité des threads

Tous les membres publics statiques (Partagés dans Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Plateformes

Plateformes de développement

Windows XP Édition familiale, Windows XP Professionnel, Windows Server 2003 , Windows Server 2008 et Windows 2000

Plateformes cibles

Change History

Voir aussi

Référence

Membres IncludeAttribute
Espace de noms System.ServiceModel.DomainServices.Server

Partager via