Share via


IRelationalCommand.ExecuteScalarAsync Method

Definition

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

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