IncludeAttribute クラス

アソシエーションをコード生成されたクライアント エンティティの一部に含めることを指定します。

名前空間: System.ServiceModel.DomainServices.Server
アセンブリ: System.ServiceModel.DomainServices.Server (system.servicemodel.domainservices.server.dll 内)

使用方法

'使用
Dim instance As IncludeAttribute

構文

'宣言
<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

例

次の例は、階層の一部を構成するメンバーに適用される IncludeAttribute 属性を示します。

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

    }
}

クエリに結果を含める方法を次の例に示します。

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

解説

エンティティのアソシエーションに適用する場合、この属性はアソシエーションをコード生成されたクライアント エンティティの一部に含めること、および結果をクライアントにシリアル化する場合に関連エンティティを含めることを指定します。クエリ メソッドでは、クエリに Include メソッドを使用することで、関連エンティティが実際に読み込まれることを確認する必要があります。この属性は、メンバーの投影を指定するためにも使用できます。

継承階層

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

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバーは、スレッド セーフです。インスタンス メンバーの場合は、スレッド セーフであるとは限りません。

プラットフォーム

開発プラットフォーム

Windows XP Home Edition, Windows XP Professional, Windows Server 2003 、Windows Server 2008、および Windows 2000

ターゲット プラットフォーム

Change History

参照

リファレンス

IncludeAttribute のメンバー
System.ServiceModel.DomainServices.Server 名前空間