IRelationalCommand.ExecuteScalarAsync Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
| ExecuteScalarAsync(RelationalCommandParameterObject, CancellationToken) |
Asynchronously executes the command with a single scalar result. |
| ExecuteScalarAsync(IRelationalConnection, IReadOnlyDictionary<String,Object>, CancellationToken) |
Asynchronously executes the command with a single scalar result. |
| ExecuteScalarAsync(IRelationalConnection, IReadOnlyDictionary<String,Object>, Boolean, CancellationToken) |
Obsolete.
Asynchronously executes the command with a single scalar result. |
ExecuteScalarAsync(RelationalCommandParameterObject, CancellationToken)
Asynchronously executes the command with a single scalar result.
public System.Threading.Tasks.Task<object> ExecuteScalarAsync (Microsoft.EntityFrameworkCore.Storage.RelationalCommandParameterObject parameterObject, System.Threading.CancellationToken cancellationToken = default);public System.Threading.Tasks.Task<object?> ExecuteScalarAsync (Microsoft.EntityFrameworkCore.Storage.RelationalCommandParameterObject parameterObject, System.Threading.CancellationToken cancellationToken = default);abstract member ExecuteScalarAsync : Microsoft.EntityFrameworkCore.Storage.RelationalCommandParameterObject * System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>Public Function ExecuteScalarAsync (parameterObject As RelationalCommandParameterObject, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Object)Parameters
- parameterObject
- RelationalCommandParameterObject
Parameters for this method.
- cancellationToken
- CancellationToken
A CancellationToken to observe while waiting for the task to complete.
Returns
A task that represents the asynchronous operation. The task result contains the result of the command.
Exceptions
If the CancellationToken is canceled.
Applies to
ExecuteScalarAsync(IRelationalConnection, IReadOnlyDictionary<String,Object>, CancellationToken)
Asynchronously executes the command with a single scalar result.
public System.Threading.Tasks.Task<object> ExecuteScalarAsync (Microsoft.EntityFrameworkCore.Storage.IRelationalConnection connection, System.Collections.Generic.IReadOnlyDictionary<string,object> parameterValues, System.Threading.CancellationToken cancellationToken = default);abstract member ExecuteScalarAsync : Microsoft.EntityFrameworkCore.Storage.IRelationalConnection * System.Collections.Generic.IReadOnlyDictionary<string, obj> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>Public Function ExecuteScalarAsync (connection As IRelationalConnection, parameterValues As IReadOnlyDictionary(Of String, Object), Optional cancellationToken As CancellationToken = Nothing) As Task(Of Object)Parameters
- connection
- IRelationalConnection
The connection to execute against.
- parameterValues
- IReadOnlyDictionary<String,Object>
The values for the parameters.
- cancellationToken
- CancellationToken
A CancellationToken to observe while waiting for the task to complete.
Returns
A task that represents the asynchronous operation. The task result contains the result of the command.
Applies to
ExecuteScalarAsync(IRelationalConnection, IReadOnlyDictionary<String,Object>, Boolean, CancellationToken)
Caution
Use overload without 'manageConnection' parameter
Asynchronously executes the command with a single scalar result.
public System.Threading.Tasks.Task<object> ExecuteScalarAsync (Microsoft.EntityFrameworkCore.Storage.IRelationalConnection connection, System.Collections.Generic.IReadOnlyDictionary<string,object> parameterValues = default, bool manageConnection = true, System.Threading.CancellationToken cancellationToken = default);[System.Obsolete("Use overload without 'manageConnection' parameter")]
public System.Threading.Tasks.Task<object> ExecuteScalarAsync (Microsoft.EntityFrameworkCore.Storage.IRelationalConnection connection, System.Collections.Generic.IReadOnlyDictionary<string,object> parameterValues, bool manageConnection, System.Threading.CancellationToken cancellationToken = default);abstract member ExecuteScalarAsync : Microsoft.EntityFrameworkCore.Storage.IRelationalConnection * System.Collections.Generic.IReadOnlyDictionary<string, obj> * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>[<System.Obsolete("Use overload without 'manageConnection' parameter")>]
abstract member ExecuteScalarAsync : Microsoft.EntityFrameworkCore.Storage.IRelationalConnection * System.Collections.Generic.IReadOnlyDictionary<string, obj> * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>Public Function ExecuteScalarAsync (connection As IRelationalConnection, Optional parameterValues As IReadOnlyDictionary(Of String, Object) = Nothing, Optional manageConnection As Boolean = true, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Object)Public Function ExecuteScalarAsync (connection As IRelationalConnection, parameterValues As IReadOnlyDictionary(Of String, Object), manageConnection As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Object)Parameters
- connection
- IRelationalConnection
The connection to execute against.
- parameterValues
- IReadOnlyDictionary<String,Object>
The values for the parameters.
- manageConnection
- Boolean
A value indicating whether to open and close the connection as needed.
- cancellationToken
- CancellationToken
A CancellationToken to observe while waiting for the task to complete.
Returns
A task that represents the asynchronous operation. The task result contains the result of the command.
- Attributes
Applies to
Entity Framework