IDbCommand.ExecuteNonQuery IDbCommand.ExecuteNonQuery IDbCommand.ExecuteNonQuery IDbCommand.ExecuteNonQuery Method

정의

.NET Framework 데이터 공급자의 Connection 개체에 대해 SQL 문을 실행하고 영향을 받는 행 수를 반환합니다.Executes an SQL statement against the Connection object of a .NET Framework data provider, and returns the number of rows affected.

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

반환

영향을 받은 행 수입니다.The number of rows affected.

예외

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

또는-or-

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

예제

다음 예제에서는 파생된 클래스의 인스턴스를 만들고 OleDbCommand, 다음 실행 합니다.The following example creates an instance of the derived class, OleDbCommand, and then executes it. 이를 위해 SQL SELECT 문 문자열과 데이터 원본에 연결 하는 데 문자열 메서드에 전달 됩니다.To accomplish this, the method is passed a string that is a SQL SELECT statement and a string to use to connect to the data source.

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를 실행 하 여 문입니다.You can use the 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.

하지만 ExecuteNonQuery 행을 출력 매개 변수를 반환 하지 않거나 데이터로 채워진 매개 변수에 매핑된 값을 반환 합니다.Although the ExecuteNonQuery does not return any 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.

적용 대상