DbSet.FindAsync - метод (Object[])

Статья
12/18/2014

[Эта страница относится к документации к Entity Framework 6. Последняя версия доступна в составе пакета Entity Framework NuGet. Дополнительные сведения об Entity Framework см. в разделе msdn.com/data/ef.]

Асинхронно находит сущность с указанными значениями первичного ключа. Если сущность с указанными значениями первичного ключа содержится в контексте, она возвращается немедленно без выполнения запроса к хранилищу. В противном случае выполняется запрос к хранилищу в поисках сущности с указанными значениями первичного ключа. Если такая сущность обнаружена, она добавляется к контексту и возвращается вызывающей стороне. Если сущность не обнаружена в контексте или в хранилище, возвращается значение NULL.

Пространство имен: System.Data.Entity
Сборка: EntityFramework (в EntityFramework.dll)

Синтаксис

'Декларация
Public Overridable Function FindAsync ( _
    ParamArray keyValues As Object() _
) As Task(Of Object)
'Применение
Dim instance As DbSet 
Dim keyValues As Object()
Dim returnValue As Task(Of Object)

returnValue = instance.FindAsync(keyValues)

public virtual Task<Object> FindAsync(
    params Object[] keyValues
)

public:
virtual Task<Object^>^ FindAsync(
    ... array<Object^>^ keyValues
)

abstract FindAsync : 
        keyValues:Object[] -> Task<Object> 
override FindAsync : 
        keyValues:Object[] -> Task<Object>

public function FindAsync(
    ... keyValues : Object[]
) : Task<Object>

Параметры

keyValues
Тип: System.Object[]
Значения первичного ключа для искомой сущности.

Возвращаемое значение

Тип: System.Threading.Tasks.Task<Object>
Задача, представляющая асинхронную операцию поиска.Результат задачи содержит найденную сущность или значение NULL.

Исключения

Исключение	Условие
InvalidOperationException	Возникает, если с данными значениями первичного ключа в контексте есть несколько сущностей.
InvalidOperationException	Возникает, если тип сущности не является частью модели данных для этого контекста.
InvalidOperationException	Возникает, если типы значений ключа не совпадают с типами значений ключа для типа сущности, который нужно найти.
InvalidOperationException	Формируется, если контекст был удален.

Примечания

Порядок значений составного ключа соответствует порядку, определенному в модели EDM, который в свою очередь соответствует порядку, определенному в конструкторе с помощью быстрого API-интерфейса Code First или с помощью атрибута DataMember. Несколько активных операций в одном экземпляре контекста не поддерживается. Используйте «await» для обеспечения того, чтобы все асинхронные операции завершались перед вызовом другого метода применительно к этому контексту.

См. также

Справочник

DbSet Класс

FindAsync - перегрузка

System.Data.Entity - пространство имен

Поделиться через