OleDbDataAdapter 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
DataSet 를 채우고 데이터 원본을 업데이트하는 데 사용되는 데이터베이스 연결 및 데이터 명령 집합을 나타냅니다.
public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapterpublic ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneablepublic ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapterpublic sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapterpublic sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneablepublic sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable, System.Data.IDbDataAdaptertype OleDbDataAdapter = class
inherit DbDataAdapter
interface IDataAdapter
interface IDbDataAdapter
interface ICloneabletype OleDbDataAdapter = class
inherit DbDataAdapter
interface IDbDataAdapter
interface IDataAdapter
interface ICloneablePublic NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapterPublic NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneablePublic NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapter- 상속
- 구현
예제
다음 예제에서는 , OleDbDataAdapter 및 OleDbConnection를 사용하여 OleDbCommandAccess 데이터 원본에서 레코드를 선택하고 를 선택한 행으로 채웁 DataSet 니다. 채워진 DataSet 반환 됩니다. 이를 위해 메서드는 초기화된 DataSet, 연결 문자열 및 SQL SELECT 문인 쿼리 문자열을 전달합니다.
public static OleDbDataAdapter CreateDataAdapter(string selectCommand,
OleDbConnection connection)
{
OleDbDataAdapter adapter = new OleDbDataAdapter(selectCommand, connection);
adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;
// Create the Insert, Update and Delete commands.
adapter.InsertCommand = new OleDbCommand(
"INSERT INTO Customers (CustomerID, CompanyName) " +
"VALUES (?, ?)");
adapter.UpdateCommand = new OleDbCommand(
"UPDATE Customers SET CustomerID = ?, CompanyName = ? " +
"WHERE CustomerID = ?");
adapter.DeleteCommand = new OleDbCommand(
"DELETE FROM Customers WHERE CustomerID = ?");
// Create the parameters.
adapter.InsertCommand.Parameters.Add("@CustomerID",
OleDbType.Char, 5, "CustomerID");
adapter.InsertCommand.Parameters.Add("@CompanyName",
OleDbType.VarChar, 40, "CompanyName");
adapter.UpdateCommand.Parameters.Add("@CustomerID",
OleDbType.Char, 5, "CustomerID");
adapter.UpdateCommand.Parameters.Add("@CompanyName",
OleDbType.VarChar, 40, "CompanyName");
adapter.UpdateCommand.Parameters.Add("@oldCustomerID",
OleDbType.Char, 5, "CustomerID").SourceVersion =
DataRowVersion.Original;
adapter.DeleteCommand.Parameters.Add("@CustomerID",
OleDbType.Char, 5, "CustomerID").SourceVersion =
DataRowVersion.Original;
return adapter;
}
Public Function CreateDataAdapter(ByVal selectCommand As String, _
ByVal connection As OleDbConnection) As OleDbDataAdapter
Dim adapter As OleDbDataAdapter = _
New OleDbDataAdapter(selectCommand, connection)
adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey
' Create the commands.
adapter.InsertCommand = New OleDbCommand( _
"INSERT INTO Customers (CustomerID, CompanyName) " & _
"VALUES (?, ?)")
adapter.UpdateCommand = New OleDbCommand( _
"UPDATE Customers SET CustomerID = ?, CompanyName = ? " & _
"WHERE CustomerID = ?")
adapter.DeleteCommand = New OleDbCommand( _
"DELETE FROM Customers WHERE CustomerID = ?")
' Create the parameters.
adapter.InsertCommand.Parameters.Add( _
"@CustomerID", OleDbType.Char, 5, "CustomerID")
adapter.InsertCommand.Parameters.Add( _
"@CompanyName", OleDbType.VarChar, 40, "CompanyName")
adapter.UpdateCommand.Parameters.Add( _
"@CustomerID", OleDbType.Char, 5, "CustomerID")
adapter.UpdateCommand.Parameters.Add( _
"@CompanyName", OleDbType.VarChar, 40, "CompanyName")
adapter.UpdateCommand.Parameters.Add( _
"@oldCustomerID", OleDbType.Char, 5, "CustomerID").SourceVersion = _
DataRowVersion.Original
adapter.DeleteCommand.Parameters.Add( _
"@CustomerID", OleDbType.Char, 5, "CustomerID").SourceVersion = _
DataRowVersion.Original
Return adapter
End Function
설명
는 OleDbDataAdapter 데이터를 검색하고 저장하기 위한 와 데이터 원본 간의 DataSet 브리지 역할을 합니다. 는 OleDbDataAdapter 를 사용하여 Fill 데이터 원본의 데이터를 로 DataSet로드하고 를 사용하여 Update 에서 변경한 DataSet 내용을 다시 데이터 원본으로 전송하여 이 브리지를 제공합니다.
가 OleDbDataAdapter 를 DataSet채우면 반환된 데이터에 대한 적절한 테이블과 열이 아직 없는 경우 만듭니다. 그러나 기본 키 정보는 속성이 로 설정AddWithKey되지 않는 한 암시적으로 생성된 스키마에 MissingSchemaAction 포함되지 않습니다. 를 OleDbDataAdapter 사용하여 FillSchema데이터로 채우기 전에 기본 키 정보를 포함하여 의 DataSet스키마를 만들 수도 있습니다. 자세한 내용은 기존 제약 조건 데이터 세트에 추가를 참조하세요.
MSDataShape 공급자를 포함한 일부 OLE DB 공급자는 기본 테이블 또는 기본 키 정보를 반환하지 않습니다. 따라서 는 OleDbDataAdapter 만든 DataTable에 속성을 올바르게 설정할 PrimaryKey 수 없습니다. 이러한 경우 에서 테이블 DataSet의 기본 키를 명시적으로 지정해야 합니다.
OleDbDataAdapter 에는 데이터 로드 및 업데이트를 용이하게 하는 , DeleteCommandInsertCommand, , UpdateCommand및 TableMappings 속성도 포함됩니다SelectCommand.
의 OleDbDataAdapterinstance 만들 때 속성은 초기 값으로 설정됩니다. 이러한 값의 목록을 보려면 참조는 OleDbDataAdapter 생성자입니다.
생성자
| OleDbDataAdapter() |
OleDbDataAdapter 클래스의 새 인스턴스를 초기화합니다. |
| OleDbDataAdapter(OleDbCommand) |
OleDbDataAdapter 속성으로서 지정된 OleDbCommand를 사용하여 SelectCommand 클래스의 새 인스턴스를 초기화합니다. |
| OleDbDataAdapter(String, OleDbConnection) |
OleDbDataAdapter를 사용하여 SelectCommand 클래스의 새 인스턴스를 초기화합니다. |
| OleDbDataAdapter(String, String) |
OleDbDataAdapter를 사용하여 SelectCommand 클래스의 새 인스턴스를 초기화합니다. |
필드
| DefaultSourceTableName |
DataAdapter 개체에서 테이블 매핑에 사용하는 기본 이름입니다. (다음에서 상속됨 DbDataAdapter) |
속성
| AcceptChangesDuringFill |
채우기 작업을 수행하는 동안 DataTable에 추가된 DataRow에 대해 AcceptChanges()가 호출되는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 DataAdapter) |
| AcceptChangesDuringUpdate |
AcceptChanges()를 수행하는 동안 Update(DataSet)가 호출되는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 DataAdapter) |
| CanRaiseEvents |
구성 요소가 이벤트를 발생시킬 수 있는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 Component) |
| Container |
IContainer을 포함하는 Component를 가져옵니다. (다음에서 상속됨 Component) |
| ContinueUpdateOnError |
행을 업데이트하는 동안 오류가 발생할 때 예외를 생성할지 여부를 지정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 DataAdapter) |
| DeleteCommand |
데이터 집합에서 레코드를 삭제하는 SQL 문이나 저장 프로시저를 가져오거나 설정합니다. |
| DesignMode |
Component가 현재 디자인 모드인지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 Component) |
| Events |
이 Component에 연결된 이벤트 처리기의 목록을 가져옵니다. (다음에서 상속됨 Component) |
| FillCommandBehavior |
데이터 어댑터를 채우는 데 사용되는 명령의 동작을 가져오거나 설정합니다. (다음에서 상속됨 DbDataAdapter) |
| FillLoadOption |
어댑터가 LoadOption에서 DataTable을 채우는 방법을 결정하는 DbDataReader을 가져오거나 설정합니다. (다음에서 상속됨 DataAdapter) |
| InsertCommand |
데이터 소스에 새 레코드를 삽입하는 데 사용되는 SQL 문 또는 저장 프로시저를 가져오거나 설정합니다. |
| MissingMappingAction |
들어오는 데이터와 일치하는 테이블이나 열이 없는 경우 수행할 동작을 결정합니다. (다음에서 상속됨 DataAdapter) |
| MissingSchemaAction |
기존 DataSet 스키마가 들어오는 데이터와 일치하지 않는 경우 수행할 동작을 결정합니다. (다음에서 상속됨 DataAdapter) |
| ReturnProviderSpecificTypes |
공급자별 값이나 공용 CLS 규격 값 중에서 |
| SelectCommand |
데이터 소스의 레코드를 선택하는 데 사용하는 SQL 문이나 저장 프로시저를 가져오거나 설정합니다. |
| Site |
Component의 ISite를 가져오거나 설정합니다. (다음에서 상속됨 Component) |
| TableMappings |
원본 테이블과 DataTable간의 기본 매핑을 제공하는 컬렉션을 가져옵니다. (다음에서 상속됨 DataAdapter) |
| UpdateBatchSize |
일괄 작업 처리 지원을 활성화하거나 비활성화하는 값을 가져오거나 설정하고 일괄 작업에서 실행할 수 있는 명령의 수를 지정합니다. (다음에서 상속됨 DbDataAdapter) |
| UpdateCommand |
데이터 소스의 레코드를 업데이트하는 데 사용되는 SQL 문 또는 저장 프로시저를 가져오거나 설정합니다. |
메서드
이벤트
| Disposed |
Dispose() 메서드를 호출하여 구성 요소를 삭제할 때 발생합니다. (다음에서 상속됨 Component) |
| FillError |
채우기 작업 도중에 오류가 발생할 때 반환됩니다. (다음에서 상속됨 DbDataAdapter) |
| RowUpdated |
데이터 소스에 대해 명령이 실행된 후에 Update(DataSet)를 수행하는 동안 발생합니다. 업데이트가 시도되어 이벤트가 발생합니다. |
| RowUpdating |
데이터 소스에 대해 명령이 실행되기 전에 Update(DataSet)를 수행하는 동안 발생합니다. 업데이트가 시도되어 이벤트가 발생합니다. |
명시적 인터페이스 구현
| ICloneable.Clone() |
이 멤버에 대한 설명은 Clone()를 참조하세요. |
| IDataAdapter.TableMappings |
원본 테이블이 데이터 세트 테이블에 매핑되는 방법을 나타내는 컬렉션을 가져옵니다. (다음에서 상속됨 DataAdapter) |
| IDbDataAdapter.DeleteCommand |
이 멤버에 대한 설명은 DeleteCommand를 참조하세요. |
| IDbDataAdapter.InsertCommand |
이 멤버에 대한 설명은 InsertCommand를 참조하세요. |
| IDbDataAdapter.SelectCommand |
이 멤버에 대한 설명은 SelectCommand를 참조하세요. |
| IDbDataAdapter.UpdateCommand |
이 멤버에 대한 설명은 UpdateCommand를 참조하세요. |
적용 대상
추가 정보
.NET
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기