다음을 통해 공유

OleDbCommand.ExecuteScalar 메서드

  • 아티클

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

네임스페이스: System.Data.OleDb
어셈블리: System.Data(system.data.dll)

구문

‘선언
Public Overrides Function ExecuteScalar As Object
‘사용 방법
Dim instance As OleDbCommand
Dim returnValue As Object

returnValue = instance.ExecuteScalar

public override Object ExecuteScalar ()

public:
virtual Object^ ExecuteScalar () override

public Object ExecuteScalar ()

public override function ExecuteScalar () : Object

반환 값

결과 집합의 첫 행의 첫 열 또는 결과 집합이 비어있을 경우 null 참조입니다.

예외

예외 형식 조건

InvalidOperationException

연결이 원래 참여한 컨텍스트와 다른 트랜잭션 컨텍스트 내에서 명령을 실행할 수 없는 경우

설명

ExecuteScalar 메서드를 사용하여 데이터 소스에서 집계 값과 같은 단일 값을 검색합니다. 이렇게 하면 ExecuteReader 메서드를 사용한 후 OleDbDataReader가 반환한 데이터로부터 단일 값 생성 작업을 수행할 때보다 적은 수의 코드가 필요합니다.

일반적인 ExecuteScalar 쿼리의 서식은 다음 C# 예제처럼 지정될 수 있습니다.

CommandText = "SELECT COUNT(*) FROM region";
Int32 count = (int32) ExecuteScalar();

예제

다음 예제에서는 OleDbCommand을 만든 다음 ExecuteScalar를 사용하여 이를 실행합니다. 이 예제에서는 집계 결과를 반환하는 SQL 문인 문자열과 데이터 소스에 연결하는 데 사용할 문자열에 전달됩니다.

Public Sub CreateMyOleDbCommand(queryString As String, _
    connection As OleDbConnection)
    Dim command As New OleDbCommand(queryString, connection)
    command.Connection.Open()
    command.ExecuteScalar()
    connection.Close()
End Sub 

public void CreateMyOleDbCommand(string queryString, 
    OleDbConnection connection) 
{
    OleDbCommand command = new OleDbCommand(queryString, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
}

플랫폼

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

참고 항목

참조

OleDbCommand 클래스
OleDbCommand 멤버
System.Data.OleDb 네임스페이스

기타 리소스

명령 사용