IDbCommand.ExecuteNonQuery 方法

定义

命名空间:

System.Data

程序集:

System.Data.Common.dll

对 .NET 数据提供程序的 Connection 对象执行 SQL 语句，并返回受影响的行数。

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 执行目录操作 (例如，查询数据库的结构或创建数据库对象（如表) ），或者通过执行 UPDATE、INSERT 或 DELETE 语句在不使用 DataSet 的情况下更改数据库中的数据。

ExecuteNonQuery虽然 不会返回任何行，但映射到参数的任何输出参数或返回值都使用数据填充。

对于 UPDATE、INSERT 和 DELETE 语句，返回值为该命令所影响的行数。 对于其他所有类型的语句，返回值为 -1。