OracleCommand.ExecuteScalar Метод

Определение

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

public:
 virtual System::Object ^ ExecuteScalar();
public:
 override System::Object ^ ExecuteScalar();
public object ExecuteScalar ();
public override object ExecuteScalar ();
abstract member ExecuteScalar : unit -> obj
override this.ExecuteScalar : unit -> obj
override this.ExecuteScalar : unit -> obj
Public Function ExecuteScalar () As Object
Public Overrides Function ExecuteScalar () As 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();  

Применяется к

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