Share via


DbRawSqlQuery<TElement>.SingleOrDefaultAsync 方法

[此頁面專屬於 Entity Framework 第 6 版。最新版本可從 'Entity Framework' NuGet 套件取得。如需 Entity Framework 的詳細資訊,請參閱 msdn.com/data/ef。]

非同步傳回序列的唯一一個項目,如果序列是空白,則為預設值,如果序列中有一個以上的項目,此方法就會擲回例外狀況。

命名空間:  System.Data.Entity.Infrastructure
組件:  EntityFramework (在 EntityFramework.dll 中)

語法

'宣告
Public Function SingleOrDefaultAsync As Task(Of TElement)
'用途
Dim instance As DbRawSqlQuery 
Dim returnValue As Task(Of TElement)

returnValue = instance.SingleOrDefaultAsync()
public Task<TElement> SingleOrDefaultAsync()
public:
Task<TElement>^ SingleOrDefaultAsync()
member SingleOrDefaultAsync : unit -> Task<'TElement> 
public function SingleOrDefaultAsync() : Task<TElement>

傳回值

類型:System.Threading.Tasks.Task<TElement>
表示非同步作業的工作。工作結果包含查詢結果的單一項目,如果序列沒有包含任何項目,則為 default (TElement)。

例外狀況

例外狀況 條件
InvalidOperationException

查詢結果有多個項目。

備註

不支援相同內容執行個體上的多個作用中作業。 使用 'await' 確保在此內容上呼叫另一個方法之前,所有非同步作業都已完成。

請參閱

參考

DbRawSqlQuery<TElement> 類別

SingleOrDefaultAsync 多載

System.Data.Entity.Infrastructure 命名空間