OdbcDataAdapter 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
DataSet 를 채우고 데이터 원본을 업데이트하는 데 사용되는 데이터 원본 연결 및 데이터 명령 집합을 나타냅니다. 이 클래스는 상속될 수 없습니다.
public ref class OdbcDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneablepublic ref class OdbcDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapterpublic ref class OdbcDataAdapter sealed : System::Data::Common::DbDataAdapterpublic sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapter, ICloneablepublic sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapter, ICloneable, System.Data.IDbDataAdapterpublic sealed class OdbcDataAdapter : System.Data.Common.DbDataAdaptertype OdbcDataAdapter = class
inherit DbDataAdapter
interface IDataAdapter
interface IDbDataAdapter
interface ICloneabletype OdbcDataAdapter = class
inherit DbDataAdapter
interface IDbDataAdapter
interface IDataAdapter
interface ICloneablePublic NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements ICloneablePublic NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapterPublic NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter- 상속
- 구현
예제
다음 예제에서는 , OdbcDataAdapter및 OdbcConnection 를 사용하여 OdbcCommand레코드를 선택하고 선택한 행으로 을 채웁 DataSet 니다.
public DataSet GetDataSetFromAdapter(
DataSet dataSet, string connectionString, string queryString)
{
using (OdbcConnection connection =
new OdbcConnection(connectionString))
{
OdbcDataAdapter adapter =
new OdbcDataAdapter(queryString, connection);
// Open the connection and fill the DataSet.
try
{
connection.Open();
adapter.Fill(dataSet);
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
// The connection is automatically closed when the
// code exits the using block.
}
return dataSet;
}
Public Function GetDataSetFromAdapter( _
ByVal dataSet As DataSet, ByVal connectionString As String, _
ByVal queryString As String) As DataSet
Using connection As New OdbcConnection(connectionString)
Dim adapter As New OdbcDataAdapter(queryString, connection)
' Open the connection and fill the DataSet.
Try
connection.Open()
adapter.Fill(dataSet)
Catch ex As Exception
Console.WriteLine(ex.Message)
End Try
' The connection is automatically closed when the
' code exits the Using block.
End Using
Return dataSet
End Function
설명
는 OdbcDataAdapter 데이터를 검색하고 저장하기 위한 와 데이터 원본 간의 DataSet 브리지 역할을 합니다. 는 OdbcDataAdapter 를 사용하여 Fill 데이터 원본 DataSet의 데이터를 로 로드하고 를 사용하여 Update 에서 변경한 DataSet 내용을 데이터 원본으로 다시 전송하여 이 브리지를 제공합니다.
이 OdbcDataAdapter 를 채우 DataSet면 반환된 데이터에 필요한 테이블과 열이 아직 없는 경우 만듭니다. 그러나 기본 키 정보는 속성이 로 설정AddWithKey되지 않는 한 암시적으로 생성된 스키마에 MissingSchemaAction 포함되지 않습니다. 를 사용하여 데이터로 OdbcDataAdapter 채우기 전에 기본 키 정보를 포함하여 의 DataSet스키마를 만들 수도 FillSchema있습니다. 자세한 내용은 기존 제약 조건 데이터 세트에 추가를 참조하세요.
참고
기본 키 열이 없는 데이터 원본에서 메서드를 호출 Fill 하면 는 OdbcDataAdapter 고유 제약 조건 열을 기본 키로 승격하려고 시도합니다. 이 프로세스에서 는 OdbcDataAdapter 고유 제약 조건을 nullable이 아닌 것으로 표시합니다. 이 동작은 고유 제약 조건 열에 null 값이 없는 한 작동합니다. null 값이 있는 경우 메서드가 Fill 제약 조건 위반으로 실패합니다. 이 상황을 방지하려면 고유 제약 조건 열에서 null 값을 허용하지 않습니다.
참고
네이티브 ODBC 드라이버의 제한 사항으로 인해 를 호출FillSchema할 때 하나 DataTable 만 반환됩니다. 여러 DataTable 개체가 예상되는 SQL 일괄 처리 문을 실행하는 경우에도 마찬가지입니다.
OdbcDataAdapter 에는 데이터 로드 및 업데이트를 용이하게 하는 , InsertCommandDeleteCommand, UpdateCommand, 및 TableMappings 속성도 포함됩니다SelectCommand.
생성자
| OdbcDataAdapter() |
OdbcDataAdapter 클래스의 새 인스턴스를 초기화합니다. |
| OdbcDataAdapter(OdbcCommand) |
지정된 SQL SELECT 문을 사용하여 OdbcDataAdapter 클래스의 새 인스턴스를 초기화합니다. |
| OdbcDataAdapter(String, OdbcConnection) |
SQL SELECT 문 및 OdbcDataAdapter을 사용하여 OdbcConnection 클래스의 새 인스턴스를 초기화합니다. |
| OdbcDataAdapter(String, String) |
SQL SELECT 문과 연결 문자열을 사용하여 OdbcDataAdapter 클래스의 새 인스턴스를 초기화합니다. |
필드
| 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 |
데이터 소스에 대해 명령이 실행된 후에 업데이트 작업을 수행하는 동안 발생합니다. |
| RowUpdating |
데이터 소스에 대해 명령이 실행되기 전에 Update(DataSet)를 수행하는 동안 발생합니다. |
명시적 인터페이스 구현
| ICloneable.Clone() |
이 멤버에 대한 설명은 Clone()를 참조하세요. |
| IDataAdapter.TableMappings |
원본 테이블이 데이터 세트 테이블에 매핑되는 방법을 나타내는 컬렉션을 가져옵니다. (다음에서 상속됨 DataAdapter) |
| IDbDataAdapter.DeleteCommand |
이 멤버에 대한 설명은 DeleteCommand를 참조하세요. |
| IDbDataAdapter.InsertCommand |
이 멤버에 대한 설명은 InsertCommand를 참조하세요. |
| IDbDataAdapter.SelectCommand |
이 멤버에 대한 설명은 SelectCommand를 참조하세요. |
| IDbDataAdapter.UpdateCommand |
이 멤버에 대한 설명은 UpdateCommand를 참조하세요. |
적용 대상
추가 정보
.NET