OracleCommand.ExecuteScalar Метод

Определение

Пространство имен:

System.Data.OracleClient

Сборка:

System.Data.OracleClient.dll

Выполняет запрос и возвращает первый столбец первой строки в наборе результатов, возвращаемых запросом в виде типа данных .NET. Дополнительные столбцы или строки не обрабатываются.

public:
 override System::Object ^ ExecuteScalar();

public override object ExecuteScalar ();

override this.ExecuteScalar : unit -> obj

Public Overrides Function ExecuteScalar () As Object

Возвращаемое значение

Object

Если набор результатов пуст или результатом является REF CURSOR, первый столбец первой строки в наборе результатов имеет тип данных .NET или является пустой ссылкой.

Примеры

В следующем примере создается OracleCommand , а затем выполняется с помощью ExecuteScalar. В этом примере передается строка, которая является инструкцией SQL, которая возвращает статистический результат, и строка, используемая для подключения к базе данных.

public void CreateOracleCommand(string myScalarQuery, OracleConnection connection)
 {
    OracleCommand command = new OracleCommand(myScalarQuery, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
 }

Public Sub CreateOracleCommand(myScalarQuery As String, connection As OracleConnection)
    Dim command As New OracleCommand(myScalarQuery, connection)
    command.Connection.Open()
    command.ExecuteScalar()
    connection.Close()
End Sub

Комментарии

Используйте метод для ExecuteScalar получения одного значения (например, статистического) из базы данных. Для этого требуется меньше кода, чем при использовании ExecuteReader метода , а затем выполнять операции, необходимые для создания одного значения из данных, возвращаемых OracleDataReader.

Типичный ExecuteScalar запрос можно отформатировать, как показано в следующем примере C#:

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

См. также раздел

• Работа с командами