DataAdapter.Fill 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
데이터 원본의 행과 DataSet 일치하도록 행을 추가하거나 새로 고칩니다.
오버로드
| Name | Description |
|---|---|
| Fill(DataSet) |
데이터 원본의 행과 DataSet 일치하도록 행을 추가하거나 새로 고칩니다. |
| Fill(DataTable, IDataReader) |
이름 및 지정된 IDataReader행을 DataTable 사용하여 데이터 원본의 행과 일치하도록 행을 DataTable 추가하거나 새로 고칩니다. |
| Fill(DataTable[], IDataReader, Int32, Int32) |
데이터 원본의 행과 일치하도록 개체 컬렉션의 DataTable 지정된 범위에서 행을 추가하거나 새로 고칩니다. |
| Fill(DataSet, String, IDataReader, Int32, Int32) |
지정한 범위 DataSet 의 행을 추가하거나 새로 고쳐서 데이터 원본의 행과 일치하는 행 및 DataTable 이름을 사용합니다DataSet. |
Fill(DataSet)
- Source:
- DataAdapter.cs
- Source:
- DataAdapter.cs
- Source:
- DataAdapter.cs
- Source:
- DataAdapter.cs
- Source:
- DataAdapter.cs
데이터 원본의 행과 DataSet 일치하도록 행을 추가하거나 새로 고칩니다.
public:
virtual int Fill(System::Data::DataSet ^ dataSet);
public:
abstract int Fill(System::Data::DataSet ^ dataSet);
public virtual int Fill(System.Data.DataSet dataSet);
public abstract int Fill(System.Data.DataSet dataSet);
abstract member Fill : System.Data.DataSet -> int
override this.Fill : System.Data.DataSet -> int
abstract member Fill : System.Data.DataSet -> int
Public Overridable Function Fill (dataSet As DataSet) As Integer
Public MustOverride Function Fill (dataSet As DataSet) As Integer
매개 변수
반환
에 성공적으로 추가되거나 새로 고쳐진 행 수 DataSet입니다. 행을 반환하지 않는 문의 영향을 받는 행은 포함되지 않습니다.
구현
설명
이 메서드는 Fill 연결된 SelectCommand 속성에 지정된 SELECT 문을 사용하여 데이터 원본에서 행을 검색합니다. SELECT 문과 연결된 연결 개체는 유효해야 하지만 열 필요는 없습니다. 연결이 호출되기 전에 Fill 닫힌 경우 데이터를 검색하기 위해 연 다음 닫힙니다. 연결이 호출되기 전에 Fill 열려 있으면 열린 상태로 유지됩니다.
그런 다음, Fill 행을 대상 DataTable 개체에 DataSet추가하여 개체가 아직 없는 경우 해당 개체를 DataTable 만듭니다. 개체를 Fill 만들 DataTable 때 작업은 일반적으로 열 이름 메타데이터만 만듭니다. 그러나 속성이 MissingSchemaAction 설정된 AddWithKey경우 적절한 기본 키와 제약 조건도 생성됩니다.
SelectCommand가 OUTER JOIN 결과를 반환하는 경우, DataAdapter는 생성된 PrimaryKey에 대해 DataTable 값을 설정하지 않습니다. 중복 행이 올바르게 확인되도록 기본 키를 명시적으로 정의해야 합니다. 자세한 내용은 기본 키 정의합니다.
데이터 어댑터가 채우는 DataTable동안 중복 열이 발견되면 "columnname1", "columnname2", "columnname3" 등의 패턴을 사용하여 후속 열의 이름을 생성합니다. 들어오는 데이터에 명명되지 않은 열이 포함된 경우 "Column1", "Column2" 등의 패턴에 따라 배치 DataSet 됩니다. 각 결과 집합에 여러 결과 집합이 DataSet 추가되면 별도의 테이블에 배치됩니다. 지정된 테이블 이름(예: "Table", "Table1", "Table2" 등)에 정수 값을 추가하여 추가 결과 집합의 이름을 지정합니다. 열 및 테이블 이름을 사용하는 애플리케이션은 이러한 명명 패턴과의 충돌이 발생하지 않도록 해야 합니다.
일괄 처리 SQL 문과 같은 여러 결과를 채우는 DataSet 데 사용되는 SELECT 문이 결과 중 하나에 오류가 포함된 경우 모든 후속 결과를 건너뛰고 추가 DataSet되지 않습니다.
메서드를 Fill 동일한 DataTable방법으로 여러 번 사용할 수 있습니다. 기본 키가 있는 경우 들어오는 행은 이미 존재하는 일치하는 행과 병합됩니다. 기본 키가 없으면 들어오는 행이 에 추가됩니다 DataTable.
메모
여러 결과를 FillSchema 반환하는 일괄 처리 SQL 문을 처리할 때 .NET Framework Data Provider for OLE DB 구현은 첫 번째 결과에 대한 스키마 정보만 검색합니다. 여러 결과에 대한 스키마 정보를 검색하려면 다음 집합AddWithKey과 함께 MissingSchemaAction 사용합니다Fill.
추가 정보
적용 대상
Fill(DataTable, IDataReader)
- Source:
- DataAdapter.cs
- Source:
- DataAdapter.cs
- Source:
- DataAdapter.cs
- Source:
- DataAdapter.cs
- Source:
- DataAdapter.cs
이름 및 지정된 IDataReader행을 DataTable 사용하여 데이터 원본의 행과 일치하도록 행을 DataTable 추가하거나 새로 고칩니다.
protected:
virtual int Fill(System::Data::DataTable ^ dataTable, System::Data::IDataReader ^ dataReader);
protected virtual int Fill(System.Data.DataTable dataTable, System.Data.IDataReader dataReader);
abstract member Fill : System.Data.DataTable * System.Data.IDataReader -> int
override this.Fill : System.Data.DataTable * System.Data.IDataReader -> int
Protected Overridable Function Fill (dataTable As DataTable, dataReader As IDataReader) As Integer
매개 변수
- dataReader
- IDataReader
IDataReader인스턴스입니다.
반환
에 성공적으로 추가되거나 새로 고쳐진 행 수 DataTable입니다. 행을 반환하지 않는 문의 영향을 받는 행은 포함되지 않습니다.
설명
자세한 내용은 비고를 참조하세요 DataAdapter.Fill(DataSet) .
추가 정보
적용 대상
Fill(DataTable[], IDataReader, Int32, Int32)
- Source:
- DataAdapter.cs
- Source:
- DataAdapter.cs
- Source:
- DataAdapter.cs
- Source:
- DataAdapter.cs
- Source:
- DataAdapter.cs
데이터 원본의 행과 일치하도록 개체 컬렉션의 DataTable 지정된 범위에서 행을 추가하거나 새로 고칩니다.
protected:
virtual int Fill(cli::array <System::Data::DataTable ^> ^ dataTables, System::Data::IDataReader ^ dataReader, int startRecord, int maxRecords);
protected virtual int Fill(System.Data.DataTable[] dataTables, System.Data.IDataReader dataReader, int startRecord, int maxRecords);
abstract member Fill : System.Data.DataTable[] * System.Data.IDataReader * int * int -> int
override this.Fill : System.Data.DataTable[] * System.Data.IDataReader * int * int -> int
Protected Overridable Function Fill (dataTables As DataTable(), dataReader As IDataReader, startRecord As Integer, maxRecords As Integer) As Integer
매개 변수
- dataReader
- IDataReader
IDataReader인스턴스입니다.
- startRecord
- Int32
시작 레코드의 인덱스(0부터 시작)입니다.
- maxRecords
- Int32
최대 레코드 수를 나타내는 정수입니다.
반환
에 성공적으로 추가되거나 새로 고쳐진 행 수 DataTable입니다. 행을 반환하지 않는 문의 영향을 받는 행은 포함되지 않습니다.
설명
자세한 내용은 비고를 참조하세요 System.Data.Common.DataAdapter.Fill(System.Data.DataSet) .
추가 정보
적용 대상
Fill(DataSet, String, IDataReader, Int32, Int32)
- Source:
- DataAdapter.cs
- Source:
- DataAdapter.cs
- Source:
- DataAdapter.cs
- Source:
- DataAdapter.cs
- Source:
- DataAdapter.cs
protected:
virtual int Fill(System::Data::DataSet ^ dataSet, System::String ^ srcTable, System::Data::IDataReader ^ dataReader, int startRecord, int maxRecords);
protected virtual int Fill(System.Data.DataSet dataSet, string srcTable, System.Data.IDataReader dataReader, int startRecord, int maxRecords);
abstract member Fill : System.Data.DataSet * string * System.Data.IDataReader * int * int -> int
override this.Fill : System.Data.DataSet * string * System.Data.IDataReader * int * int -> int
Protected Overridable Function Fill (dataSet As DataSet, srcTable As String, dataReader As IDataReader, startRecord As Integer, maxRecords As Integer) As Integer
매개 변수
- srcTable
- String
원본 테이블의 이름을 나타내는 문자열입니다.
- dataReader
- IDataReader
IDataReader인스턴스입니다.
- startRecord
- Int32
시작 레코드의 인덱스(0부터 시작)입니다.
- maxRecords
- Int32
최대 레코드 수를 나타내는 정수입니다.
반환
에 성공적으로 추가되거나 새로 고쳐진 행 수 DataSet입니다. 행을 반환하지 않는 문의 영향을 받는 행은 포함되지 않습니다.
설명
자세한 내용은 비고를 참조하세요 System.Data.Common.DataAdapter.Fill(System.Data.DataSet) .