OleDbCommand 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
SQL 문이나 데이터 소스에 대해 실행할 저장 프로시저를 나타냅니다.
public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable, IDisposable
public ref class OleDbCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand
public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable
public sealed class OleDbCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommand
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable
type OleDbCommand = class
inherit DbCommand
interface ICloneable
interface IDbCommand
interface IDisposable
type OleDbCommand = class
inherit Component
interface ICloneable
interface IDbCommand
interface IDisposable
type OleDbCommand = class
inherit DbCommand
interface IDbCommand
interface IDisposable
interface ICloneable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable
Public NotInheritable Class OleDbCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable
- 상속
- 상속
- 구현
예제
다음 예제에서는 , OleDbDataAdapter 및 를 OleDbConnection사용하여 OleDbCommandAccess 데이터베이스에서 행을 선택합니다. 채워진 DataSet 반환 됩니다. 이 예제는 초기화된 DataSet, 연결 문자열, SQL SELECT 문인 쿼리 문자열 및 원본 데이터베이스 테이블의 이름인 문자열을 전달합니다.
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
설명
의 instance OleDbCommand 만들면 읽기/쓰기 속성이 초기 값으로 설정됩니다. 이러한 값의 목록을 보려면 참조는 OleDbCommand 생성자입니다.
OleDbCommand 는 데이터 원본에서 명령을 실행하는 다음 메서드를 제공합니다.
항목 | Description |
---|---|
ExecuteReader | 행을 반환하는 명령을 실행합니다. ExecuteReader SQL SET 문과 같은 명령을 실행하는 데 사용할 경우 원하는 효과가 없을 수 있습니다. |
ExecuteNonQuery | SQL INSERT, DELETE, UPDATE 및 SET 문과 같은 명령을 실행합니다. |
ExecuteScalar | 단일 값(예: 데이터베이스에서 집계 값)을 검색합니다. |
속성을 재설정 CommandText 하고 개체를 OleDbCommand 다시 사용할 수 있습니다. 그러나 새 명령이나 이전 명령을 실행하려면 먼저 를 닫 OleDbDataReader 아야 합니다.
를 실행하는 OleDbCommandOleDbConnection메서드에서 치명적인 OleDbException 심각도 수준(예: SQL Server 심각도 수준 20 이상)이 생성되면 연결이 닫혀 있을 수 있습니다. 그러나 사용자는 연결을 다시 열고 계속할 수 있습니다.
생성자
OleDbCommand() |
OleDbCommand 클래스의 새 인스턴스를 초기화합니다. |
OleDbCommand(String) |
쿼리 텍스트를 사용하여 OleDbCommand 클래스의 새 인스턴스를 초기화합니다. |
OleDbCommand(String, OleDbConnection) |
쿼리의 텍스트와 OleDbConnection을 사용하여 OleDbCommand 클래스의 새 인스턴스를 초기화합니다. |
OleDbCommand(String, OleDbConnection, OleDbTransaction) |
쿼리의 텍스트, OleDbConnection 및 Transaction을 사용하여 OleDbCommand 클래스의 새 인스턴스를 초기화합니다. |
속성
CanRaiseEvents |
구성 요소가 이벤트를 발생시킬 수 있는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 Component) |
CommandText |
SQL 문이나 데이터 소스에서 실행할 저장 프로시저를 가져오거나 설정합니다. |
CommandTimeout |
명령 실행을 종료하고 오류를 생성하기 전에 대기 시간(초 단위)을 가져오거나 설정합니다. |
CommandType |
CommandText 속성의 해석 방법을 나타내는 값을 가져오거나 설정합니다. |
Connection |
OleDbCommand의 이 인스턴스에서 사용되는 OleDbConnection을 가져오거나 설정합니다. |
Container |
IContainer을 포함하는 Component를 가져옵니다. (다음에서 상속됨 Component) |
DbConnection |
이 DbConnection에서 사용하는 DbCommand을 가져오거나 설정합니다. (다음에서 상속됨 DbCommand) |
DbParameterCollection |
DbParameter 개체의 컬렉션을 가져옵니다. (다음에서 상속됨 DbCommand) |
DbTransaction |
이 DbCommand 개체를 실행할 DbTransaction을 가져오거나 설정합니다. (다음에서 상속됨 DbCommand) |
DesignMode |
Component가 현재 디자인 모드인지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 Component) |
DesignTimeVisible |
사용자 지정 Windows Forms 디자이너 컨트롤에서 명령 개체의 표시 여부를 나타내는 값을 가져오거나 설정합니다. |
Events |
이 Component에 연결된 이벤트 처리기의 목록을 가져옵니다. (다음에서 상속됨 Component) |
Parameters |
OleDbParameterCollection를 가져옵니다. |
Site |
Component의 ISite를 가져오거나 설정합니다. (다음에서 상속됨 Component) |
Transaction |
OleDbTransaction가 실행되는 OleDbCommand을 가져오거나 설정합니다. |
UpdatedRowSource |
DataRow의 |
메서드
Cancel() |
OleDbCommand의 실행을 취소하려고 합니다. |
Clone() |
현재 인스턴스의 복사본인 새 OleDbCommand 개체를 만듭니다. |
CreateDbParameter() |
DbParameter 개체의 새 인스턴스를 만듭니다. (다음에서 상속됨 DbCommand) |
CreateObjRef(Type) |
원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다. (다음에서 상속됨 MarshalByRefObject) |
CreateParameter() |
OleDbParameter 개체의 새 인스턴스를 만듭니다. |
Dispose() |
관리되지 않는 리소스의 확보, 해제 또는 다시 설정과 관련된 애플리케이션 정의 작업을 수행합니다. (다음에서 상속됨 DbCommand) |
Dispose() |
Component에서 사용하는 모든 리소스를 해제합니다. (다음에서 상속됨 Component) |
Dispose(Boolean) |
DbCommand에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스를 선택적으로 해제할 수 있습니다. (다음에서 상속됨 DbCommand) |
Dispose(Boolean) |
Component에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스를 선택적으로 해제할 수 있습니다. (다음에서 상속됨 Component) |
DisposeAsync() |
명령 개체를 비동기적으로 삭제합니다. (다음에서 상속됨 DbCommand) |
Equals(Object) |
지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object) |
ExecuteDbDataReader(CommandBehavior) |
해당 연결에 대해 명령을 실행하여 결과에 액세스하는 DbDataReader 데 사용할 수 있는 을 반환합니다. (다음에서 상속됨 DbCommand) |
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) |
공급자는 ExecuteReader 오버로드에 기본값이 아닌 구현을 제공하도록 이 메서드를 구현해야 합니다. 기본 구현은 동기 ExecuteReader() 메서드를 호출하고, 호출 스레드를 차단하면서 완료된 작업을 반환합니다. 기본 구현은 이미 취소된 취소 토큰을 전달하는 경우 취소된 작업을 반환합니다. ExecuteReader에서 throw되는 예외는 반환된 Task Exception 속성을 통해 전달됩니다. 이 메서드는 조기에 취소할 작업을 요청하는 데 사용할 수 있는 취소 토큰을 허용합니다. 구현은 이 요청을 무시할 수 있습니다. (다음에서 상속됨 DbCommand) |
ExecuteNonQuery() |
Connection에 대해 SQL 문을 실행하고 영향을 받는 행의 수를 반환합니다. |
ExecuteNonQueryAsync() |
연결 개체에 대해 명령을 실행하여 영향을 받는 행 수를 반환하는 의 비동기 버전 ExecuteNonQuery()입니다. CancellationToken.None을 사용하여 ExecuteNonQueryAsync(CancellationToken)를 호출합니다. (다음에서 상속됨 DbCommand) |
ExecuteNonQueryAsync(CancellationToken) |
ExecuteNonQuery()의 비동기 버전입니다. 공급자는 적절한 구현을 재정의해야 합니다. 취소 토큰은 선택적으로 무시될 수 있습니다. 기본 구현은 동기 ExecuteNonQuery() 메서드를 호출하고, 호출 스레드를 차단하면서 완료된 작업을 반환합니다. 기본 구현은 이미 취소된 취소 토큰을 전달하는 경우 취소된 작업을 반환합니다. ExecuteNonQuery()에서 throw되는 예외는 반환된 Task Exception 속성을 통해 전달됩니다. 반환된 작업이 완료될 때까지 |
ExecuteReader() |
CommandText를 Connection에 보내고 OleDbDataReader를 빌드합니다. |
ExecuteReader(CommandBehavior) |
CommandText를 Connection에 보내고 CommandBehavior 값 중 하나를 사용하여 OleDbDataReader를 빌드합니다. |
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 Exception 속성을 통해 전달됩니다. 반환된 작업이 완료될 때까지 |
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() |
이 API는 제품 인프라를 지원하며 코드에서 직접 사용되지 않습니다. IDbDataParameter 개체의 새 인스턴스를 만듭니다. |
IDbCommand.CreateParameter() |
IDbDataParameter 개체의 새 인스턴스를 만듭니다. (다음에서 상속됨 DbCommand) |
IDbCommand.ExecuteReader() |
이 멤버에 대한 설명은 ExecuteReader()를 참조하세요. |
IDbCommand.ExecuteReader(CommandBehavior) |
Connection에 대해 CommandText를 실행하고 CommandBehavior 값 중 하나를 사용하여 IDataReader를 빌드합니다. |
IDbCommand.Parameters |
IDataParameterCollection를 가져옵니다. (다음에서 상속됨 DbCommand) |
IDbCommand.Transaction |
이 DbCommand 개체를 실행할 DbTransaction을 가져오거나 설정합니다. (다음에서 상속됨 DbCommand) |
확장 메서드
ConfigureAwait(IAsyncDisposable, Boolean) |
비동기 일회용에서 반환되는 작업을 대기하는 방법을 구성합니다. |
적용 대상
추가 정보
.NET
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기