EntityFrameworkQueryableExtensions.AsTracking 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| AsTracking<TEntity>(IQueryable<TEntity>) |
回傳一個新查詢,變更追蹤器會追蹤所有回傳實體的變更。 任何對實體實例的修改都會被偵測到,並在 期間持續存在資料庫 SaveChanges()。 |
| AsTracking<TEntity>(IQueryable<TEntity>, QueryTrackingBehavior) |
會回傳一個新查詢,變更追蹤器會根據「追蹤」參數的值,對所有回傳的實體都會追蹤變更,或不會追蹤。 在追蹤時,任何對實體實例的修改都會被偵測並持續保存到資料庫中。SaveChanges() 當不追蹤時,若實體實例被修改,變更追蹤器不會偵測到,且 SaveChanges() 這些變更不會持久化到資料庫中。 |
AsTracking<TEntity>(IQueryable<TEntity>)
回傳一個新查詢,變更追蹤器會追蹤所有回傳實體的變更。 任何對實體實例的修改都會被偵測到,並在 期間持續存在資料庫 SaveChanges()。
public static System.Linq.IQueryable<TEntity> AsTracking<TEntity>(this System.Linq.IQueryable<TEntity> source) where TEntity : class;
static member AsTracking : System.Linq.IQueryable<'Entity (requires 'Entity : null)> -> System.Linq.IQueryable<'Entity (requires 'Entity : null)> (requires 'Entity : null)
<Extension()>
Public Function AsTracking(Of TEntity As Class) (source As IQueryable(Of TEntity)) As IQueryable(Of TEntity)
類型參數
- TEntity
被查詢的實體類型。
參數
- source
- IQueryable<TEntity>
來源查詢。
傳回
一個新的查詢,結果集會被上下文追蹤。
例外狀況
source 是 null。
備註
查詢的預設追蹤行為可由 QueryTrackingBehavior控制。
更多資訊與範例請參閱 EF Core 中的追蹤查詢 。
適用於
AsTracking<TEntity>(IQueryable<TEntity>, QueryTrackingBehavior)
會回傳一個新查詢,變更追蹤器會根據「追蹤」參數的值,對所有回傳的實體都會追蹤變更,或不會追蹤。 在追蹤時,任何對實體實例的修改都會被偵測並持續保存到資料庫中。SaveChanges() 當不追蹤時,若實體實例被修改,變更追蹤器不會偵測到,且 SaveChanges() 這些變更不會持久化到資料庫中。
public static System.Linq.IQueryable<TEntity> AsTracking<TEntity>(this System.Linq.IQueryable<TEntity> source, Microsoft.EntityFrameworkCore.QueryTrackingBehavior track) where TEntity : class;
static member AsTracking : System.Linq.IQueryable<'Entity (requires 'Entity : null)> * Microsoft.EntityFrameworkCore.QueryTrackingBehavior -> System.Linq.IQueryable<'Entity (requires 'Entity : null)> (requires 'Entity : null)
<Extension()>
Public Function AsTracking(Of TEntity As Class) (source As IQueryable(Of TEntity), track As QueryTrackingBehavior) As IQueryable(Of TEntity)
類型參數
- TEntity
被查詢的實體類型。
參數
- source
- IQueryable<TEntity>
來源查詢。
- track
- QueryTrackingBehavior
顯示查詢是否會追蹤結果。
傳回
一個新的查詢,結果集會被上下文追蹤。
例外狀況
source 是 null。
備註
關閉變更追蹤對於唯讀情境很有用,因為它避免了為每個實體實例設定變更追蹤的額外負擔。 如果你想操作實體實例並將變更持久化到資料庫 SaveChanges(),就不應該關閉變更追蹤。
查詢的預設追蹤行為可由 QueryTrackingBehavior控制。
更多資訊與範例請參閱 EF Core 中的追蹤查詢 。