IDbCommand.ExecuteNonQuery 메서드

정의

네임스페이스:
System.Data
어셈블리:
System.Data.dll
어셈블리:
netstandard.dll

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

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

반품

Int32

영향을 받는 행의 수입니다.

예외

InvalidOperationException

연결이 없습니다.

-또는-

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

예제

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

설명

카탈로그 작업(예: 데이터베이스 구조 쿼리 또는 테이블과 같은 데이터베이스 개체 만들기)을 수행하거나 UPDATE, INSERT 또는 DELETE 문을 실행하지 않고 DataSet 데이터베이스의 데이터를 변경할 수 ExecuteNonQuery 있습니다.

행은 ExecuteNonQuery 반환하지 않지만 매개 변수에 매핑된 출력 매개 변수 또는 반환 값은 데이터로 채워집니다.

UPDATE, INSERT 및 DELETE 문의 경우 반환 값은 명령의 영향을 받는 행 수입니다. 다른 모든 유형의 문의 경우 반환 값은 -1입니다.

적용 대상