DbSet<TEntity>.Find 方法
[此頁面專屬於 Entity Framework 第 6 版。最新版本可從 'Entity Framework' NuGet 套件取得。如需 Entity Framework 的詳細資訊，請參閱 msdn.com/data/ef。]
尋找具有給定主索引鍵值的實體。 如果具有給定主索引鍵值的實體存在於內容中，則會立刻傳回此實體，而不會對存放區發出要求。 同樣地，如果是具有給定主索引鍵值的實體，則會對存放區發出要求，而且如果找到此實體，則會將它附加至內容中並傳回。 如果內容或存放區中找不到任何實體，則會傳回 null。
命名空間： System.Data.Entity
組件： EntityFramework (在 EntityFramework.dll 中)
語法
'宣告
Public Overridable Function Find ( _
ParamArray keyValues As Object() _
) As TEntity
'用途
Dim instance As DbSet
Dim keyValues As Object()
Dim returnValue As TEntity
returnValue = instance.Find(keyValues)
public virtual TEntity Find(
params Object[] keyValues
)
public:
virtual TEntity Find(
... array<Object^>^ keyValues
)
abstract Find :
keyValues:Object[] -> 'TEntity
override Find :
keyValues:Object[] -> 'TEntity
public function Find(
... keyValues : Object[]
) : TEntity
參數
- keyValues
類型：System.Object[]
要尋找之實體的主索引鍵值。
傳回值
類型：TEntity
找到的實體或 null。
Implements
IDbSet<TEntity>.Find(Object[])
例外狀況
| 例外狀況 | 條件 |
|---|---|
| InvalidOperationException | 如果內容中存在多個具有給定主索引鍵值的實體，就會擲回。 |
| InvalidOperationException | 如果實體的類型不是此內容的資料模型的一部分，就會擲回。 |
| InvalidOperationException | 如果索引鍵值的類型不符合要找到之實體類型的索引鍵值類型，就會擲回。 |
| InvalidOperationException | 當內容已經過處置時擲回。 |
備註
EDM 中所定義的複合索引鍵值順序，接著此順序會在設計工具中由 Code First Fluent 應用程式開發介面或 DataMember 屬性所定義。