다음을 통해 공유


IDbCommand.ExecuteNonQuery 메서드

정의

.NET 데이터 공급자의 Connection 개체에 대해 SQL 문을 실행하고 영향을 받는 행 수를 반환합니다.

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

반환

영향을 받은 행 수입니다.

예외

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

또는

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

예제

다음 예제에서는 파생 클래스OleDbCommand의 instance 만든 다음 실행합니다. 이를 위해 메서드는 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입니다.

적용 대상