IncludeAttribute-Klasse

Gibt an, dass die Zuordnung Teil aller durch Code generierten Cliententitäten sein soll.

Namespace: System.ServiceModel.DomainServices.Server
Assembly: System.ServiceModel.DomainServices.Server (in system.servicemodel.domainservices.server.dll)

Verwendung

'Usage
Dim instance As IncludeAttribute

Syntax

'Declaration
<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

Beispiel

Im folgenden Beispiel wird das auf einen Member, der Teil einer Hierarchie ist, angewendete IncludeAttribute-Attribut gezeigt.

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

    }
}

Im folgenden Beispiel wird gezeigt, wie die Ergebnisse in die Abfrage eingeschlossen werden.

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

Hinweise

Wenn dieses Attribut auf eine Entitätszuordnung angewendet wird, gibt es an, dass die Zuordnung Teil aller durch Code generierten Cliententitäten sein soll und dass beim Serialisieren von Ergebnissen für den Client alle zugehörigen Entitäten eingeschlossen werden sollen. Sie müssen in der Abfragemethode mit der Include-Methode für die Abfrage sicherstellen, dass die zugeordneten Entitäten tatsächlich geladen werden. Dieses Attribut kann auch verwendet werden, um Memberprojektionen anzugeben.

Vererbungshierarchie

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

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht sichergestellt.

Plattformen

Entwicklungsplattformen

Windows XP Home Edition, Windows XP Professional, Windows Server 2003 , Windows Server 2008 und Windows 2000

Zielplattformen

Change History

Siehe auch

Verweis

IncludeAttribute-Member
System.ServiceModel.DomainServices.Server-Namespace