다음을 통해 공유


DataAdapter.Fill 메서드

정의

데이터 소스의 행과 일치하도록 DataSet의 행을 추가하거나 새로 고칩니다.

오버로드

Fill(DataSet)

데이터 소스의 행과 일치하도록 DataSet의 행을 추가하거나 새로 고칩니다.

Fill(DataTable, IDataReader)

DataTable 이름 및 지정된 DataTable를 사용하여 데이터 소스의 행과 일치하도록 IDataReader의 행을 추가하거나 새로 고칩니다.

Fill(DataTable[], IDataReader, Int32, Int32)

DataTable 개체 컬렉션의 지정된 범위에서 데이터 소스의 행과 일치하도록 행을 추가하거나 새로 고칩니다.

Fill(DataSet, String, IDataReader, Int32, Int32)

DataSetDataSet 이름을 사용하여 지정된 범위에서 데이터 소스의 행과 일치하도록 DataTable의 행을 추가하거나 새로 고칩니다.

Fill(DataSet)

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
DataSet

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

반환

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" 및 등)에 정수 값을 추가 하 여 이름이 지정 됩니다. 열 및 테이블 이름을 사용 하 여 애플리케이션은 이러한 명명 패턴을 사용 하 여 충돌 하지 않도록 확인 해야 합니다.

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

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

참고

여러 결과를 반환하는 일괄 처리 SQL 문을 처리할 때 OLE DB용 .NET Framework 데이터 공급자에 대한 구현 FillSchema 은 첫 번째 결과에 대한 스키마 정보만 검색합니다. 여러 결과에 대한 스키마 정보를 검색하려면 로 설정된 AddWithKeyMissingSchemaAction 함께 를 사용합니다Fill.

추가 정보

적용 대상

Fill(DataTable, IDataReader)

Source:
DataAdapter.cs
Source:
DataAdapter.cs
Source:
DataAdapter.cs

DataTable 이름 및 지정된 DataTable를 사용하여 데이터 소스의 행과 일치하도록 IDataReader의 행을 추가하거나 새로 고칩니다.

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

매개 변수

dataTable
DataTable

레코드로 채울 DataTable입니다.

dataReader
IDataReader

IDataReader의 인스턴스입니다.

반환

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

설명

자세한 내용은 설명을 DataAdapter.Fill(DataSet) 참조하세요.

추가 정보

적용 대상

Fill(DataTable[], IDataReader, Int32, Int32)

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

매개 변수

dataTables
DataTable[]

레코드로 채울 DataTable 개체의 컬렉션입니다.

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

DataSetDataSet 이름을 사용하여 지정된 범위에서 데이터 소스의 행과 일치하도록 DataTable의 행을 추가하거나 새로 고칩니다.

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

매개 변수

dataSet
DataSet

레코드로 채울 DataSet입니다.

srcTable
String

소스 테이블의 이름을 나타내는 문자열입니다.

dataReader
IDataReader

IDataReader의 인스턴스입니다.

startRecord
Int32

레코드 시작의 인덱스(0부터 시작)입니다.

maxRecords
Int32

최대 레코드 수를 나타내는 정수입니다.

반환

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

설명

자세한 내용은 설명을 System.Data.Common.DataAdapter.Fill(System.Data.DataSet) 참조하세요.

추가 정보

적용 대상