OleDbCommand.ExecuteNonQuery Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет оператор SQL применительно к свойству Connection и возвращает количество измененных командой строк.
public:
override int ExecuteNonQuery();public:
virtual int ExecuteNonQuery();public override int ExecuteNonQuery ();public int ExecuteNonQuery ();override this.ExecuteNonQuery : unit -> intabstract member ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> intPublic Overrides Function ExecuteNonQuery () As IntegerPublic Function ExecuteNonQuery () As IntegerВозвращаемое значение
Число обработанных строк.
Реализации
Исключения
Подключение не существует.
-или-
Подключение не открыто.
-или-
Не удается выполнить команду в контексте транзакции, отличающемся от контекста, в котором подключение было изначально зарегистрировано.
Примеры
В следующем примере создается OleDbCommand , а затем выполняется с помощью ExecuteNonQuery. В этом примере передается строка, которая является инструкцией SQL, такой как UPDATE, INSERT или DELETE, и строка, используемая для подключения к источнику данных.
static private void CreateOleDbCommand(
string queryString, string connectionString)
{
using (OleDbConnection connection = new
OleDbConnection(connectionString))
{
connection.Open();
OleDbCommand command = new
OleDbCommand(queryString, connection);
command.ExecuteNonQuery();
}
}
Private Sub CreateOleDbCommand( _
ByVal queryString As String, ByVal connectionString As String)
Using connection As New OleDbConnection(connectionString)
connection.Open()
Dim command As New OleDbCommand(queryString, connection)
command.ExecuteNonQuery()
End Using
End Sub
Комментарии
Можно использовать ExecuteNonQuery для выполнения операций с каталогом, например для запроса структуры базы данных или создания объектов базы данных, таких как таблицы, или для изменения данных в базе данных без использования DataSet путем выполнения инструкций UPDATE, INSERT или DELETE.
Хотя не ExecuteNonQuery возвращает строк, все выходные параметры или возвращаемые значения, сопоставленные с параметрами, заполняются данными.
Операторы UPDATE, INSERT и DELETE возвращают количество строк, которые были обработаны с их помощью. Для всех прочих типов операторов возвращаемым значением является -1. Если происходит откат, возвращаемое значение также равно -1.
