OdbcCommand.ExecuteNonQuery 메서드

정의

Connection에 대해 SQL 문을 실행하고 영향을 받는 행의 수를 반환합니다.Executes an SQL statement against the Connection and returns the number of rows affected.

public:
 virtual int ExecuteNonQuery();
public int ExecuteNonQuery ();
override this.ExecuteNonQuery : unit -> int
Public Function ExecuteNonQuery () As Integer

반환

UPDATE, INSERT 및 DELETE 문의 경우, 반환 값은 해당 명령의 영향을 받는 행의 수입니다.For UPDATE, INSERT, and DELETE statements, the return value is the number of rows affected by the command. 다른 형식의 문의 경우에는 반환 값이 -1입니다.For all other types of statements, the return value is -1.

예외

연결이 존재하지 않습니다.The connection does not exist.

또는-or-

연결이 열려 있지 않습니다.The connection is not open.

설명

ExecuteNonQuery를 사용 하 여 카탈로그 작업을 수행할 수 있습니다. 예를 들어 데이터베이스 구조를 쿼리하거나 테이블과 같은 데이터베이스 개체를 만들 수 있습니다. 또는 UPDATE, INSERT 또는 DELETE 문을 실행 하 여 DataSet를 사용 하지 않고 데이터베이스의 데이터를 변경할 수 있습니다.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, without using a DataSet, by executing UPDATE, INSERT, or DELETE statements.

기본 ODBC 드라이버가이 기능을 지 원하는 경우 ExecuteNonQuery를 사용 하 여 여러 SQL 문을 실행할 수도 있습니다.You can also use ExecuteNonQuery to execute multiple SQL statements if the underlying ODBC driver supports this functionality. 이 경우 반환 값은 명령에 있는 모든 문의 영향을 받는 행 수입니다.In this case, the return value is the number of rows affected by all statements in the command.

ExecuteNonQuery에서 행을 반환 하지 않지만 매개 변수에 매핑된 출력 매개 변수 또는 반환 값이 데이터로 채워집니다.Although ExecuteNonQuery returns no rows, any output parameters or return values mapped to parameters are populated with data.

UPDATE, INSERT 및 DELETE 문의 경우, 반환 값은 해당 명령의 영향을 받는 행의 수입니다.For UPDATE, INSERT, and DELETE statements, the return value is the number of rows affected by the command. 다른 형식의 문의 경우에는 반환 값이 -1입니다.For all other types of statements, the return value is -1. 롤백이 발생 하면 반환 값도-1입니다.If a rollback occurs, the return value is also -1.

테이블에 트리거가 있고 테이블에서 데이터가 추가 되거나 변경 되는 경우 반환 값에는 insert 또는 update 작업의 영향을 받는 행 수와 트리거 또는 트리거의 영향을 받는 행 수가 포함 됩니다.When a trigger exists on a table and data is being added or changed in the table, the return value includes the number of rows affected by both the insert or update operation and the number of rows affected by the trigger or triggers.

적용 대상

추가 정보