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.

C#
public virtual int Fill (System.Data.DataSet dataSet);
C#
public abstract int Fill (System.Data.DataSet dataSet);

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

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.

C#
protected virtual int Fill (System.Data.DataTable dataTable, System.Data.IDataReader dataReader);

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

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.

C#
protected virtual int Fill (System.Data.DataTable[] dataTables, System.Data.IDataReader dataReader, int startRecord, int maxRecords);

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

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.

C#
protected virtual int Fill (System.Data.DataSet dataSet, string srcTable, System.Data.IDataReader dataReader, int startRecord, int maxRecords);

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1