SqlCeCommand.ExecuteScalar Method

Статья
01/14/2011

Выполняет запрос и возвращает из результирующего набора первый столбец первой строки. Дополнительные столбцы или строки не возвращаются.

Пространство имен: System.Data.SqlServerCe
Сборка: System.Data.SqlServerCe (в system.data.sqlserverce.dll)

Синтаксис

'Декларация
Public Overrides Function ExecuteScalar As Object

public override Object ExecuteScalar ()

public:
virtual Object^ ExecuteScalar () override

public Object ExecuteScalar ()

public override function ExecuteScalar () : 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();

Многопоточное использование

Все общие статические члены (Shared в Microsoft Visual Basic) этого типа можно использовать в многопоточных операциях. Безопасная многопоточная работа с членами экземпляров типа не гарантируется.

Платформы

Платформы разработки

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
Сведения о версии
.NET Framework и NET Compact Framework
Поддерживается в версии 3.5
.NET Framework
Поддерживается в версии 3.0
.NET Compact Framework и .Net Framework
Поддерживается в версии 2.0

См. также

Справочник

SqlCeCommand Class
SqlCeCommand Members
System.Data.SqlServerCe Namespace

Поделиться через