Aracılığıyla paylaş


IDataAdapter.Fill(DataSet) Yöntem

Tanım

adını kullanarak DataSet veri kaynağındakilerle DataSet eşleşecek şekilde içindeki satırları ekler veya güncelleştirir ve adlandırılmış bir DataTable "Tablo" oluşturur.

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

Parametreler

dataSet
DataSet

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

Döndürülenler

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

Açıklamalar

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 mevcut değilse nesneleri oluştururDataTable. Nesne oluştururken DataTable işlem Fill genellikle yalnızca sütun adı meta verilerini oluşturur. Ancak, özelliği olarak AddWithKeyayarlanırsaMissingSchemaAction, uygun birincil anahtarlar ve kısıtlamalar da oluşturulur.

SelectCommand bir OUTER JOIN sonucunu 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.

IDataAdapter bir doldurma DataTablesırasında yinelenen sütunlarla karşılaşırsa, "columnname1", "columnname2", "columnname3" desenini kullanarak ardışık sütunlar için adlar oluşturur. Gelen veriler adsız sütunlar içeriyorsa, "Sütun1", "Sütun2" vb. desenine göre eklenir DataSet . öğesine DataSetbirden çok sonuç kümesi eklendiğinde, her sonuç kümesi ayrı bir tabloya konur. Ek sonuç kümeleri belirtilen tablo adına integral değerleri eklenerek adlandırılır (örneğin, "Tablo", "Tablo1", "Tablo2" vb.). Uygulamalar, bu adlandırma desenleriyle çakışmaların oluşmadığından emin olmak için sütun ve tablo adlarını kullanırken dikkatli olmalıdır.

öğesini doldurmak DataSet için kullanılan SELECT deyimi toplu SQL deyimi gibi birden çok sonuç döndürdüğünde, sonuçlardan biri hata içeriyorsa, ardışık 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, bir .NET Framework veri sağlayıcısı için ve FillSchema uygulaması Fill yalnızca ilk sonuç için şema bilgilerini alır.

Şunlara uygulanır

Ayrıca bkz.