OracleCommand 클래스

정의

경고

이 API는 현재 사용되지 않습니다.

데이터베이스에서 실행할 SQL 문 또는 저장 프로시저를 나타냅니다.Represents an SQL statement or stored procedure to execute against a database. 이 클래스는 상속될 수 없습니다.This class cannot be inherited.

public ref class OracleCommand sealed : System::Data::Common::DbCommand, ICloneable
[System.Obsolete("OracleCommand has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)]
public sealed class OracleCommand : System.Data.Common.DbCommand, ICloneable
type OracleCommand = class
    inherit DbCommand
    interface ICloneable
Public NotInheritable Class OracleCommand
Inherits DbCommand
Implements ICloneable
상속
특성
구현

예제

다음 예에서는 OracleDataReaderOracleConnection와 함께 OracleCommandExecuteReader 메서드를 사용 하 여 테이블에서 행을 선택 합니다.The following example uses the ExecuteReader method of OracleCommand, along with OracleDataReader and OracleConnection, to select rows from a table.

public void ReadMyData(string connectionString)
{
    string queryString = "SELECT EmpNo, DeptNo FROM Scott.Emp";
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        OracleCommand command = new OracleCommand(queryString, connection);
        connection.Open();
        OracleDataReader reader = command.ExecuteReader();
        try
        {
            while (reader.Read())
            {
                Console.WriteLine(reader.GetInt32(0) + ", " + reader.GetInt32(1));
            }
        }
        finally
        {
            // always call Close when done reading.
            reader.Close();
        }
    }
}
Public Sub ReadMyData(ByVal connectionString As String)
    Dim queryString As String = "SELECT EmpNo, DeptNo FROM Scott.Emp"
    Using connection As New OracleConnection(connectionString)
        Dim command As New OracleCommand(queryString, connection)
        connection.Open()
        Dim reader As OracleDataReader = command.ExecuteReader()
        Try
            While reader.Read()
                Console.WriteLine(reader.GetInt32(0) & ", " _
                   & reader.GetInt32(1))
            End While
        Finally
            ' always call Close when done reading.
            reader.Close()
        End Try
    End Using
End Sub

설명

이 형식은 사용 되지 않으며.NET Framework의 이후 버전에서 제거 됩니다.This type is deprecated and will be removed in a future version of the .NET Framework. 자세한 내용은 Oracle 및 ADO.NET합니다.For more information, see Oracle and ADO.NET.

OracleCommand 클래스는 데이터 소스에 대해 명령을 실행 하기 위해 다음 메서드를 제공 합니다.The OracleCommand class provides the following methods for executing commands against a data source:

항목Item 설명Description
ExecuteReader 행을 반환 하는 명령을 실행 합니다.Executes commands that return rows.
ExecuteOracleNonQuery Connection에 대해 SQL 문을 실행하고 영향을 받는 행의 수를 반환합니다.Executes an SQL statement against the Connection and returns the number of rows affected.
ExecuteNonQuery SQL 삽입, 삭제, 업데이트 및 SET 문과 같은 명령을 실행합니다.Executes commands such as SQL INSERT, DELETE, UPDATE, and SET statements.
ExecuteScalar .NET Framework 데이터 형식으로 데이터베이스에서 단일 값 (예를 들어 집계 값)을 검색합니다.Retrieves a single value (for example, an aggregate value) from a database as a .NET Framework data type.
ExecuteOracleScalar Oracle 고유 데이터 형식으로 데이터베이스에서 단일 값 (예를 들어 집계 값)을 검색합니다.Retrieves a single value (for example, an aggregate value) from a database as an Oracle-specific data type.

CommandText 속성을 다시 설정 하 고 OracleCommand 개체를 다시 사용할 수 있습니다.You can reset the CommandText property and reuse the OracleCommand object.

명령 실행으로 인해 심각한 OracleException발생 하는 경우 OracleConnection 닫힐 수 있습니다.If execution of the command results in a fatal OracleException, the OracleConnection may close. 그러나 사용자는 연결을 다시 열고 계속할 수 있습니다.However, the user can reopen the connection and continue.

참고

다른 .NET Framework 데이터 공급자 (SQL Server, OLE DB 및 ODBC)의 Command 개체와 달리 OracleCommand 개체는 CommandTimeout 속성을 지원 하지 않습니다.Unlike the Command object in the other .NET Framework data providers (SQL Server, OLE DB, and ODBC), the OracleCommand object does not support a CommandTimeout property. 명령 제한 시간을 설정 해도 효과가 없습니다 하 고 반환 되는 값은 항상 0입니다.Setting a command timeout has no effect and the value returned is always zero.

생성자

OracleCommand()

OracleCommand의 새 인스턴스를 초기화합니다.Initializes a new instance of the OracleCommand.

OracleCommand(String)

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

OracleCommand(String, OracleConnection)

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

OracleCommand(String, OracleConnection, OracleTransaction)

쿼리 텍스트, OracleCommand 개체 및 OracleConnection을 사용하여 OracleTransaction 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the OracleCommand class with the text of the query, an OracleConnection object, and an OracleTransaction.

속성

CanRaiseEvents

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

(다음에서 상속됨 Component)
CommandText

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

CommandTimeout

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

CommandType

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

Connection

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

Container

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

(다음에서 상속됨 Component)
DbConnection

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

(다음에서 상속됨 DbCommand)
DbParameterCollection

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

(다음에서 상속됨 DbCommand)
DbTransaction

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

(다음에서 상속됨 DbCommand)
DesignMode

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

(다음에서 상속됨 Component)
DesignTimeVisible

명령 개체를 사용자 지정된 인터페이스 컨트롤에서 표시할지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the command object should be visible in a customized interface control.

Events

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

(다음에서 상속됨 Component)
Parameters

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

Site

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

(다음에서 상속됨 Component)
Transaction

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

UpdatedRowSource

Update 메서드가 명령 결과를 DataRow에 적용하는 방식을 지정하는 값을 가져오거나 설정합니다.Gets or sets a value that specifies how the Update method should apply command results to the DataRow.

메서드

Cancel()

OracleCommand의 실행을 취소합니다.Attempts to cancel the execution of an OracleCommand.

Clone()

OracleCommand 개체의 복사본을 만듭니다.Creates a copy of this OracleCommand object.

CreateDbParameter()

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

(다음에서 상속됨 DbCommand)
CreateObjRef(Type)

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

(다음에서 상속됨 MarshalByRefObject)
CreateParameter()

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

Dispose()

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

(다음에서 상속됨 Component)
Dispose(Boolean)

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

(다음에서 상속됨 Component)
DisposeAsync()

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

(다음에서 상속됨 DbCommand)
Equals(Object)

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

(다음에서 상속됨 Object)
ExecuteDbDataReader(CommandBehavior)

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

(다음에서 상속됨 DbCommand)
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.

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

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

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.

(다음에서 상속됨 DbCommand)
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.

(다음에서 상속됨 DbCommand)
ExecuteOracleNonQuery(OracleString)

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

ExecuteOracleScalar()

쿼리를 실행하고 쿼리에서 반환된 결과 집합의 첫 번째 행의 첫 번째 열을 Oracle 고유 데이터 형식으로 반환합니다.Executes the query, and returns the first column of the first row in the result set returned by the query as an Oracle-specific data type. 추가 열이나 행은 무시됩니다.Extra columns or rows are ignored.

ExecuteReader()

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

ExecuteReader(CommandBehavior)

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

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.

(다음에서 상속됨 DbCommand)
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).

(다음에서 상속됨 DbCommand)
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).

(다음에서 상속됨 DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)

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

(다음에서 상속됨 DbCommand)
ExecuteScalar()

쿼리를 실행하고 쿼리에서 반환된 결과 집합의 첫 번째 행의 첫 번째 열을 .NET Framework 데이터 형식으로 반환합니다.Executes the query, and returns the first column of the first row in the result set returned by the query as a .NET Framework data type. 추가 열이나 행은 무시됩니다.Extra columns or rows are ignored.

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.

(다음에서 상속됨 DbCommand)
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.

(다음에서 상속됨 DbCommand)
GetHashCode()

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

(다음에서 상속됨 Object)
GetLifetimeService()

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

(다음에서 상속됨 MarshalByRefObject)
GetService(Type)

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

(다음에서 상속됨 Component)
GetType()

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

(다음에서 상속됨 Object)
InitializeLifetimeService()

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

(다음에서 상속됨 MarshalByRefObject)
MemberwiseClone()

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

(다음에서 상속됨 Object)
MemberwiseClone(Boolean)

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

(다음에서 상속됨 MarshalByRefObject)
Prepare()

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

PrepareAsync(CancellationToken)

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

(다음에서 상속됨 DbCommand)
ResetCommandTimeout()

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

ToString()

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

(다음에서 상속됨 Component)

이벤트

Disposed

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

(다음에서 상속됨 Component)

명시적 인터페이스 구현

IDbCommand.Connection

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

(다음에서 상속됨 DbCommand)
IDbCommand.CreateParameter()

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

IDbCommand.ExecuteReader()

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

IDbCommand.ExecuteReader(CommandBehavior)

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

IDbCommand.Parameters

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

(다음에서 상속됨 DbCommand)
IDbCommand.Transaction

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

(다음에서 상속됨 DbCommand)

적용 대상

추가 정보