SqlCeCommand.ExecuteScalar Method

쿼리를 실행하고 쿼리에서 반환된 결과 집합의 첫 번째 행의 첫 번째 열을 반환합니다. 추가 열이나 행은 무시됩니다.

네임스페이스: 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

반환 값

결과 집합의 첫 번째 행의 첫 번째 열을 반환합니다.

예외

주의

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();

스레드 보안

이 유형의 모든 public static(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