IDbCommand.ExecuteScalar 메서드

정의

네임스페이스:
System.Data
어셈블리:
System.Data.dll
어셈블리:
netstandard.dll

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

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

반품

Object

결과 집합에서 첫 번째 행의 첫 번째 열입니다.

예제

다음 예제에서는 파생 클래스의 인스턴스를 만든 다음 , SqlCommand를 사용하여 ExecuteScalar실행합니다. 이 예제는 집계 결과를 반환하는 Transact-SQL 문인 문자열과 데이터 원본에 연결하는 데 사용할 문자열을 전달합니다.

public void CreateSqlCommand(
    string queryString, SqlConnection connection)
{
    SqlCommand command = new
        SqlCommand(queryString, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
}

Public Sub CreateSqlCommand( _
    queryString As String, connection As SqlConnection)

    Dim command As New SqlCommand(queryString, connection)
    command.Connection.Open()
    command.ExecuteScalar()
    connection.Close()
End Sub

설명

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

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

CommandText = "select count(*) as NumberOfRegions from region";
Int32 count = (int) ExecuteScalar();

결과 집합에서 첫 번째 행의 첫 번째 열을 찾을 수 없으면 null 참조(Visual Basic Nothing)가 반환됩니다. 데이터베이스의 값이 null면 쿼리가 반환됩니다 DBNull.Value.

적용 대상