IDataAdapter.Fill(DataSet) 메서드

정의

네임스페이스:

System.Data

어셈블리:

System.Data.Common.dll

DataSet 이름을 사용하여 데이터 소스의 행과 일치하도록 DataSet의 행을 추가하거나 업데이트하고 "Table"이라는 이름의 DataTable을 만듭니다.

public:
 int Fill(System::Data::DataSet ^ dataSet);

public int Fill (System.Data.DataSet dataSet);

abstract member Fill : System.Data.DataSet -> int

Public Function Fill (dataSet As DataSet) As Integer

매개 변수

dataSet

DataSet

레코드와 스키마(필요한 경우)로 채울 DataSet입니다.

반환

Int32

DataSet에 성공적으로 추가했거나 새로 고친 행의 수를 반환합니다. 여기에는 행을 반환하지 않는 문의 영향을 받는 행은 포함되지 않습니다.

설명

Fill 연결 된 지정 된 SELECT 문을 사용 하 여 데이터 원본에서 행을 검색 SelectCommand 속성입니다. SELECT 문과 사용 하 여 연결 된 연결 개체는 유효 해야 합니다. 하지만 열려 있이 필요가 없습니다. 전에 연결이 닫히면 Fill 는 데이터를 검색 하려면을 열고 다음 닫는 하는를 호출 합니다. 연결 하기 전에 열려 있으면 Fill 는 호출을 열린 상태로 유지 합니다.

Fill 작업이 대상에 행 추가 DataTable 개체를 DataSet만들기는 DataTable 경우 이미 없는 개체입니다. 만들면 DataTable 개체는 Fill 작업은 일반적으로 열 이름 메타 데이터만 만듭니다. 그러나 경우 합니다 MissingSchemaAction 속성이 AddWithKey, 적절 한 기본 키와 제약 조건도 만들어집니다.

SelectCommand 가 OUTER JOIN의 결과를 반환하면 DataAdapter 는 결과 PrimaryKey 에 대해 DataTable값을 설정하지 않습니다. 중복 행을 올바르게 확인할 수 있도록 기본 키를 명시적으로 정의 해야 합니다. 자세한 내용은 기본 키 정의합니다.

경우는 IDataAdapter 에서 중복 열을 채우는 동안는 DataTable, 패턴 "columnname1", "columnname2", "columnname3", 및 등을 사용 하 여 연속 열에 대 한 이름을 생성 합니다. 저장 됩니다는 들어오는 데이터에 명명 되지 않은 열을 포함 하는 경우는 DataSet "column1", "Column2" 등에 따라 합니다. 여러 결과 집합에 추가 될 때를 DataSet, 각 결과 집합을 별도 테이블에 저장 됩니다. 추가 결과 집합이 지정한 테이블 이름 (예: "Table", "Table1", "Table2" 및 등)에 정수 값을 추가 하 여 이름이 지정 됩니다. 애플리케이션은 이러한 명명 패턴을 사용 하 여 충돌 하지 않도록 되도록 열 및 테이블 이름을 사용 하는 경우 주의 해야 합니다.

때 채우는 데 사용 되는 SELECT 문은 합니다 DataSet 여러 결과 반환 SQL 문 한 일괄 처리와 같은 결과 중 하나에 오류가 포함 되어 있는 경우 모든 후속 결과 생략 되 고에 추가 되지 않습니다는 DataSet합니다.

사용할 수는 Fill 메서드를 여러 번에 동일한 DataTable입니다. 기본 키가 있는 경우 들어오는 행이 이미 존재 하는 일치 하는 행과 병합 됩니다. 들어오는 행에 추가 된 기본 키가 없으면는 DataTable합니다.

참고

구현의 여러 결과 반환 하는 SQL 문을 일괄 처리할 때 Fill 고 FillSchema .NET Framework 데이터 공급자는 결과 대해서만 첫 번째 스키마 정보를 검색 합니다.

추가 정보

• FillSchema(DataSet, SchemaType)