OleDbDataAdapter 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
데이터 원본을 채우고 DataSet 업데이트하는 데 사용되는 데이터 명령 및 데이터베이스 연결 집합을 나타냅니다.
public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable
public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapter
public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")]
public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable
public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable, System.Data.IDbDataAdapter
public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable
public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")>]
type OleDbDataAdapter = class
inherit DbDataAdapter
interface IDataAdapter
interface IDbDataAdapter
interface ICloneable
type OleDbDataAdapter = class
inherit DbDataAdapter
interface IDbDataAdapter
interface IDataAdapter
interface ICloneable
type OleDbDataAdapter = class
inherit DbDataAdapter
interface IDataAdapter
interface IDbDataAdapter
interface ICloneable
Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable
Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapter
Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
- 상속
- 특성
- 구현
예제
다음 예제에서는 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 생성자를 참조하세요.
생성자
| 속성 | Description |
|---|---|
| OleDbDataAdapter() |
OleDbDataAdapter 클래스의 새 인스턴스를 초기화합니다. |
| OleDbDataAdapter(OleDbCommand) |
속성으로 지정된 OleDbDataAdapter 클래스의 OleDbCommand 새 인스턴스를 SelectCommand 초기화합니다. |
| OleDbDataAdapter(String, OleDbConnection) |
를 사용하여 클래스OleDbDataAdapter의 새 인스턴스를 SelectCommand 초기화합니다. |
| OleDbDataAdapter(String, String) |
를 사용하여 클래스OleDbDataAdapter의 새 인스턴스를 SelectCommand 초기화합니다. |
필드
| 속성 | Description |
|---|---|
| DefaultSourceTableName |
개체에서 테이블 매핑에 DataAdapter 사용하는 기본 이름입니다. (다음에서 상속됨 DbDataAdapter) |
속성
| 속성 | 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 문 또는 저장 프로시저를 가져오거나 설정합니다. |
메서드
이벤트
| 속성 | Description |
|---|---|
| Disposed |
구성 요소가 메서드 호출에 Dispose() 의해 삭제될 때 발생합니다. (다음에서 상속됨 Component) |
| FillError |
채우기 작업 중에 오류가 발생할 때 반환됩니다. (다음에서 상속됨 DbDataAdapter) |
| RowUpdated |
Update(DataSet) 데이터 원본에 대해 명령을 실행한 후에 발생합니다. 업데이트 시도가 이루어집니다. 따라서 이벤트가 발생합니다. |
| RowUpdating |
Update(DataSet) 데이터 원본에 대해 명령을 실행하기 전에 발생합니다. 업데이트 시도가 이루어집니다. 따라서 이벤트가 발생합니다. |
명시적 인터페이스 구현
| 속성 | Description |
|---|---|
| ICloneable.Clone() |
이 멤버에 대한 설명은 을 참조하세요 Clone(). |
| IDataAdapter.TableMappings |
원본 테이블이 데이터 세트 테이블에 매핑되는 방법을 나타내는 컬렉션을 가져옵니다. (다음에서 상속됨 DataAdapter) |
| IDbDataAdapter.DeleteCommand |
이 멤버에 대한 설명은 을 참조하세요 DeleteCommand. |
| IDbDataAdapter.InsertCommand |
이 멤버에 대한 설명은 을 참조하세요 InsertCommand. |
| IDbDataAdapter.SelectCommand |
이 멤버에 대한 설명은 을 참조하세요 SelectCommand. |
| IDbDataAdapter.UpdateCommand |
이 멤버에 대한 설명은 을 참조하세요 UpdateCommand. |