OleDbCommand OleDbCommand OleDbCommand OleDbCommand Class

정의

SQL 문이나 데이터 소스에 대해 실행할 저장 프로시저를 나타냅니다.Represents an SQL statement or stored procedure to execute against a data source.

public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable, IDisposable
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable
type OleDbCommand = class
    inherit DbCommand
    interface ICloneable
    interface IDbCommand
    interface IDisposable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable
상속
구현

예제

다음 예제에서는 합니다 OleDbCommand, 함께 OleDbDataAdapterOleDbConnection, Access 데이터베이스에서 행을 선택 합니다.The following example uses the OleDbCommand, along OleDbDataAdapter and OleDbConnection, to select rows from an Access database. 채워진 DataSet 반환 됩니다.The filled DataSet is then returned. 이 예제에서는 초기화 되는지를 DataSet, 연결 문자열는 SQL SELECT 문 하는 쿼리 문자열 및 문자열은 원본 데이터베이스 테이블의 이름입니다.The example is passed an initialized DataSet, a connection string, a query string that is an SQL SELECT statement, and a string that is the name of the source database table.

public void ReadMyData(string connectionString)
{
    string queryString = "SELECT OrderID, CustomerID FROM Orders";
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);
        connection.Open();
        OleDbDataReader reader = command.ExecuteReader();

        while (reader.Read())
        {
            Console.WriteLine(reader.GetInt32(0) + ", " + reader.GetString(1));
        }
        // always call Close when done reading.
        reader.Close();
    }
}
Public Sub ReadMyData(ByVal connectionString As String)
    Dim queryString As String = "SELECT OrderID, CustomerID FROM Orders"
    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()
        While reader.Read()
            Console.WriteLine(reader.GetInt32(0).ToString() + ", " _
               + reader.GetString(1))
        End While

        ' always call Close when done reading.
        reader.Close()
    End Using
End Sub

설명

인스턴스가 OleDbCommand 만들어지면 읽기/쓰기 속성은 초기 값으로 설정 됩니다.When an instance of OleDbCommand is created, the read/write properties are set to their initial values. 이러한 값의 목록을 보려면 참조는 OleDbCommand 생성자입니다.For a list of these values, see the OleDbCommand constructor.

OleDbCommand 데이터 원본에서 명령을 실행 다음 메서드를 제공 합니다.OleDbCommand features the following methods executing commands at a data source:

항목Item 설명Description
ExecuteReader 행을 반환 하는 명령을 실행 합니다.Executes commands that return rows. ExecuteReader 사용 하는 경우 원하는 효과 없을 수 있습니다 SQL SET 문과 같은 명령을 실행 합니다.ExecuteReader may not have the effect that you want if used to execute commands such as SQL SET statements.
ExecuteNonQuery SQL 삽입, 삭제, 업데이트 및 SET 문과 같은 명령을 실행합니다.Executes commands such as SQL INSERT, DELETE, UPDATE, and SET statements.
ExecuteScalar 예를 들어 집계 값을 데이터베이스에서 단일 값을 검색합니다.Retrieves a single value, for example, an aggregate value from a database.

다시 설정할 수 있습니다 합니다 CommandText 속성 및 재사용을 OleDbCommand 개체입니다.You can reset the CommandText property and reuse the OleDbCommand object. 그러나를 닫아야는 OleDbDataReader 전에 이전 또는 새 명령을 실행할 수 있습니다.However, you must close the OleDbDataReader before you can execute a new or previous command.

심각한 OleDbException (예: SQL Server 심각도 수준이 20 이상인 경우) 메서드를 실행 하 여 생성 되는 OleDbCommandOleDbConnection, 연결이 닫힐 수 있습니다.If a fatal OleDbException (for example, a SQL Server severity level of 20 or greater) is generated by the method executing an OleDbCommand, the OleDbConnection, the connection may be closed. 그러나 사용자는 연결을 다시 열고 계속할 수 있습니다.However, the user can reopen the connection and continue.

생성자

OleDbCommand() OleDbCommand() OleDbCommand() OleDbCommand()

OleDbCommand 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the OleDbCommand class.

OleDbCommand(String) OleDbCommand(String) OleDbCommand(String) OleDbCommand(String)

쿼리 텍스트를 사용하여 OleDbCommand 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the OleDbCommand class with the text of the query.

OleDbCommand(String, OleDbConnection) OleDbCommand(String, OleDbConnection) OleDbCommand(String, OleDbConnection) OleDbCommand(String, OleDbConnection)

쿼리의 텍스트와 OleDbConnection을 사용하여 OleDbCommand 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the OleDbCommand class with the text of the query and an OleDbConnection.

OleDbCommand(String, OleDbConnection, OleDbTransaction) OleDbCommand(String, OleDbConnection, OleDbTransaction) OleDbCommand(String, OleDbConnection, OleDbTransaction) OleDbCommand(String, OleDbConnection, OleDbTransaction)

쿼리의 텍스트, OleDbConnectionTransaction을 사용하여 OleDbCommand 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the OleDbCommand class with the text of the query, an OleDbConnection, and the Transaction.

속성

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

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

(Inherited from Component)
CommandText CommandText CommandText CommandText

SQL 문이나 데이터 소스에서 실행할 저장 프로시저를 가져오거나 설정합니다.Gets or sets the SQL statement or stored procedure to execute at the data source.

CommandTimeout CommandTimeout CommandTimeout CommandTimeout

명령 실행을 종료하고 오류를 생성하기 전에 대기 시간을 가져오거나 설정합니다.Gets or sets the wait time before terminating an attempt to execute a command and generating an error.

CommandType CommandType CommandType CommandType

CommandText 속성의 해석 방법을 나타내는 값을 가져오거나 설정합니다.Gets or sets a value that indicates how the CommandText property is interpreted.

Connection Connection Connection Connection

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

Container Container Container Container

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

(Inherited from Component)
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

사용자 지정 Windows Forms 디자이너 컨트롤에서 명령 개체의 표시 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value that indicates whether the command object should be visible in a customized Windows Forms Designer 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

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

Site Site Site Site

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

(Inherited from Component)
Transaction Transaction Transaction Transaction

OleDbTransaction가 실행되는 OleDbCommand을 가져오거나 설정합니다.Gets or sets the OleDbTransaction within which the OleDbCommand executes.

UpdatedRowSource UpdatedRowSource UpdatedRowSource UpdatedRowSource

DataRowUpdate 메서드에 의해 사용될 때 명령 결과가 OleDbDataAdapter에 적용되는 방법을 가져오거나 설정합니다.Gets or sets how command results are applied to the DataRow when used by the Update method of the OleDbDataAdapter.

메서드

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

OleDbCommand의 실행을 취소하려고 합니다.Tries to cancel the execution of an OleDbCommand.

Clone() Clone() Clone() Clone()

현재 인스턴스의 복사본인 새 OleDbCommand 개체를 만듭니다.Creates a new OleDbCommand object that is a copy of the current instance.

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()

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

Dispose() Dispose() Dispose() Dispose()

Component에서 사용하는 모든 리소스를 해제합니다.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Component에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스를 선택적으로 해제할 수 있습니다.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Inherited from Component)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
ExecuteNonQuery() ExecuteNonQuery() ExecuteNonQuery() ExecuteNonQuery()

Connection에 대해 SQL 문을 실행하고 영향을 받는 행의 수를 반환합니다.Executes an SQL statement against the Connection and returns the number of rows affected.

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

CommandTextConnection에 보내고 OleDbDataReader를 빌드합니다.Sends the CommandText to the Connection and builds an OleDbDataReader.

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

CommandTextConnection에 보내고 CommandBehavior 값 중 하나를 사용하여 OleDbDataReader를 빌드합니다.Sends the CommandText to the Connection, and builds an OleDbDataReader using one of the CommandBehavior values.

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

쿼리를 실행하고 쿼리에서 반환된 결과 집합에서 첫 번째 행의 첫 번째 열을 반환합니다.Executes the query, and returns the first column of the first row in the result set returned by the query. 다른 열이나 행은 무시됩니다.Additional columns or rows are ignored.

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()

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

ResetCommandTimeout() ResetCommandTimeout() ResetCommandTimeout() ResetCommandTimeout()

CommandTimeout 속성을 기본값으로 다시 설정합니다.Resets the CommandTimeout property to the default value.

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)

명시적 인터페이스 구현

ICloneable.Clone() ICloneable.Clone() ICloneable.Clone() ICloneable.Clone()

이 멤버에 대한 설명은 Clone()를 참조하십시오.For a description of this member, see Clone().

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()

이 멤버에 대한 설명은 ExecuteReader()를 참조하십시오.For a description of this member, see ExecuteReader().

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.

이벤트

Disposed Disposed Disposed Disposed

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

(Inherited from Component)

적용 대상

추가 정보