SqlCeCommand.ExecuteScalar Method

Ejecuta la consulta y devuelve la primera columna de la primera fila del conjunto de resultados devueltos por la consulta. Las demás columnas o filas no se tienen en cuenta.

Espacio de nombres: System.Data.SqlServerCe
Ensamblado: System.Data.SqlServerCe (en system.data.sqlserverce.dll)

Sintaxis

'Declaración
Public Overrides Function ExecuteScalar As Object

public override Object ExecuteScalar ()

public:
virtual Object^ ExecuteScalar () override

public Object ExecuteScalar ()

public override function ExecuteScalar () : Object

Valor devuelto

Primera columna de la primera fila del conjunto de resultados.

Excepciones

Tipo de excepción	Condición
InvalidOperationException	No se puede ejecutar un comando en un contexto de transacción distinto al contexto en que se dio de alta la conexión originalmente.

Notas

Utilice el método ExecuteScalar para recuperar un único valor (por ejemplo, un valor agregado) de un origen de datos. Este método requiere menos código que el método ExecuteReader y, a continuación, pueden realizarse las operaciones necesarias para generar un único valor mediante los datos devueltos por SqlCeDataReader.

Ejemplo

En el siguiente ejemplo se crea un objeto SqlCeCommand y, a continuación, se ejecuta mediante ExecuteScalar. En el ejemplo se pasa una cadena que es una instrucción SQL que devuelve un resultado agregado y se pasa una cadena para conectarse al origen de datos.

Dim cmd As New SqlCeCommand("SELECT col1 FROM myTable", conn)
cmd.Connection.Open()
Dim value As Object = cmd.ExecuteScalar()
conn.Close()

SqlCeCommand cmd = new SqlCeCommand("SELECT col1 FROM myTable", conn);
cmd.Connection.Open();
object value = cmd.ExecuteScalar();
conn.Close();

Seguridad para subprocesos

Todos los miembros (Compartidos en Microsoft Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Plataformas

Plataformas de desarrollo

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Información de la versión
.NET Framework y NET Compact Framework
Se admite en 3.5
.NET Framework
Se admite en 3.0
.NET Compact Framework y .Net Framework
Se admite en 2.0

Vea también

Referencia

SqlCeCommand Class
SqlCeCommand Members
System.Data.SqlServerCe Namespace