OleDbDataAdapter 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
데이터 원본을 채우고 DataSet 업데이트하는 데 사용되는 데이터 명령 및 데이터베이스 연결 집합을 나타냅니다.
public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapterpublic ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneablepublic sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable, System.Data.IDbDataAdapterpublic sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneabletype OleDbDataAdapter = class
inherit DbDataAdapter
interface IDbDataAdapter
interface IDataAdapter
interface ICloneablePublic NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapterPublic NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable- 상속
- 구현
예제
다음 예제에서는 OleDbCommandAccess OleDbDataAdapterOleDbConnection데이터 원본에서 레코드를 선택하고 선택한 행으로 채웁 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
채우기가 OleDbDataAdapterDataSet완료되면 반환된 데이터에 대한 적절한 테이블과 열이 아직 없는 경우 만들어집니다. 그러나 기본 키 정보는 속성을 MissingSchemaAction설정하지 않는 한 암시적으로 생성된 스키마에 AddWithKey 포함되지 않습니다. 를 OleDbDataAdapter 사용하여 DataSet데이터로 채우기 전에 기본 키 정보를 포함하여 스키마FillSchema를 만들 수도 있습니다. 자세한 내용은 데이터 세트에 기존 제약 조건 추가를 참조하세요.
MSDataShape 공급자를 비롯한 일부 OLE DB 공급자는 기본 테이블 또는 기본 키 정보를 반환하지 않습니다. 따라서 OleDbDataAdapter 만든 PrimaryKey속성에서 DataTable 속성을 올바르게 설정할 수 없습니다. 이러한 경우 .에서 테이블 DataSet의 기본 키를 명시적으로 지정해야 합니다.
OleDbDataAdapter 또한 데이터의 로드 및 업데이트를 용이하게 하는 , SelectCommandInsertCommand, DeleteCommand및 UpdateCommand 속성도 포함됩니다TableMappings.
인스턴스 OleDbDataAdapter를 만들면 속성이 초기 값으로 설정됩니다. 이러한 값의 목록은 OleDbDataAdapter 생성자를 참조하세요.
생성자
| Name | Description |
|---|---|
| OleDbDataAdapter() |
OleDbDataAdapter 클래스의 새 인스턴스를 초기화합니다. |
| OleDbDataAdapter(OleDbCommand) |
속성으로 지정된 OleDbDataAdapter 클래스의 OleDbCommand 새 인스턴스를 SelectCommand 초기화합니다. |
| OleDbDataAdapter(String, OleDbConnection) |
를 사용하여 클래스OleDbDataAdapter의 새 인스턴스를 SelectCommand 초기화합니다. |
| OleDbDataAdapter(String, String) |
를 사용하여 클래스OleDbDataAdapter의 새 인스턴스를 SelectCommand 초기화합니다. |
필드
| Name | Description |
|---|---|
| DefaultSourceTableName |
개체에서 테이블 매핑에 DataAdapter 사용하는 기본 이름입니다. (다음에서 상속됨 DbDataAdapter) |
속성
| Name | Description |
|---|---|
| AcceptChangesDuringFill |
AcceptChanges() 작업 중에 추가 DataRow 된 후 호출 DataTable 되는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 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 어댑터를 채우는 DataTableDbDataReader방법을 결정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 DataAdapter) |
| InsertCommand |
데이터 원본에 새 레코드를 삽입하는 데 사용되는 SQL 문 또는 저장 프로시저를 가져오거나 설정합니다. |
| MissingMappingAction |
들어오는 데이터에 일치하는 테이블 또는 열이 없는 경우 수행할 작업을 결정합니다. (다음에서 상속됨 DataAdapter) |
| MissingSchemaAction |
기존 DataSet 스키마가 들어오는 데이터와 일치하지 않을 때 수행할 작업을 결정합니다. (다음에서 상속됨 DataAdapter) |
| ReturnProviderSpecificTypes |
메서드가 |
| SelectCommand |
데이터 원본에서 레코드를 선택하는 데 사용되는 SQL 문 또는 저장 프로시저를 가져오거나 설정합니다. |
| Site |
ISite를 가져오거나 Component의 값을 설정합니다. (다음에서 상속됨 Component) |
| TableMappings |
원본 테이블과 DataTable. (다음에서 상속됨 DataAdapter) |
| UpdateBatchSize |
일괄 처리 지원을 사용하거나 사용하지 않도록 설정하는 값을 가져오거나 설정하며 일괄 처리에서 실행할 수 있는 명령 수를 지정합니다. (다음에서 상속됨 DbDataAdapter) |
| UpdateCommand |
데이터 원본의 레코드를 업데이트하는 데 사용되는 SQL 문 또는 저장 프로시저를 가져오거나 설정합니다. |
메서드
이벤트
| Name | Description |
|---|---|
| Disposed |
구성 요소가 메서드 호출에 Dispose() 의해 삭제될 때 발생합니다. (다음에서 상속됨 Component) |
| FillError |
채우기 작업 중에 오류가 발생할 때 반환됩니다. (다음에서 상속됨 DbDataAdapter) |
| RowUpdated |
Update(DataSet) 데이터 원본에 대해 명령을 실행한 후에 발생합니다. 업데이트 시도가 이루어집니다. 따라서 이벤트가 발생합니다. |
| RowUpdating |
Update(DataSet) 데이터 원본에 대해 명령을 실행하기 전에 발생합니다. 업데이트 시도가 이루어집니다. 따라서 이벤트가 발생합니다. |
명시적 인터페이스 구현
| Name | Description |
|---|---|
| ICloneable.Clone() |
이 멤버에 대한 설명은 을 참조하세요 Clone(). |
| IDataAdapter.TableMappings |
원본 테이블이 데이터 세트 테이블에 매핑되는 방법을 나타내는 컬렉션을 가져옵니다. (다음에서 상속됨 DataAdapter) |
| IDbDataAdapter.DeleteCommand |
이 멤버에 대한 설명은 을 참조하세요 DeleteCommand. |
| IDbDataAdapter.InsertCommand |
이 멤버에 대한 설명은 을 참조하세요 InsertCommand. |
| IDbDataAdapter.SelectCommand |
이 멤버에 대한 설명은 을 참조하세요 SelectCommand. |
| IDbDataAdapter.UpdateCommand |
이 멤버에 대한 설명은 을 참조하세요 UpdateCommand. |