IDbCommand.ExecuteNonQuery Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет инструкцию SQL для объекта Connection
поставщика данных .NET и возвращает число задействованных строк.
public:
int ExecuteNonQuery();
public int ExecuteNonQuery ();
abstract member ExecuteNonQuery : unit -> int
Public Function ExecuteNonQuery () As Integer
Возвращаемое значение
Число обработанных строк.
Исключения
Примеры
В следующем примере создается экземпляр производного класса, OleDbCommandа затем выполняется. Для этого метод передает строку, которая является инструкцией SQL SELECT и строкой для подключения к источнику данных.
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.