QueryableExtensions.Include<T> 方法 (IQueryable<T>, String)
[此頁面專屬於 Entity Framework 第 6 版。最新版本可從 'Entity Framework' NuGet 套件取得。如需 Entity Framework 的詳細資訊,請參閱 msdn.com/data/ef。]
指定要包含在查詢結果中的相關物件。
命名空間: System.Data.Entity
組件: EntityFramework (在 EntityFramework.dll 中)
語法
'宣告
<ExtensionAttribute> _
Public Shared Function Include(Of T) ( _
source As IQueryable(Of T), _
path As String _
) As IQueryable(Of T)
'用途
Dim source As IQueryable(Of T)
Dim path As String
Dim returnValue As IQueryable(Of T)
returnValue = source.Include(path)
public static IQueryable<T> Include<T>(
this IQueryable<T> source,
string path
)
[ExtensionAttribute]
public:
generic<typename T>
static IQueryable<T>^ Include(
IQueryable<T>^ source,
String^ path
)
static member Include :
source:IQueryable<'T> *
path:string -> IQueryable<'T>
JScript does not support generic types and methods.
類型參數
- T
正在查詢之實體的類型。
參數
- source
類型:System.Linq.IQueryable<T>
呼叫 Include 所在的來源 IQueryable<T>。
- path
類型:System.String
要在查詢結果中傳回的相關物件清單 (以點分隔)。
傳回值
類型:System.Linq.IQueryable<T>
含有已定義之查詢路徑的新 IQueryable<T>。
使用注意事項
在 Visual Basic 和 C# 中,您可以在任何 IQueryable<T> 類型物件中呼叫這個方法以做為執行個體。使用執行個體方法語法呼叫這個方法時,請省略第一個參數。如需詳細資訊,請參閱 https://msdn.microsoft.com/zh-tw/library/bb384936(v=vs.113)或 https://msdn.microsoft.com/zh-tw/library/bb383977(v=vs.113)。
備註
此擴充方法會呼叫 IQueryable<T> 來源物件的 Include(String) 方法 (如果有這類方法存在)。 如果來源 IQueryable<T> 沒有符合的方法,此方法不會做任何事。 ObjectQuery<T>、ObjectSet<TEntity>、DbQuery<TResult> 和 DbSet<TEntity> 類型全都有要呼叫的適當 Include 方法。 路徑是全部包含的。 例如,如果包含呼叫表示 Include("Orders.OrderLines"),則不僅包含 OrderLines,還會包含 Orders。 當您呼叫 Include 方法時,此查詢路徑只適用於傳回的 IQueryable<T> 執行個體。 其他 IQueryable<T> 執行個體和物件內容本身則不會受到影響。 由於 Include 方法會傳回查詢物件,因此您可以針對 IQueryable<T> 多次呼叫此方法來指定查詢的多個路徑。