DataAdapter.Fill Metod

Definition

Namnområde:: System.Data.Common

Sammansättningar:: netstandard.dll, System.Data.Common.dll

Sammansättning:: System.Data.Common.dll

Sammansättning:: System.Data.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Lägger till eller uppdaterar rader i DataSet för att matcha dem i datakällan.

Överlagringar

Name	Description
Fill(DataSet)	Lägger till eller uppdaterar rader i DataSet för att matcha dem i datakällan.
Fill(DataTable, IDataReader)	Lägger till eller uppdaterar rader i DataTable för att matcha dem i datakällan med hjälp av DataTable namnet och den angivna IDataReader.
Fill(DataTable[], IDataReader, Int32, Int32)	Lägger till eller uppdaterar rader i ett angivet intervall i samlingen med DataTable objekt som matchar dem i datakällan.
Fill(DataSet, String, IDataReader, Int32, Int32)	Lägger till eller uppdaterar rader i ett angivet intervall i DataSet för att matcha dem i datakällan med hjälp av DataSet namnen och DataTable .

Fill(DataSet)

Källa:: DataAdapter.cs

Källa:: DataAdapter.cs

Källa:: DataAdapter.cs

Källa:: DataAdapter.cs

Källa:: DataAdapter.cs

Lägger till eller uppdaterar rader i DataSet för att matcha dem i datakällan.

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

Parametrar

dataSet: DataSet

A DataSet för att fylla med poster och, om det behövs, schema.

Returer

Int32

Antalet rader som har lagts till eller uppdaterats i DataSet. Detta inkluderar inte rader som påverkas av instruktioner som inte returnerar rader.

Implementeringar

Fill(DataSet)

Kommentarer

Metoden Fill hämtar rader från datakällan med hjälp av SELECT-instruktionen som anges av en associerad SelectCommand egenskap. Anslutningsobjektet som är associerat med SELECT-instruktionen måste vara giltigt, men det behöver inte vara öppet. Om anslutningen stängs innan Fill anropas öppnas den för att hämta data och stängs sedan. Om anslutningen är öppen innan Fill anropas förblir den öppen.

Åtgärden Fill lägger sedan till raderna i målobjekten DataTable DataSeti , vilket skapar objekten DataTable om de inte redan finns. När du skapar DataTable objekt Fill skapar åtgärden normalt endast metadata för kolumnnamn. Men om egenskapen MissingSchemaAction är inställd på AddWithKeyskapas även lämpliga primära nycklar och begränsningar.

Om SelectCommand returnerar resultatet av en OUTER JOIN, anger inte DataAdapter ett PrimaryKey värde för den resulterande DataTable. Du måste uttryckligen definiera den primära nyckeln för att säkerställa att dubbletter av rader matchas korrekt. Mer information finns i Definiera primära nycklar.

Om datakortet stöter på dubblettkolumner när du fyller i en DataTablegenereras namn för efterföljande kolumner med hjälp av mönstret "columnname1", "columnname2", "columnname3" och så vidare. Om inkommande data innehåller icke namngivna kolumner placeras de i DataSet enligt mönstret "Column1", "Column2" och så vidare. När flera resultatuppsättningar läggs till i varje DataSet resultatuppsättning placeras i en separat tabell. Ytterligare resultatuppsättningar namnges genom att integralvärden läggs till i det angivna tabellnamnet (till exempel "Tabell", "Table1", "Table2" och så vidare). Program som använder kolumn- och tabellnamn bör se till att konflikter med dessa namngivningsmönster inte inträffar.

När SELECT-instruktionen som används för att fylla i DataSet returnerar flera resultat, till exempel en BATCH SQL-instruktion, om ett av resultaten innehåller ett fel, hoppas alla efterföljande resultat över och läggs inte till i DataSet.

Du kan använda Fill metoden flera gånger på samma DataTable. Om det finns en primärnyckel sammanfogas inkommande rader med matchande rader som redan finns. Om det inte finns någon primärnyckel läggs inkommande rader till i DataTable.

Note

När du hanterar batch-SQL-instruktioner som returnerar flera resultat hämtar implementeringen av FillSchema för .NET Framework-Data Provider för OLE DB schemainformation för endast det första resultatet. Om du vill hämta schemainformation för flera resultat använder du Fill med inställningen MissingSchemaAction till AddWithKey.

Se även

Gäller för

Fill(DataTable, IDataReader)

Källa:: DataAdapter.cs

Källa:: DataAdapter.cs

Källa:: DataAdapter.cs

Källa:: DataAdapter.cs

Källa:: DataAdapter.cs

Lägger till eller uppdaterar rader i DataTable för att matcha dem i datakällan med hjälp av DataTable namnet och den angivna 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

Parametrar

dataTable: DataTable

A DataTable att fylla med poster.

dataReader: IDataReader

En instans av IDataReader.

Returer

Int32

Antalet rader som har lagts till eller uppdaterats i DataTable. Detta inkluderar inte rader som påverkas av instruktioner som inte returnerar rader.

Kommentarer

Mer information finns i kommentarerna DataAdapter.Fill(DataSet) .

Se även

översikt över ADO.NET

Gäller för

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

Källa:: DataAdapter.cs

Källa:: DataAdapter.cs

Källa:: DataAdapter.cs

Källa:: DataAdapter.cs

Källa:: DataAdapter.cs

Lägger till eller uppdaterar rader i ett angivet intervall i samlingen med DataTable objekt som matchar dem i datakällan.

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

Parametrar

dataTables: DataTable[]

En samling DataTable objekt som ska fyllas med poster.

dataReader: IDataReader

En instans av IDataReader.

startRecord: Int32

Startpostens nollbaserade index.

maxRecords: Int32

Ett heltal som anger det maximala antalet poster.

Returer

Int32

Antalet rader som har lagts till eller uppdaterats i DataTable. Detta inkluderar inte rader som påverkas av instruktioner som inte returnerar rader.

Kommentarer

Mer information finns i kommentarerna System.Data.Common.DataAdapter.Fill(System.Data.DataSet) .

Se även

översikt över ADO.NET

Gäller för

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

Källa:: DataAdapter.cs

Källa:: DataAdapter.cs

Källa:: DataAdapter.cs

Källa:: DataAdapter.cs

Källa:: DataAdapter.cs

Lägger till eller uppdaterar rader i ett angivet intervall i DataSet för att matcha dem i datakällan med hjälp av DataSet namnen och 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

Parametrar

dataSet: DataSet

A DataSet att fylla med poster.

srcTable: String

En sträng som anger namnet på källtabellen.

dataReader: IDataReader

En instans av IDataReader.

startRecord: Int32

Startpostens nollbaserade index.

maxRecords: Int32

Ett heltal som anger det maximala antalet poster.

Returer

Int32

Antalet rader som har lagts till eller uppdaterats i DataSet. Detta inkluderar inte rader som påverkas av instruktioner som inte returnerar rader.

Kommentarer

Mer information finns i kommentarerna System.Data.Common.DataAdapter.Fill(System.Data.DataSet) .

Se även

översikt över ADO.NET

Gäller för

Feedback

Var den här sidan till hjälp?