다음을 통해 공유


OleDbCommand.ExecuteScalar 메서드

정의

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

public:
 override System::Object ^ ExecuteScalar();
public:
 virtual System::Object ^ ExecuteScalar();
public override object? ExecuteScalar ();
public object ExecuteScalar ();
public override object ExecuteScalar ();
override this.ExecuteScalar : unit -> obj
abstract member ExecuteScalar : unit -> obj
override this.ExecuteScalar : unit -> obj
Public Overrides Function ExecuteScalar () As Object
Public Function ExecuteScalar () As Object

반환

결과 집합에서 첫 번째 행의 첫 번째 열이거나 결과 집합이 비어 있는 경우 Null 참조입니다.

구현

예외

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

예제

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

public void CreateMyOleDbCommand(string queryString,
    OleDbConnection connection)
{
    OleDbCommand command = new OleDbCommand(queryString, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
}
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

설명

메서드를 ExecuteScalar 사용하여 데이터 원본에서 단일 값(예: 집계 값)을 검색합니다. 이렇게 하려면 메서드를 사용한 ExecuteReader 다음 에서 반환된 데이터를 사용하여 단일 값을 생성하는 데 필요한 작업을 수행하는 것보다 적은 코드가 OleDbDataReader필요합니다.

일반적인 ExecuteScalar 쿼리는 다음 C# 예제와 같이 형식을 지정할 수 있습니다.

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

적용 대상

추가 정보