IDbCommand 인터페이스

정의

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

데이터 원본에 연결된 동안 실행되고 관계형 데이터베이스에 액세스하는 .NET 데이터 공급자가 구현하는 SQL 문을 나타냅니다.

public interface class IDbCommand : IDisposable
public interface IDbCommand : IDisposable
type IDbCommand = interface
    interface IDisposable
Public Interface IDbCommand
Implements IDisposable
파생
구현
IDisposable

예제

다음 예제에서는 파생 클래스의 인스턴스를 만듭니다. SqlConnectionSqlCommandSqlDataReader 이 예제에서는 데이터를 읽고 콘솔에 읽습니다. 마지막으로, 이 예제에서는 다음SqlConnection을 SqlDataReader닫습니다.

private static void ReadOrderData(string connectionString)
{
    string queryString =
        "SELECT OrderID, CustomerID FROM dbo.Orders;";
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand(
            queryString, connection);
        connection.Open();
        using(SqlDataReader reader = command.ExecuteReader())
        {
            while (reader.Read())
            {
                Console.WriteLine(String.Format("{0}, {1}",
                    reader[0], reader[1]));
            }
        }
    }
}

Public Sub ReadOrderData(ByVal connectionString As String)
    Dim queryString As String = _
        "SELECT OrderID, CustomerID FROM dbo.Orders;"
    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)
        connection.Open()
        Dim reader As SqlDataReader = command.ExecuteReader()
        Try
            While reader.Read()
                Console.WriteLine(String.Format("{0}, {1}", _
                    reader(0), reader(1)))
            End While
        Finally
            ' Always call Close when done reading.
            reader.Close()
        End Try
    End Using
End Sub

설명

이 IDbCommand 인터페이스를 사용하면 상속 클래스가 데이터 원본에서 실행되는 SQL 문을 나타내는 Command 클래스를 구현할 수 있습니다. 명령 클래스에 대한 자세한 내용은 명령 실행을 참조하세요.

애플리케이션은 인터페이스의 IDbCommand 인스턴스를 직접 만들지 않지만 인터페이스를 구현하는 클래스의 인스턴스를 IDbCommand 만듭니다.

구현 IDbCommand 하는 클래스는 모든 멤버를 구현해야 하며, 일반적으로 공급자별 기능을 추가하기 위해 추가 멤버를 정의해야 합니다. 예를 들어 인터페이스는 IDbCommand 메서드를 ExecuteNonQuery 정의합니다. 이 클래스는 SqlCommand 이 메서드를 상속하고 메서드도 정의합니다 ExecuteXmlReader .

구현자 참고

.NET Framework 데이터 공급자 간의 일관성을 높이기 위해 특정 .NET Framework 데이터 공급자 네임스페이 PrvClassname 스의 모든 클래스에 지정된 균일한 접두사인 형식 Prv 의 상속 클래스 이름을 지정합니다. 예를 들어 네 Sql 임스페이스에 있는 클래스의 SqlCommand 접두사입니다 System.Data.SqlClient .

인터페이스에서 상속하는 IDbCommand 경우 다음 생성자를 구현해야 합니다.

항목 설명
PrvCommand() PrvCommand 클래스의 새 인스턴스를 초기화합니다.
PrvCommand(string cmdText) 쿼리 텍스트를 사용하여 PrvCommand 클래스의 새 인스턴스를 초기화합니다.
PrvCommand(string cmdText, PrvConnection connection) 쿼리 텍스트와 PrvConnection을 사용하여 PrvCommand 클래스의 새 인스턴스를 초기화합니다.
PrvCommand(string cmdText, PrvConnection connection, PrvTransaction transaction) 쿼리의 텍스트, PrvConnection 및 PrvTransaction을 사용하여 PrvCommand 클래스의 새 인스턴스를 초기화합니다.

속성

Name Description
CommandText

데이터 원본에 대해 실행할 텍스트 명령을 가져오거나 설정합니다.
CommandTimeout

명령 실행 시도를 종료하고 오류를 생성하기 전에 대기 시간(초)을 가져오거나 설정합니다.
CommandType

속성이 해석되는 방법을 CommandText 나타내거나 지정합니다.
Connection

의 이 인스턴스IDbConnection에서 IDbCommand 사용되는 값을 가져오거나 설정합니다.
Parameters

IDataParameterCollection를 가져옵니다.
Transaction

.NET 데이터 공급자의 Command 개체가 실행되는 트랜잭션을 가져오거나 설정합니다.
UpdatedRowSource

의 메서드DbDataAdapter에서 사용할 Update(DataSet) 때 명령 결과가 적용되는 DataRow 방법을 가져오거나 설정합니다.

메서드

Name Description
Cancel()

의 실행을 IDbCommand취소하려고 시도합니다.
CreateParameter()

개체의 새 인스턴스를 IDbDataParameter 만듭니다.
Dispose()

관리되지 않는 리소스의 해제, 해제 또는 재설정과 관련된 애플리케이션 정의 작업을 수행합니다.

(다음에서 상속됨 IDisposable)
ExecuteNonQuery()

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

에 대해 CommandText 실행 Connection 하 고 빌드 합니다IDataReader.
ExecuteReader(CommandBehavior)

에 CommandText 대해 Connection실행하고 값 중 IDataReader 하나를 사용하여 빌드합니다CommandBehavior.
ExecuteScalar()

쿼리를 실행하고 쿼리에서 반환된 결과 집합에서 첫 번째 행의 첫 번째 열을 반환합니다. 추가 열 또는 행은 무시됩니다.
Prepare()

데이터 원본에 준비된(또는 컴파일된) 버전의 명령을 만듭니다.

적용 대상

추가 정보