IDbCommand.ExecuteNonQuery Метод

Определение

Пространство имен:
System.Data
Сборки:
netstandard.dll, System.Data.Common.dll
Сборка:
System.Data.Common.dll
Сборка:
System.Data.dll
Сборка:
netstandard.dll
Исходный код:
IDbCommand.cs
Исходный код:
IDbCommand.cs
Исходный код:
NameNode.cs

Выполняет инструкцию SQL для объекта Connection поставщика данных .NET и возвращает количество затронутых строк.

public:
 int ExecuteNonQuery();
public int ExecuteNonQuery();
abstract member ExecuteNonQuery : unit -> int
Public Function ExecuteNonQuery () As Integer

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

Int32

Количество затронутых строк.

Исключения

InvalidOperationException

Подключение не существует.

–или–

Подключение не открыто.

Примеры

В следующем примере создается экземпляр производного класса, 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.

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