다음을 통해 공유


OleDbCommand.ExecuteNonQuery 메서드

정의

Connection에 대해 SQL 문을 실행하고 영향을 받는 행의 수를 반환합니다.

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

반환

영향을 받은 행 수입니다.

구현

예외

연결이 존재하지 않습니다.

또는

연결이 열려 있지 않습니다.

또는

연결이 원래 참여한 컨텍스트와 다른 트랜잭션 컨텍스트 내에서 명령을 실행할 수 없는 경우

예제

다음 예제에서는 를 만든 OleDbCommand 다음 를 사용하여 ExecuteNonQuery실행합니다. 이 예제에서는 UPDATE, INSERT 또는 DELETE와 같은 SQL 문인 문자열과 데이터 원본에 연결하는 데 사용할 문자열을 전달합니다.

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입니다. 롤백이 발생하면 반환 값도 -1입니다.

적용 대상

추가 정보