OdbcCommand 클래스

정의

네임스페이스:

System.Data.Odbc

어셈블리:

System.Data.Odbc.dll

패키지:

System.Data.Odbc v9.0.0-rc.1.24431.7

Source:

OdbcCommand.cs

데이터 원본에 대해 실행할 SQL 문 또는 저장 프로시저를 나타냅니다. 이 클래스는 상속할 수 없습니다.

public ref class OdbcCommand sealed : System::Data::Common::DbCommand, ICloneable

public sealed class OdbcCommand : System.Data.Common.DbCommand, ICloneable

type OdbcCommand = class
    inherit DbCommand
    interface ICloneable

Public NotInheritable Class OdbcCommand
Inherits DbCommand
Implements ICloneable

상속

Object

MarshalByRefObject

Component

DbCommand

OdbcCommand

구현

ICloneable

예제

다음 예제에서는 ExecuteNonQuery사용합니다.

public void InsertRow(string connectionString, string insertSQL)
{
    using (OdbcConnection connection =
               new OdbcConnection(connectionString))
    {
        // The insertSQL string contains a SQL statement that
        // inserts a new row in the source table.
        OdbcCommand command = new OdbcCommand(insertSQL, connection);

        // Open the connection and execute the insert command.
        try
        {
            connection.Open();
            command.ExecuteNonQuery();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }

Public Sub InsertRow(ByVal connectionString As String, _
    ByVal insertSQL As String)

    Using connection As New OdbcConnection(connectionString)
        ' The insertSQL string contains a SQL statement that
        ' inserts a new row in the source table.
        Dim command As New OdbcCommand(insertSQL, connection)

        ' Open the connection and execute the insert command.
        Try
            connection.Open()
            command.ExecuteNonQuery()
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using
End Sub

설명

OdbcCommand 클래스는 데이터 원본에 대해 명령을 실행하기 위한 다음 메서드를 제공합니다.

항목	묘사
ExecuteReader	행을 반환하는 명령을 실행합니다.
ExecuteNonQuery	SQL INSERT, DELETE, UPDATE 및 SET 문과 같은 명령을 실행합니다.
ExecuteScalar	데이터베이스에서 단일 값(예: 집계 값)을 검색합니다.

CommandText 속성을 재설정하고 OdbcCommand 개체를 다시 사용할 수 있습니다. 그러나 새 명령이나 이전 명령을 실행하려면 먼저 OdbcDataReader 닫아야 합니다.

명령을 실행하면 SQL Server 심각도 수준 20 이상과 같은 치명적인 OdbcException 발생할 경우 OdbcConnection 닫을 수 있습니다. 그러나 사용자는 연결을 다시 열고 계속할 수 있습니다.

생성자

OdbcCommand()	OdbcCommand 클래스의 새 인스턴스를 초기화합니다.
OdbcCommand(String)	쿼리 텍스트를 사용하여 OdbcCommand 클래스의 새 인스턴스를 초기화합니다.
OdbcCommand(String, OdbcConnection)	쿼리 텍스트와 OdbcConnection 개체를 사용하여 OdbcCommand 클래스의 새 인스턴스를 초기화합니다.
OdbcCommand(String, OdbcConnection, OdbcTransaction)	쿼리의 텍스트, OdbcConnection 개체 및 Transaction사용하여 OdbcCommand 클래스의 새 인스턴스를 초기화합니다.

속성

CanRaiseEvents	구성 요소가 이벤트를 발생시키는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 Component)
CommandText	데이터 원본에 대해 실행할 SQL 문 또는 저장 프로시저를 가져오거나 설정합니다.
CommandTimeout	명령 실행 시도를 종료하고 오류를 생성하기 전에 대기 시간(초)을 가져오거나 설정합니다.
CommandType	CommandText 속성이 해석되는 방식을 나타내는 값을 가져오거나 설정합니다.
Connection	이 OdbcCommand인스턴스에서 사용하는 OdbcConnection 가져오거나 설정합니다.
Container	Component포함하는 IContainer 가져옵니다. (다음에서 상속됨 Component)
DbConnection	이 DbCommand사용되는 DbConnection 가져오거나 설정합니다. (다음에서 상속됨 DbCommand)
DbParameterCollection	DbParameter 개체의 컬렉션을 가져옵니다. (다음에서 상속됨 DbCommand)
DbTransaction	이 DbCommand 개체가 실행되는 DbTransaction 가져오거나 설정합니다. (다음에서 상속됨 DbCommand)
DesignMode	Component 현재 디자인 모드인지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 Component)
DesignTimeVisible	명령 개체가 사용자 지정된 인터페이스 컨트롤에 표시되어야 하는지 여부를 나타내는 값을 가져오거나 설정합니다.
Events	이 Component연결된 이벤트 처리기 목록을 가져옵니다. (다음에서 상속됨 Component)
Parameters	OdbcParameterCollection가져옵니다.
Site	Component ISite 가져오거나 설정합니다. (다음에서 상속됨 Component)
Transaction	OdbcCommand 실행되는 OdbcTransaction 가져오거나 설정합니다.
UpdatedRowSource	Update 메서드가 DataRow명령 결과를 적용하는 방법을 지정하는 값을 가져오거나 설정합니다.

메서드

Cancel()	OdbcCommand실행을 취소하려고 합니다.
CreateDbParameter()	DbParameter 개체의 새 인스턴스를 만듭니다. (다음에서 상속됨 DbCommand)
CreateObjRef(Type)	원격 개체와 통신하는 데 사용되는 프록시를 생성하는 데 필요한 모든 관련 정보를 포함하는 개체를 만듭니다. (다음에서 상속됨 MarshalByRefObject)
CreateParameter()	OdbcParameter 개체의 새 인스턴스를 만듭니다.
Dispose()	관리되지 않는 리소스의 해제, 해제 또는 재설정과 관련된 애플리케이션 정의 작업을 수행합니다. (다음에서 상속됨 DbCommand)
Dispose(Boolean)	DbCommand 사용하는 관리되지 않는 리소스를 해제하고 필요에 따라 관리되는 리소스를 해제합니다. (다음에서 상속됨 DbCommand)
DisposeAsync()	명령 개체를 비동기적으로 디포즈합니다. (다음에서 상속됨 DbCommand)
Equals(Object)	지정된 개체가 현재 개체와 같은지 여부를 확인합니다. (다음에서 상속됨 Object)
ExecuteDbDataReader(CommandBehavior)	연결에 대해 명령을 실행하여 결과에 액세스하는 데 사용할 수 있는 DbDataReader 반환합니다. (다음에서 상속됨 DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	공급자는 ExecuteReader 오버로드에 대한 기본이 아닌 구현을 제공하려면 이 메서드를 구현해야 합니다. 기본 구현은 동기 ExecuteReader() 메서드를 호출하고 완료된 작업을 반환하여 호출 스레드를 차단합니다. 이미 취소된 취소 토큰을 전달한 경우 기본 구현은 취소된 작업을 반환합니다. ExecuteReader에서 throw된 예외는 반환된 작업 예외 속성을 통해 전달됩니다. 이 메서드는 작업을 일찍 취소하도록 요청하는 데 사용할 수 있는 취소 토큰을 허용합니다. 구현에서는 이 요청을 무시할 수 있습니다. (다음에서 상속됨 DbCommand)
ExecuteNonQuery()	Connection 대해 SQL 문을 실행하고 영향을 받는 행 수를 반환합니다.
ExecuteNonQueryAsync()	해당 연결 개체에 대해 명령을 실행하여 영향을 받는 행 수를 반환하는 비동기 버전의 ExecuteNonQuery(). CancellationToken.None을 사용하여 ExecuteNonQueryAsync(CancellationToken) 호출합니다. (다음에서 상속됨 DbCommand)
ExecuteNonQueryAsync(CancellationToken)	ExecuteNonQuery()비동기 버전입니다. 공급자는 적절한 구현으로 재정의해야 합니다. 취소 토큰은 선택적으로 무시될 수 있습니다. 기본 구현은 동기 ExecuteNonQuery() 메서드를 호출하고 완료된 작업을 반환하여 호출 스레드를 차단합니다. 이미 취소된 취소 토큰을 전달한 경우 기본 구현은 취소된 작업을 반환합니다. ExecuteNonQuery() throw된 예외는 반환된 작업 예외 속성을 통해 전달됩니다. 반환된 Task가 완료될 때까지 DbCommand 개체의 다른 메서드와 속성을 호출하지 마세요. (다음에서 상속됨 DbCommand)
ExecuteReader()	CommandText Connection 보내고 OdbcDataReader빌드합니다.
ExecuteReader(CommandBehavior)	CommandText Connection보내고 CommandBehavior 값 중 하나를 사용하여 OdbcDataReader 빌드합니다.
ExecuteReaderAsync()	연결에 대해 명령을 실행하고 결과에 액세스하는 데 사용할 수 있는 DbDataReader 반환하는 비동기 버전의 ExecuteReader. CancellationToken.None을 사용하여 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) 호출합니다. (다음에서 상속됨 DbCommand)
ExecuteReaderAsync(CancellationToken)	연결에 대해 명령을 실행하고 결과에 액세스하는 데 사용할 수 있는 DbDataReader 반환하는 비동기 버전의 ExecuteReader. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)호출합니다. (다음에서 상속됨 DbCommand)
ExecuteReaderAsync(CommandBehavior)	연결에 대해 명령을 실행하고 결과에 액세스하는 데 사용할 수 있는 DbDataReader 반환하는 비동기 버전의 ExecuteReader. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)호출합니다. (다음에서 상속됨 DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)	ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)호출합니다. (다음에서 상속됨 DbCommand)
ExecuteScalar()	쿼리를 실행하고 쿼리에서 반환된 결과 집합에서 첫 번째 행의 첫 번째 열을 반환합니다. 추가 열 또는 행은 무시됩니다.
ExecuteScalarAsync()	명령을 실행하고 반환된 첫 번째 결과 집합에서 첫 번째 행의 첫 번째 열을 반환하는 비동기 버전의 ExecuteScalar(). 다른 모든 열, 행 및 결과 집합은 무시됩니다. CancellationToken.None을 사용하여 ExecuteScalarAsync(CancellationToken) 호출합니다. (다음에서 상속됨 DbCommand)
ExecuteScalarAsync(CancellationToken)	ExecuteScalar()비동기 버전입니다. 공급자는 적절한 구현으로 재정의해야 합니다. 취소 토큰은 선택적으로 무시될 수 있습니다. 기본 구현은 동기 ExecuteScalar() 메서드를 호출하고 완료된 작업을 반환하여 호출 스레드를 차단합니다. 이미 취소된 취소 토큰을 전달한 경우 기본 구현은 취소된 작업을 반환합니다. ExecuteScalar에서 throw된 예외는 반환된 작업 예외 속성을 통해 전달됩니다. 반환된 Task가 완료될 때까지 DbCommand 개체의 다른 메서드와 속성을 호출하지 마세요. (다음에서 상속됨 DbCommand)
GetHashCode()	기본 해시 함수로 사용됩니다. (다음에서 상속됨 Object)
GetLifetimeService()	사용되지 않음. 이 인스턴스의 수명 정책을 제어하는 현재 수명 서비스 개체를 검색합니다. (다음에서 상속됨 MarshalByRefObject)
GetService(Type)	Component 또는 해당 Container제공하는 서비스를 나타내는 개체를 반환합니다. (다음에서 상속됨 Component)
GetType()	현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object)
InitializeLifetimeService()	사용되지 않음. 이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다. (다음에서 상속됨 MarshalByRefObject)
MemberwiseClone()	현재 Object단순 복사본을 만듭니다. (다음에서 상속됨 Object)
MemberwiseClone(Boolean)	현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다. (다음에서 상속됨 MarshalByRefObject)
Prepare()	데이터 원본에서 준비되거나 컴파일된 버전의 명령을 만듭니다.
PrepareAsync(CancellationToken)	데이터 원본에 준비된(또는 컴파일된) 버전의 명령을 비동기적으로 만듭니다. (다음에서 상속됨 DbCommand)
ResetCommandTimeout()	CommandTimeout 속성을 기본값으로 다시 설정합니다.
ToString()	Component이름이 포함된 String 반환합니다(있는 경우). 이 메서드는 재정의해서는 안 됩니다. (다음에서 상속됨 Component)

이벤트

Disposed

구성 요소가 Dispose() 메서드 호출에 의해 삭제될 때 발생합니다. (다음에서 상속됨 Component)

명시적 인터페이스 구현

ICloneable.Clone()	이 멤버에 대한 설명은 Clone()참조하세요.
IDbCommand.Connection	이 IDbCommand인스턴스에서 사용하는 IDbConnection 가져오거나 설정합니다. (다음에서 상속됨 DbCommand)
IDbCommand.CreateParameter()	IDbDataParameter 개체의 새 인스턴스를 만듭니다. (다음에서 상속됨 DbCommand)
IDbCommand.ExecuteReader()	Connection 대해 CommandText 실행하고 IDataReader빌드합니다. (다음에서 상속됨 DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)	Connection대해 CommandText 실행하고 CommandBehavior 값 중 하나를 사용하여 IDataReader 빌드합니다. (다음에서 상속됨 DbCommand)
IDbCommand.Parameters	IDataParameterCollection가져옵니다. (다음에서 상속됨 DbCommand)
IDbCommand.Transaction	이 DbCommand 개체가 실행되는 DbTransaction 가져오거나 설정합니다. (다음에서 상속됨 DbCommand)

확장 메서드

ConfigureAwait(IAsyncDisposable, Boolean)

비동기 삭제 가능 파일에서 반환된 작업에 대한 대기가 수행되는 방법을 구성합니다.

추가 정보

• OdbcDataAdapter
• OdbcConnection
• 명령 실행