LocalView<TEntity>.GetEntries 方法

定義

命名空間:

Microsoft.EntityFrameworkCore.ChangeTracking

組件:

Microsoft.EntityFrameworkCore.dll

套件:

Microsoft.EntityFrameworkCore v8.0.0

多載

GetEntries(IEnumerable<IProperty>, IEnumerable<Object>)	EntityEntry傳回內容所追蹤之每個實體的 ，其中指定屬性的值符合指定的值。 專案提供變更追蹤資訊和每個實體作業的存取權。
GetEntries(IEnumerable<String>, IEnumerable<Object>)	EntityEntry傳回內容所追蹤之每個實體的 ，其中指定屬性的值符合指定的值。 專案提供變更追蹤資訊和每個實體作業的存取權。
GetEntries<TProperty>(String, TProperty)	EntityEntry<TEntity>傳回內容所追蹤之每個實體的 ，其中指定屬性的值符合指定的值。 專案提供變更追蹤資訊和每個實體作業的存取權。
GetEntries<TProperty>(IProperty, TProperty)	EntityEntry<TEntity>傳回內容所追蹤之每個實體的 ，其中指定屬性的值符合指定的值。 專案提供變更追蹤資訊和每個實體作業的存取權。

GetEntries(IEnumerable<IProperty>, IEnumerable<Object>)

EntityEntry傳回內容所追蹤之每個實體的 ，其中指定屬性的值符合指定的值。 專案提供變更追蹤資訊和每個實體作業的存取權。

public virtual System.Collections.Generic.IEnumerable<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<TEntity>> GetEntries (System.Collections.Generic.IEnumerable<Microsoft.EntityFrameworkCore.Metadata.IProperty> properties, System.Collections.Generic.IEnumerable<object?> propertyValues);

abstract member GetEntries : seq<Microsoft.EntityFrameworkCore.Metadata.IProperty> * seq<obj> -> seq<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>>
override this.GetEntries : seq<Microsoft.EntityFrameworkCore.Metadata.IProperty> * seq<obj> -> seq<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>>

Public Overridable Function GetEntries (properties As IEnumerable(Of IProperty), propertyValues As IEnumerable(Of Object)) As IEnumerable(Of EntityEntry(Of TEntity))

參數

properties

IEnumerable<IProperty>

要比對的屬性。

propertyValues

IEnumerable<Object>

要比對的屬性值。

傳回

IEnumerable<EntityEntry<TEntity>>

所追蹤之每個實體的專案。

備註

這個方法經常用來取得具有指定非 Null 外鍵、主鍵或替代索引鍵值的實體。 使用類似這個索引鍵屬性的查閱比其他屬性值的查閱更有效率。

根據預設，存取 Local 會呼叫 DetectChanges() 以確保所有搜尋並傳回的實體都是最新的。 呼叫這個方法不會產生對 的另一個呼叫 DetectChanges() 。 由於這個方法通常用於快速查閱，請考慮重複使用 Local 物件進行多個查閱和/或停用使用 AutoDetectChangesEnabled 自動偵測變更。

請注意，在逐一查看傳回列舉時，實體狀態的修改可能會導致 ， InvalidOperationException 表示列舉時已修改集合。 若要避免這種情況，請先使用 ToList<TSource>(IEnumerable<TSource>) 或類似專案建立防禦性複本，再進行反覆運算。

如需詳細資訊和範例，請參閱 EF Core 變更追蹤 。

GetEntries(IEnumerable<String>, IEnumerable<Object>)

EntityEntry傳回內容所追蹤之每個實體的 ，其中指定屬性的值符合指定的值。 專案提供變更追蹤資訊和每個實體作業的存取權。

public virtual System.Collections.Generic.IEnumerable<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<TEntity>> GetEntries (System.Collections.Generic.IEnumerable<string> propertyNames, System.Collections.Generic.IEnumerable<object?> propertyValues);

abstract member GetEntries : seq<string> * seq<obj> -> seq<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>>
override this.GetEntries : seq<string> * seq<obj> -> seq<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>>

Public Overridable Function GetEntries (propertyNames As IEnumerable(Of String), propertyValues As IEnumerable(Of Object)) As IEnumerable(Of EntityEntry(Of TEntity))

參數

propertyNames

IEnumerable<String>

要比對的屬性名稱。

propertyValues

IEnumerable<Object>

要比對的屬性值。

傳回

IEnumerable<EntityEntry<TEntity>>

所追蹤之每個實體的專案。

備註

這個方法經常用來取得具有指定非 Null 外鍵、主鍵或替代索引鍵值的實體。 使用類似這個索引鍵屬性的查閱比其他屬性值的查閱更有效率。

根據預設，存取 Local 會呼叫 DetectChanges() 以確保所有搜尋並傳回的實體都是最新的。 呼叫這個方法不會產生對 的另一個呼叫 DetectChanges() 。 由於這個方法通常用於快速查閱，請考慮重複使用 Local 物件進行多個查閱和/或停用使用 AutoDetectChangesEnabled 自動偵測變更。

請注意，在逐一查看傳回列舉時，實體狀態的修改可能會導致 ， InvalidOperationException 表示列舉時已修改集合。 若要避免這種情況，請先使用 ToList<TSource>(IEnumerable<TSource>) 或類似專案建立防禦性複本，再進行反覆運算。

如需詳細資訊和範例，請參閱 EF Core 變更追蹤 。

GetEntries<TProperty>(String, TProperty)

EntityEntry<TEntity>傳回內容所追蹤之每個實體的 ，其中指定屬性的值符合指定的值。 專案提供變更追蹤資訊和每個實體作業的存取權。

public virtual System.Collections.Generic.IEnumerable<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<TEntity>> GetEntries<TProperty> (string propertyName, TProperty? propertyValue);

abstract member GetEntries : string * 'Property -> seq<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>>
override this.GetEntries : string * 'Property -> seq<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>>

Public Overridable Function GetEntries(Of TProperty) (propertyName As String, propertyValue As TProperty) As IEnumerable(Of EntityEntry(Of TEntity))

類型參數

TProperty

屬性值的類型。

參數

propertyName

String

要比對的屬性名稱。

propertyValue

TProperty

要比對的屬性值。

傳回

IEnumerable<EntityEntry<TEntity>>

所追蹤之每個實體的專案。

備註

這個方法經常用來取得具有指定非 Null 外鍵、主鍵或替代索引鍵值的實體。 使用類似這個索引鍵屬性的查閱比其他屬性值的查閱更有效率。

根據預設，存取 Local 會呼叫 DetectChanges() 以確保所有搜尋並傳回的實體都是最新的。 呼叫這個方法不會產生對 的另一個呼叫 DetectChanges() 。 由於這個方法通常用於快速查閱，請考慮重複使用 Local 物件進行多個查閱和/或停用使用 AutoDetectChangesEnabled 自動偵測變更。

請注意，在逐一查看傳回列舉時，實體狀態的修改可能會導致 ， InvalidOperationException 表示列舉時已修改集合。 若要避免這種情況，請先使用 ToList<TSource>(IEnumerable<TSource>) 或類似專案建立防禦性複本，再進行反覆運算。

如需詳細資訊和範例，請參閱 EF Core 變更追蹤 。

GetEntries<TProperty>(IProperty, TProperty)

EntityEntry<TEntity>傳回內容所追蹤之每個實體的 ，其中指定屬性的值符合指定的值。 專案提供變更追蹤資訊和每個實體作業的存取權。

public virtual System.Collections.Generic.IEnumerable<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<TEntity>> GetEntries<TProperty> (Microsoft.EntityFrameworkCore.Metadata.IProperty property, TProperty? propertyValue);

abstract member GetEntries : Microsoft.EntityFrameworkCore.Metadata.IProperty * 'Property -> seq<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>>
override this.GetEntries : Microsoft.EntityFrameworkCore.Metadata.IProperty * 'Property -> seq<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity>>

Public Overridable Function GetEntries(Of TProperty) (property As IProperty, propertyValue As TProperty) As IEnumerable(Of EntityEntry(Of TEntity))

類型參數

TProperty

屬性值的類型。

參數

property

IProperty

要比對的屬性。

propertyValue

TProperty

要比對的屬性值。

傳回

IEnumerable<EntityEntry<TEntity>>

所追蹤之每個實體的專案。

備註

這個方法經常用來取得具有指定非 Null 外鍵、主鍵或替代索引鍵值的實體。 使用類似這個索引鍵屬性的查閱比其他屬性值的查閱更有效率。

根據預設，存取 Local 會呼叫 DetectChanges() 以確保所有搜尋並傳回的實體都是最新的。 呼叫這個方法不會產生對 的另一個呼叫 DetectChanges() 。 由於這個方法通常用於快速查閱，請考慮重複使用 Local 物件進行多個查閱和/或停用使用 AutoDetectChangesEnabled 自動偵測變更。

請注意，在逐一查看傳回列舉時，實體狀態的修改可能會導致 ， InvalidOperationException 表示列舉時已修改集合。 若要避免這種情況，請先使用 ToList<TSource>(IEnumerable<TSource>) 或類似專案建立防禦性複本，再進行反覆運算。

如需詳細資訊和範例，請參閱 EF Core 變更追蹤 。