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 API、または DataMember 属性によって定義されています。