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, который в свою очередь соответствует порядку, определенному в конструкторе с помощью быстрого API-интерфейса Code First или с помощью атрибута DataMember.