DbCommand.ExecuteScalar 메서드

정의

파생 클래스에서 재정의되는 경우 쿼리를 실행하고 쿼리에서 반환된 결과 집합의 첫 번째 행의 첫 번째 열을 반환합니다.When overridden in a derived class, executes the query and returns the first column of the first row in the result set returned by the query. 다른 모든 열과 행은 무시됩니다.All other columns and rows are ignored.

public:
 abstract System::Object ^ ExecuteScalar();
public abstract object ExecuteScalar ();
abstract member ExecuteScalar : unit -> obj
Public MustOverride Function ExecuteScalar () As Object

반환

결과 집합의 첫 번째 행의 첫 번째 열을 반환합니다.The first column of the first row in the result set.

구현

설명

ExecuteScalar 메서드를 사용 하 여 데이터베이스에서 단일 값 (예: 집계 값)을 검색 합니다.Use the ExecuteScalar method to retrieve a single value (for example, an aggregate value) from a database. 이렇게 하려면 ExecuteReader 메서드를 사용 하 고 DbDataReader에서 반환 된 데이터를 사용 하 여 단일 값을 생성 하는 데 필요한 작업을 수행 하는 것 보다 더 작은 코드가 필요 합니다.This requires less code than using the ExecuteReader method and performing the operations necessary to generate the single value using the data returned by a DbDataReader.

결과 집합에서 첫 번째 행의 첫 번째 열을 찾을 수 없는 경우 Visual Basic의Nothing null 참조가 반환 됩니다.If the first column of the first row in the result set is not found, a null reference (Nothing in Visual Basic) is returned. 데이터베이스의 값이 null경우 쿼리는 DBNull.Value반환 합니다.If the value in the database is null, the query returns DBNull.Value.

적용 대상

추가 정보