Метод SqlCeCommand.ExecuteScalar
Выполняет запрос и возвращает из результирующего набора первый столбец первой строки. Дополнительные столбцы или строки не возвращаются.
Пространство имен: System.Data.SqlServerCe
Сборка: System.Data.SqlServerCe (в System.Data.SqlServerCe.dll)
Синтаксис
'Декларация
Public Overrides Function ExecuteScalar As Object
'Применение
Dim instance As SqlCeCommand
Dim returnValue As Object
returnValue = instance.ExecuteScalar()
public override Object ExecuteScalar()
public:
virtual Object^ ExecuteScalar() override
abstract ExecuteScalar : unit -> Object
override ExecuteScalar : unit -> Object
public override function ExecuteScalar() : Object
Возвращаемое значение
Тип: System.Object
Первый столбец первой строки результирующего набора.
Реализует
Исключения
| Исключение | Условие |
|---|---|
| InvalidOperationException | Не удается выполнить команду в контексте транзакции, который отличается от контекста, в котором первоначально было прикреплено соединение. |
Замечания
Метод ExecuteScalar предназначен для выборки из источника данных единичного значения (например полученного в результате статистической обработки). Он требует меньшего объема кодирования, чем метод ExecuteReader, и выполняет все операции, необходимые для создания единичного значения из данных, возвращенных объектом SqlCeDataReader.
Примеры
В следующем примере создается объект SqlCeCommand, а затем выполняется команда вызовом метода ExecuteScalar. В следующем примере передается инструкция SQL, которая возвращает результат, полученный в результате статистической обработки, и строку для соединения с источником данных.
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();