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