DbCommand DbCommand DbCommand DbCommand Class

정의

SQL 문이나 데이터 소스에 대해 실행할 저장 프로시저를 나타냅니다.Represents an SQL statement or stored procedure to execute against a data source. 명령을 나타내는 데이터베이스 관련 클래스의 기본 클래스를 제공합니다.Provides a base class for database-specific classes that represent commands. ExecuteNonQueryAsync

public ref class DbCommand abstract : System::ComponentModel::Component, IDisposable, System::Data::IDbCommand
public abstract class DbCommand : System.ComponentModel.Component, IDisposable, System.Data.IDbCommand
type DbCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable
Public MustInherit Class DbCommand
Inherits Component
Implements IDbCommand, IDisposable
상속
파생
구현

생성자

DbCommand() DbCommand() DbCommand() DbCommand()

DbCommand 개체의 인스턴스를 생성합니다.Constructs an instance of the DbCommand object.

속성

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

구성 요소가 이벤트를 발생시킬 수 있는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
CommandText CommandText CommandText CommandText

파생 클래스에서 재정의되는 경우 데이터 소스에 대해 실행할 텍스트 명령을 가져오거나 설정합니다.When overridden in a derived class, gets or sets the text command to run against the data source.

CommandTimeout CommandTimeout CommandTimeout CommandTimeout

파생 클래스에서 재정의되는 경우 명령 실행을 종료하고 오류를 생성하기 전 대기 시간을 가져오거나 설정합니다.When overridden in a derived class, gets or sets the wait time before terminating the attempt to execute a command and generating an error.

CommandType CommandType CommandType CommandType

파생 클래스에서 재정의되는 경우 CommandText 속성을 해석하는 방법을 가져오거나 설정합니다.When overridden in a derived class, gets or sets how the CommandText property is interpreted.

Connection Connection Connection Connection

DbConnection에서 사용하는 DbCommand을 가져오거나 설정합니다.Gets or sets the DbConnection used by this DbCommand.

Container Container Container Container

IContainer가 포함된 Component를 가져옵니다.Gets the IContainer that contains the Component.

(Inherited from Component)
DbConnection DbConnection DbConnection DbConnection

파생 클래스에서 재정의되는 경우 이 DbCommand에 사용되는 DbConnection을 가져오거나 설정합니다.When overridden in a derived class, gets or sets the DbConnection used by this DbCommand.

DbParameterCollection DbParameterCollection DbParameterCollection DbParameterCollection

파생 클래스에서 재정의되는 경우 DbParameter 개체의 컬렉션을 가져옵니다.When overridden in a derived class, gets the collection of DbParameter objects.

DbTransaction DbTransaction DbTransaction DbTransaction

파생 클래스에서 재정의되는 경우 이 DbCommand 개체가 실행되는 DbTransaction을 가져오거나 설정합니다.When overridden in a derived class, gets or sets the DbTransaction within which this DbCommand object executes.

DesignMode DesignMode DesignMode DesignMode

Component가 현재 디자인 모드인지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
DesignTimeVisible DesignTimeVisible DesignTimeVisible DesignTimeVisible

파생 클래스에서 재정의되는 경우 명령 개체를 사용자 지정된 인터페이스 제어에서 표시할지 여부를 나타내는 값을 가져오거나 설정합니다.When overridden in a derived class, gets or sets a value indicating whether the command object should be visible in a customized interface control.

Events Events Events Events

Component에 연결된 이벤트 처리기의 목록을 가져옵니다.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Parameters Parameters Parameters Parameters

DbParameter 개체의 컬렉션을 가져옵니다.Gets the collection of DbParameter objects. 매개 변수에 대한 자세한 내용은 매개 변수 및 매개 변수 데이터 형식 구성을 참조하세요.For more information on parameters, see Configuring Parameters and Parameter Data Types.

Site Site Site Site

ComponentISite를 가져오거나 설정합니다.Gets or sets the ISite of the Component.

(Inherited from Component)
Transaction Transaction Transaction Transaction

DbCommand 개체를 실행할 DbTransaction을 가져오거나 설정합니다.Gets or sets the DbTransaction within which this DbCommand object executes.

UpdatedRowSource UpdatedRowSource UpdatedRowSource UpdatedRowSource

파생 클래스에서 재정의되는 경우 DbDataAdapter의 Update 메서드에서 사용될 때 명령 결과가 DataRow에 적용되는 방법을 가져오거나 설정합니다.When overridden in a derived class, gets or sets how command results are applied to the DataRow when used by the Update method of a DbDataAdapter.

메서드

Cancel() Cancel() Cancel() Cancel()

파생 클래스에서 재정의되는 경우 DbCommand의 실행을 취소하려고 합니다.When overridden in a derived class, attempts to cancel the execution of a DbCommand.

CreateDbParameter() CreateDbParameter() CreateDbParameter() CreateDbParameter()

파생 클래스에서 재정의되는 경우 DbParameter 개체의 새 인스턴스를 만듭니다.When overridden in a derived class, creates a new instance of a DbParameter object.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
CreateParameter() CreateParameter() CreateParameter() CreateParameter()

DbParameter 개체의 새 인스턴스를 만듭니다.Creates a new instance of a DbParameter object.

Dispose() Dispose() Dispose() Dispose()
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)
DisposeAsync() DisposeAsync() DisposeAsync() DisposeAsync()

명령 개체를 비동기적으로 삭제합니다.Asynchronously diposes the command object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(Inherited from Object)
ExecuteDbDataReader(CommandBehavior) ExecuteDbDataReader(CommandBehavior) ExecuteDbDataReader(CommandBehavior) ExecuteDbDataReader(CommandBehavior)

파생 클래스에서 재정의되는 경우 연결에 대해 명령 텍스트를 실행합니다.When overridden in a derived class, executes the command text against the connection.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

공급자는 ExecuteReader 오버로드에 기본값이 아닌 구현을 제공하도록 이 메서드를 구현해야 합니다.Providers should implement this method to provide a non-default implementation for ExecuteReader overloads.

기본 구현은 동기 ExecuteReader() 메서드를 호출하고, 호출 스레드를 차단하면서 완료된 작업을 반환합니다.The default implementation invokes the synchronous ExecuteReader() method and returns a completed task, blocking the calling thread. 기본 구현은 이미 취소된 취소 토큰을 전달하는 경우 취소된 작업을 반환합니다.The default implementation will return a cancelled task if passed an already cancelled cancellation token. ExecuteReader에서 throw되는 예외는 반환된 Task Exception 속성을 통해 전달됩니다.Exceptions thrown by ExecuteReader will be communicated via the returned Task Exception property.

이 메서드는 조기에 취소할 작업을 요청하는 데 사용할 수 있는 취소 토큰을 허용합니다.This method accepts a cancellation token that can be used to request the operation to be cancelled early. 구현은 이 요청을 무시할 수 있습니다.Implementations may ignore this request.

ExecuteNonQuery() ExecuteNonQuery() ExecuteNonQuery() ExecuteNonQuery()

파생 클래스에서 재정의되는 경우 연결 개체에 대해 SQL 문을 실행합니다.When overridden in a derived class, executes a SQL statement against a connection object.

ExecuteNonQueryAsync() ExecuteNonQueryAsync() ExecuteNonQueryAsync() ExecuteNonQueryAsync()

연결 개체에 대해 SQL 문을 실행하는 비동기 버전의 ExecuteNonQuery()입니다.An asynchronous version of ExecuteNonQuery(), which executes a SQL statement against a connection object.

CancellationToken.None을 사용하여 ExecuteNonQueryAsync(CancellationToken)를 호출합니다.Invokes ExecuteNonQueryAsync(CancellationToken) with CancellationToken.None.

ExecuteNonQueryAsync(CancellationToken) ExecuteNonQueryAsync(CancellationToken) ExecuteNonQueryAsync(CancellationToken) ExecuteNonQueryAsync(CancellationToken)

ExecuteNonQuery()의 비동기 버전입니다.This is the asynchronous version of ExecuteNonQuery(). 공급자는 적절한 구현을 재정의해야 합니다.Providers should override with an appropriate implementation. 취소 토큰은 선택적으로 무시될 수 있습니다.The cancellation token may optionally be ignored.

기본 구현은 동기 ExecuteNonQuery() 메서드를 호출하고, 호출 스레드를 차단하면서 완료된 작업을 반환합니다.The default implementation invokes the synchronous ExecuteNonQuery() method and returns a completed task, blocking the calling thread. 기본 구현은 이미 취소된 취소 토큰을 전달하는 경우 취소된 작업을 반환합니다.The default implementation will return a cancelled task if passed an already cancelled cancellation token. ExecuteNonQuery()에서 throw되는 예외는 반환된 Task Exception 속성을 통해 전달됩니다.Exceptions thrown by ExecuteNonQuery() will be communicated via the returned Task Exception property.

반환된 작업이 완료될 때까지 DbCommand 개체의 다른 메서드 및 속성을 호출하지 마십시오.Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

ExecuteReader() ExecuteReader() ExecuteReader() ExecuteReader()

CommandText에 대해 Connection를 실행하고 DbDataReader를 반환합니다.Executes the CommandText against the Connection, and returns an DbDataReader.

ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior)

CommandText에 대해 Connection를 실행하고 DbDataReader 값 중 하나를 사용하여 CommandBehavior를 반환합니다.Executes the CommandText against the Connection, and returns an DbDataReader using one of the CommandBehavior values.

ExecuteReaderAsync() ExecuteReaderAsync() ExecuteReaderAsync() ExecuteReaderAsync()

ExecuteReader에 대해 CommandText를 실행하고 Connection를 반환하는 DbDataReader의 비동기 버전입니다.An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

CancellationToken.None을 사용하여 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)를 호출합니다.Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) with CancellationToken.None.

ExecuteReaderAsync(CancellationToken) ExecuteReaderAsync(CancellationToken) ExecuteReaderAsync(CancellationToken) ExecuteReaderAsync(CancellationToken)

ExecuteReader에 대해 CommandText를 실행하고 Connection를 반환하는 DbDataReader의 비동기 버전입니다.An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader. 이 메서드는 작업을 취소하지 않아야 한다는 알림을 전파합니다.This method propagates a notification that operations should be canceled.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)를 호출합니다.Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteReaderAsync(CommandBehavior) ExecuteReaderAsync(CommandBehavior) ExecuteReaderAsync(CommandBehavior) ExecuteReaderAsync(CommandBehavior)

ExecuteReader에 대해 CommandText를 실행하고 Connection를 반환하는 DbDataReader의 비동기 버전입니다.An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)를 호출합니다.Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteReaderAsync(CommandBehavior, CancellationToken) ExecuteReaderAsync(CommandBehavior, CancellationToken) ExecuteReaderAsync(CommandBehavior, CancellationToken) ExecuteReaderAsync(CommandBehavior, CancellationToken)

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)를 호출합니다.Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteScalar() ExecuteScalar() ExecuteScalar() ExecuteScalar()

파생 클래스에서 재정의되는 경우 쿼리를 실행하고 쿼리에서 반환된 결과 집합의 첫 번째 행의 첫 번째 열을 반환합니다.When overridden in a derived class, executes the query and returns the first column of the first row in the result set returned by the query. 다른 모든 열과 행은 무시됩니다.All other columns and rows are ignored.

ExecuteScalarAsync() ExecuteScalarAsync() ExecuteScalarAsync() ExecuteScalarAsync()

쿼리를 실행하고 쿼리에서 반환된 결과 집합의 첫 번째 행의 첫 번째 열을 반환하는 ExecuteScalar()의 비동기 버전입니다.An asynchronous version of ExecuteScalar(), which executes the query and returns the first column of the first row in the result set returned by the query. 다른 모든 열과 행은 무시됩니다.All other columns and rows are ignored.

CancellationToken.None을 사용하여 ExecuteScalarAsync(CancellationToken)를 호출합니다.Invokes ExecuteScalarAsync(CancellationToken) with CancellationToken.None.

ExecuteScalarAsync(CancellationToken) ExecuteScalarAsync(CancellationToken) ExecuteScalarAsync(CancellationToken) ExecuteScalarAsync(CancellationToken)

ExecuteScalar()의 비동기 버전입니다.This is the asynchronous version of ExecuteScalar(). 공급자는 적절한 구현을 재정의해야 합니다.Providers should override with an appropriate implementation. 취소 토큰은 선택적으로 무시될 수 있습니다.The cancellation token may optionally be ignored.

기본 구현은 동기 ExecuteScalar() 메서드를 호출하고, 호출 스레드를 차단하면서 완료된 작업을 반환합니다.The default implementation invokes the synchronous ExecuteScalar() method and returns a completed task, blocking the calling thread. 기본 구현은 이미 취소된 취소 토큰을 전달하는 경우 취소된 작업을 반환합니다.The default implementation will return a cancelled task if passed an already cancelled cancellation token. ExecuteScalar에서 throw되는 예외는 반환된 Task Exception 속성을 통해 전달됩니다.Exceptions thrown by ExecuteScalar will be communicated via the returned Task Exception property.

반환된 작업이 완료될 때까지 DbCommand 개체의 다른 메서드 및 속성을 호출하지 마십시오.Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Component 또는 해당 Container에서 제공하는 서비스를 나타내는 개체를 반환합니다.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
Prepare() Prepare() Prepare() Prepare()

파생 클래스에서 재정의되는 경우 데이터 소스에 대해 명령의 준비된(또는 컴파일된) 버전을 만듭니다.When overridden in a derived class, creates a prepared (or compiled) version of the command on the data source.

PrepareAsync(CancellationToken) PrepareAsync(CancellationToken) PrepareAsync(CancellationToken) PrepareAsync(CancellationToken)

데이터 소스에 대해 명령의 준비된(또는 컴파일된) 버전을 비동기적으로 만듭니다.Asynchronously creates a prepared (or compiled) version of the command on the data source.

ToString() ToString() ToString() ToString()

Component의 이름이 포함된 String을 반환합니다(있는 경우).Returns a String containing the name of the Component, if any. 이 메서드는 재정의할 수 없습니다.This method should not be overridden.

(Inherited from Component)

명시적 인터페이스 구현

IDbCommand.Connection IDbCommand.Connection IDbCommand.Connection IDbCommand.Connection

IDbCommand의 이 인스턴스에서 사용되는 IDbConnection을 가져오거나 설정합니다.Gets or sets the IDbConnection used by this instance of the IDbCommand.

IDbCommand.CreateParameter() IDbCommand.CreateParameter() IDbCommand.CreateParameter() IDbCommand.CreateParameter()

IDbDataParameter 개체의 새 인스턴스를 만듭니다.Creates a new instance of an IDbDataParameter object.

IDbCommand.ExecuteReader() IDbCommand.ExecuteReader() IDbCommand.ExecuteReader() IDbCommand.ExecuteReader()

Connection에 대해 CommandText를 실행하고 IDataReader를 빌드합니다.Executes the CommandText against the Connection and builds an IDataReader.

IDbCommand.ExecuteReader(CommandBehavior) IDbCommand.ExecuteReader(CommandBehavior) IDbCommand.ExecuteReader(CommandBehavior) IDbCommand.ExecuteReader(CommandBehavior)

Connection에 대해 CommandText를 실행하고 CommandBehavior 값 중 하나를 사용하여 IDataReader를 빌드합니다.Executes the CommandText against the Connection, and builds an IDataReader using one of the CommandBehavior values.

IDbCommand.Parameters IDbCommand.Parameters IDbCommand.Parameters IDbCommand.Parameters

IDataParameterCollection를 가져옵니다.Gets the IDataParameterCollection.

IDbCommand.Transaction IDbCommand.Transaction IDbCommand.Transaction IDbCommand.Transaction

DbCommand 개체를 실행할 DbTransaction을 가져오거나 설정합니다.Gets or sets the DbTransaction within which this DbCommand object executes.

이벤트

Disposed Disposed Disposed Disposed

Dispose() 메서드를 호출하여 구성 요소가 삭제되는 경우 발생합니다.Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)

적용 대상

추가 정보