SqlClient.ExecuteScalar Method

SqlClient ExecuteScalar Method

Nemiro.Data.dll

Executes the query, and returns the first column of the first row in the result set returned by the query. Additional columns or rows are ignored. This method is used in conjunction with the properties CommandType, CommandText and Parameters.

Namespace: Nemiro.Data.Sql
Assembly: Nemiro.Data (in Nemiro.Data.dll) Version: 2.11.4.126 (2.11.4.126)

Syntax

C++

Copy to Clipboard Print

public Object ExecuteScalar()

public Object ExecuteScalar()

Public Function ExecuteScalar As Object

Public Function ExecuteScalar As Object

Return Value

Type: Object

The first column of the first row in the result set, or a null reference (Nothing in Visual Basic) if the result set is empty. Returns a maximum of 2033 characters.

Exceptions

Exception	Condition
SqlException	The exception that is thrown when SQL Server returns a warning or error.
ValueForIdentityException	An exception occurs if the property of primary key has not flag the Identity and field is autoincrement.
StringOrBinaryDataWouldBeTruncatedException	An exception occurs if some of the fields of the table are added values that exceed the allowable size of a table field.

Examples

C++

Copy to Clipboard Print

using (SqlClient client = new SqlClient())
{
  client.CommandText = "SELECT nickname FROM users WHERE id_users = @id_users";
  client.Parameters.Add("@id_users", SqlDbType.Int).Value = 1024;
  Console.WriteLine("User nickname: {0}", client.ExecuteScalar());
}

using (SqlClient client = new SqlClient())
{
  client.CommandText = "SELECT nickname FROM users WHERE id_users = @id_users";
  client.Parameters.Add("@id_users", SqlDbType.Int).Value = 1024;
  Console.WriteLine("User nickname: {0}", client.ExecuteScalar());
}

Using client As New SqlClient()
  client.CommandText = "SELECT nickname FROM users WHERE id_users = @id_users"
  client.Parameters.Add("@id_users", SqlDbType.Int).Value = 1024
  Console.WriteLine("User nickname: {0}", client.ExecuteScalar())
End Using

Using client As New SqlClient()
  client.CommandText = "SELECT nickname FROM users WHERE id_users = @id_users"
  client.Parameters.Add("@id_users", SqlDbType.Int).Value = 1024
  Console.WriteLine("User nickname: {0}", client.ExecuteScalar())
End Using