DataAdapter.Fill Yöntem

Tanım

veri kaynağındakilerle eşleşecek şekilde içindeki DataSet satırları ekler veya yeniler.

Aşırı Yüklemeler

Fill(DataSet)

veri kaynağındakilerle eşleşecek şekilde içindeki DataSet satırları ekler veya yeniler.

Fill(DataTable, IDataReader)

adını ve belirtilen IDataReaderöğesini kullanarak DataTable veri kaynağındakilerle eşleşecek şekilde içindeki satırlarını DataTable ekler veya yeniler.

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

Veri kaynağındakilerle eşleşecek şekilde nesne koleksiyonundaki DataTable belirli bir aralıktaki satırları ekler veya yeniler.

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

ve DataTable adlarını kullanarak DataSet veri kaynağındakilerle eşleşecek şekilde belirtilen aralıktaki DataSet satırları ekler veya yeniler.

Fill(DataSet)

Kaynak:
DataAdapter.cs
Kaynak:
DataAdapter.cs
Kaynak:
DataAdapter.cs

veri kaynağındakilerle eşleşecek şekilde içindeki DataSet satırları ekler veya yeniler.

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

Parametreler

dataSet
DataSet

Kayıtlarla ve gerekirse şemayla doldurmak için A DataSet .

Döndürülenler

içine başarıyla eklenen veya yenilenen DataSetsatır sayısı. Bu, satır döndürmeyen deyimlerin etkilediği satırları içermez.

Uygulamalar

Açıklamalar

yöntemi, Fill ilişkili SelectCommand bir özellik tarafından belirtilen SELECT deyimini kullanarak veri kaynağından satırları alır. SELECT deyimiyle ilişkilendirilmiş bağlantı nesnesinin geçerli olması gerekir, ancak açık olması gerekmez. Bağlantı çağrılmadan önce Fill kapatılırsa, verileri almak için açılır ve ardından kapatılır. Bağlantı çağrılmadan önce Fill açıksa açık kalır.

İşlem Fill daha sonra satırları içindeki DataSethedef DataTable nesnelere ekler ve henüz yoksa nesneleri oluştururDataTable. Nesneleri oluştururken DataTable işlem Fill normalde yalnızca sütun adı meta verileri oluşturur. Ancak, özelliği olarak AddWithKeyayarlanırsaMissingSchemaAction, uygun birincil anahtarlar ve kısıtlamalar da oluşturulur.

bir SelectCommand OUTER JOIN'in sonuçlarını döndürürse, DataAdapter sonucu DataTableiçin bir PrimaryKey değer ayarlamaz. Yinelenen satırların doğru çözümlenmesi için birincil anahtarı açıkça tanımlamanız gerekir. Daha fazla bilgi için bkz. Birincil Anahtarları Tanımlama.

Veri bağdaştırıcısı bir DataTabledoldurma sırasında yinelenen sütunlarla karşılaşırsa, "columnname1", "columnname2", "columnname3" desenini kullanarak sonraki sütunlar için adlar oluşturur. Gelen veriler adlandırılmamış sütunlar içeriyorsa, "Sütun1", "Sütun2" vb. desenine göre içine yerleştirilir DataSet . Her sonuç kümesine DataSet birden çok sonuç kümesi eklendiğinde ayrı bir tabloya yerleştirilir. Ek sonuç kümeleri, belirtilen tablo adına integral değerleri eklenerek adlandırılır (örneğin, "Tablo", "Tablo1", "Tablo2" vb.). Sütun ve tablo adlarını kullanan uygulamalar, bu adlandırma desenleriyle çakışmaların oluşmadığından emin olmalıdır.

öğesini doldurmak DataSet için kullanılan SELECT deyimi toplu SQL deyimleri gibi birden çok sonuç döndürdüğünde, sonuçlardan biri hata içeriyorsa, sonraki tüm sonuçlar atlanır ve öğesine DataSeteklenmez.

yöntemini aynı DataTableüzerinde birden çok kez kullanabilirsinizFill. Birincil anahtar varsa, gelen satırlar zaten var olan eşleşen satırlarla birleştirilir. Birincil anahtar yoksa, gelen satırlar öğesine DataTableeklenir.

Not

Birden çok sonuç döndüren batch SQL deyimlerini işlerken, OLE DB için .NET Framework Veri Sağlayıcısı'nın uygulaması FillSchema yalnızca ilk sonuç için şema bilgilerini alır. Birden çok sonucun şema bilgilerini almak için, Fill ile değerini MissingSchemaAction olarak AddWithKeyayarlayın.

Ayrıca bkz.

Şunlara uygulanır

Fill(DataTable, IDataReader)

Kaynak:
DataAdapter.cs
Kaynak:
DataAdapter.cs
Kaynak:
DataAdapter.cs

adını ve belirtilen IDataReaderöğesini kullanarak DataTable veri kaynağındakilerle eşleşecek şekilde içindeki satırlarını DataTable ekler veya yeniler.

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

Parametreler

dataTable
DataTable

Kayıtlarla doldurulacak A DataTable .

dataReader
IDataReader

IDataReader öğesinin bir örneği.

Döndürülenler

içine başarıyla eklenen veya yenilenen DataTablesatır sayısı. Bu, satır döndürmeyen deyimlerin etkilediği satırları içermez.

Açıklamalar

Ek bilgi için DataAdapter.Fill(DataSet) açıklamalara bakın.

Ayrıca bkz.

Şunlara uygulanır

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

Kaynak:
DataAdapter.cs
Kaynak:
DataAdapter.cs
Kaynak:
DataAdapter.cs

Veri kaynağındakilerle eşleşecek şekilde nesne koleksiyonundaki DataTable belirli bir aralıktaki satırları ekler veya yeniler.

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

Parametreler

dataTables
DataTable[]

Kayıtlarla doldurulacak nesne koleksiyonu DataTable .

dataReader
IDataReader

IDataReader öğesinin bir örneği.

startRecord
Int32

Başlangıç kaydının sıfır tabanlı dizini.

maxRecords
Int32

Kayıt sayısı üst sınırını gösteren bir tamsayı.

Döndürülenler

içine başarıyla eklenen veya yenilenen DataTablesatır sayısı. Bu, satır döndürmeyen deyimlerin etkilediği satırları içermez.

Açıklamalar

Ek bilgi için System.Data.Common.DataAdapter.Fill(System.Data.DataSet) açıklamalara bakın.

Ayrıca bkz.

Şunlara uygulanır

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

Kaynak:
DataAdapter.cs
Kaynak:
DataAdapter.cs
Kaynak:
DataAdapter.cs

ve DataTable adlarını kullanarak DataSet veri kaynağındakilerle eşleşecek şekilde belirtilen aralıktaki DataSet satırları ekler veya yeniler.

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

Parametreler

dataSet
DataSet

Kayıtlarla doldurulacak A DataSet .

srcTable
String

Kaynak tablonun adını gösteren dize.

dataReader
IDataReader

IDataReader öğesinin bir örneği.

startRecord
Int32

Başlangıç kaydının sıfır tabanlı dizini.

maxRecords
Int32

Kayıt sayısı üst sınırını gösteren bir tamsayı.

Döndürülenler

içine başarıyla eklenen veya yenilenen DataSetsatır sayısı. Bu, satır döndürmeyen deyimlerin etkilediği satırları içermez.

Açıklamalar

Ek bilgi için System.Data.Common.DataAdapter.Fill(System.Data.DataSet) açıklamalara bakın.

Ayrıca bkz.

Şunlara uygulanır