DbQuery<TResult>.Include 方法

[此頁面專屬於 Entity Framework 第 6 版。最新版本可從 'Entity Framework' NuGet 套件取得。如需 Entity Framework 的詳細資訊,請參閱 msdn.com/data/ef。]

指定要包含在查詢結果中的相關物件。

命名空間:  System.Data.Entity.Infrastructure
組件:  EntityFramework (在 EntityFramework.dll 中)

語法

'宣告
Public Overridable Function Include ( _
    path As String _
) As DbQuery(Of TResult)
'用途
Dim instance As DbQuery 
Dim path As String 
Dim returnValue As DbQuery(Of TResult)

returnValue = instance.Include(path)
public virtual DbQuery<TResult> Include(
    string path
)
public:
virtual DbQuery<TResult>^ Include(
    String^ path
)
abstract Include : 
        path:string -> DbQuery<'TResult> 
override Include : 
        path:string -> DbQuery<'TResult> 
public function Include(
    path : String
) : DbQuery<TResult>

參數

  • path
    類型:System.String
    要在查詢結果中傳回的相關物件清單 (以點分隔)。

傳回值

類型:System.Data.Entity.Infrastructure.DbQuery<TResult>
含有已定義之查詢路徑的新 DbQuery<TResult>

備註

路徑是全部包含的。 例如,如果包含呼叫表示 Include("Orders.OrderLines"),則不僅包含 OrderLines,還會包含 Orders。 當您呼叫 Include 方法時,查詢路徑只針對 DbQuery&amp;lt;T&amp;gt; 的傳回執行個體才有效。 其他 DbQuery&amp;lt;T&amp;gt; 執行個體和物件內容本身則不會受到影響。 由於 Include 方法會傳回查詢物件,因此您可以針對 DbQuery&amp;lt;T&amp;gt; 多次呼叫此方法來指定查詢的多個路徑。

請參閱

參考

DbQuery<TResult> 類別

System.Data.Entity.Infrastructure 命名空間