Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

DbCommand.ExecuteNonQuery Method

Definition

Namespace:
System.Data.Common
Assembly:
System.Data.Common.dll
Assemblies:
netstandard.dll, System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll
Source:
DbCommand.cs
Source:
DbCommand.cs
Source:
DbCommand.cs
Source:
DbCommand.cs
Source:
DbCommand.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Executes the command against its connection object, returning the number of rows affected.

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

Returns

The number of rows affected.

Implements

Remarks

You can use ExecuteNonQuery to perform catalog operations (for example, querying the structure of a database or creating database objects such as tables), or to change the data in a database by executing UPDATE, INSERT, or DELETE statements.

Although ExecuteNonQuery does not return any rows, any output parameters or return values mapped to parameters are populated with data.

For UPDATE, INSERT, and DELETE statements, the return value is the number of rows affected by the command. For all other types of statements, the return value is -1.

Applies to

See also


Feedback

Was this page helpful?