IDataAdapter.Fill(DataSet) 메서드

정의

네임스페이스:

System.Data

어셈블리:

netstandard.dll, System.Data.Common.dll

Source:

IDataAdapter.cs

이름을 사용하여 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 및 필요한 경우 스키마로 채울 A입니다.

반환

Int32

에 성공적으로 추가되거나 새로 고쳐진 행 수 DataSet입니다. 행을 반환하지 않는 문의 영향을 받는 행은 포함되지 않습니다.

설명

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

그런 다음, Fill 행을 대상 DataTable 개체에 DataSet추가하여 개체가 아직 없는 경우 해당 개체를 DataTable 만듭니다. 개체를 Fill 만들 DataTable 때 작업은 일반적으로 열 이름 메타데이터만 만듭니다. 그러나 속성이 MissingSchemaAction 설정된 AddWithKey경우 적절한 기본 키와 제약 조건도 생성됩니다.

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

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

일괄 처리 SQL 문과 같은 여러 결과를 채우는 DataSet 데 사용되는 SELECT 문이 결과 중 하나에 오류가 포함된 경우 모든 연속 결과를 건너뛰고 추가 DataSet되지 않습니다.

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

메모

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

추가 정보

• FillSchema(DataSet, SchemaType)