DataAdapter.Fill Methode

Definitie

Naamruimte:: System.Data.Common

Assembly's:: netstandard.dll, System.Data.Common.dll

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee worden rijen in de DataSet rijen toegevoegd of vernieuwd die overeenkomen met de rijen in de gegevensbron.

Overloads

Name	Description
Fill(DataSet)	Hiermee worden rijen in de DataSet rijen toegevoegd of vernieuwd die overeenkomen met de rijen in de gegevensbron.
Fill(DataTable, IDataReader)	Voegt rijen toe of vernieuwt in de DataTable rijen die overeenkomen met de rijen in de gegevensbron met behulp van de DataTable naam en de opgegeven IDataReader.
Fill(DataTable[], IDataReader, Int32, Int32)	Hiermee worden rijen in een opgegeven bereik toegevoegd of vernieuwd in de verzameling DataTable objecten die overeenkomen met die in de gegevensbron.
Fill(DataSet, String, IDataReader, Int32, Int32)	Hiermee worden rijen in een opgegeven bereik toegevoegd of vernieuwd, DataSet zodat deze overeenkomen met rijen in de gegevensbron met behulp van de DataSet en DataTable namen.

Fill(DataSet)

Bron:: DataAdapter.cs

Bron:: DataAdapter.cs

Bron:: DataAdapter.cs

Bron:: DataAdapter.cs

Bron:: DataAdapter.cs

Hiermee worden rijen in de DataSet rijen toegevoegd of vernieuwd die overeenkomen met de rijen in de gegevensbron.

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

Parameters

dataSet: DataSet

Een DataSet om records en, indien nodig, schema op te vullen.

Retouren

Int32

Het aantal rijen dat is toegevoegd aan of vernieuwd in de DataSet. Dit omvat geen rijen die worden beïnvloed door instructies die geen rijen retourneren.

Implementeringen

Fill(DataSet)

Opmerkingen

De Fill methode haalt rijen op uit de gegevensbron met behulp van de SELECT-instructie die is opgegeven door een gekoppelde SelectCommand eigenschap. Het verbindingsobject dat aan de SELECT-instructie is gekoppeld, moet geldig zijn, maar hoeft niet geopend te zijn. Als de verbinding wordt gesloten voordat Fill deze wordt aangeroepen, wordt deze geopend om gegevens op te halen en vervolgens gesloten. Als de verbinding is geopend voordat Fill deze wordt aangeroepen, blijft deze geopend.

Met Fill de bewerking worden de rijen vervolgens toegevoegd aan doelobjecten DataTable in het DataSetobject, waardoor de DataTable objecten worden gemaakt als ze nog niet bestaan. Bij het DataTable maken van Fill objecten worden normaal gesproken alleen metagegevens van kolomnamen gemaakt. Als de MissingSchemaAction eigenschap echter is ingesteld op AddWithKey, worden ook de juiste primaire sleutels en beperkingen gemaakt.

Als de SelectCommand de resultaten van een OUTER JOIN retourneert, stelt de DataAdapter geen PrimaryKey-waarde in voor het resulterende DataTable. U moet expliciet de primaire sleutel definiëren om ervoor te zorgen dat dubbele rijen correct worden opgelost. Zie Primaire sleutels definiëren voor meer informatie.

Als de gegevensadapter dubbele kolommen tegenkomt tijdens het vullen van een DataTablekolom, worden er namen gegenereerd voor de volgende kolommen, met behulp van het patroon 'columnname1', 'columnname2', 'columnname3', enzovoort. Als de binnenkomende gegevens niet-benoemde kolommen bevatten, worden ze in het DataSet patroon Kolom1, Kolom2 enzovoort geplaatst. Wanneer er meerdere resultatensets worden toegevoegd aan de DataSet resultatenset, wordt deze in een afzonderlijke tabel geplaatst. Aanvullende resultatensets worden benoemd door integrale waarden toe te voegen aan de opgegeven tabelnaam (bijvoorbeeld 'Tabel', 'Tabel1', 'Tabel2', enzovoort). Toepassingen die kolom- en tabelnamen gebruiken, moeten ervoor zorgen dat conflicten met deze naamgevingspatronen niet optreden.

Wanneer de SELECT-instructie die wordt gebruikt om de DataSet resultaten te vullen meerdere resultaten retourneert, zoals een batch-SQL-instructie, als een van de resultaten een fout bevat, worden alle volgende resultaten overgeslagen en niet toegevoegd aan het DataSet.

U kunt de Fill methode meerdere keren op dezelfde DataTablemethode gebruiken. Als er een primaire sleutel bestaat, worden binnenkomende rijen samengevoegd met overeenkomende rijen die al bestaan. Als er geen primaire sleutel bestaat, worden binnenkomende rijen toegevoegd aan de DataTable.

Note

Bij het verwerken van batch-SQL-instructies die meerdere resultaten retourneren, haalt de implementatie van FillSchema voor het .NET Framework-Data Provider voor OLE DB alleen schemagegevens op voor het eerste resultaat. Als u schemagegevens voor meerdere resultaten wilt ophalen, gebruikt Fill u deze met de MissingSchemaAction set op AddWithKey.

Zie ook

Van toepassing op

Fill(DataTable, IDataReader)

Bron:: DataAdapter.cs

Bron:: DataAdapter.cs

Bron:: DataAdapter.cs

Bron:: DataAdapter.cs

Bron:: DataAdapter.cs

Voegt rijen toe of vernieuwt in de DataTable rijen die overeenkomen met de rijen in de gegevensbron met behulp van de DataTable naam en de opgegeven 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

Parameters

dataTable: DataTable

Een DataTable om records in te vullen.

dataReader: IDataReader

Een exemplaar van IDataReader.

Retouren

Int32

Het aantal rijen dat is toegevoegd aan of vernieuwd in de DataTable. Dit omvat geen rijen die worden beïnvloed door instructies die geen rijen retourneren.

Opmerkingen

Zie de opmerkingen voor DataAdapter.Fill(DataSet) meer informatie.

Zie ook

overzicht van ADO.NET

Van toepassing op

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

Bron:: DataAdapter.cs

Bron:: DataAdapter.cs

Bron:: DataAdapter.cs

Bron:: DataAdapter.cs

Bron:: DataAdapter.cs

Hiermee worden rijen in een opgegeven bereik toegevoegd of vernieuwd in de verzameling DataTable objecten die overeenkomen met die in de gegevensbron.

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

Parameters

dataTables: DataTable[]

Een verzameling DataTable objecten die moeten worden gevuld met records.

dataReader: IDataReader

Een exemplaar van IDataReader.

startRecord: Int32

De op nul gebaseerde index van de beginrecord.

maxRecords: Int32

Een geheel getal dat het maximum aantal records aangeeft.

Retouren

Int32

Het aantal rijen dat is toegevoegd aan of vernieuwd in de DataTable. Dit omvat geen rijen die worden beïnvloed door instructies die geen rijen retourneren.

Opmerkingen

Zie de opmerkingen voor System.Data.Common.DataAdapter.Fill(System.Data.DataSet) meer informatie.

Zie ook

overzicht van ADO.NET

Van toepassing op

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

Bron:: DataAdapter.cs

Bron:: DataAdapter.cs

Bron:: DataAdapter.cs

Bron:: DataAdapter.cs

Bron:: DataAdapter.cs

Hiermee worden rijen in een opgegeven bereik toegevoegd of vernieuwd, DataSet zodat deze overeenkomen met rijen in de gegevensbron met behulp van de DataSet en DataTable namen.

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

Parameters

dataSet: DataSet

Een DataSet om records in te vullen.

srcTable: String

Een tekenreeks die de naam van de brontabel aangeeft.

dataReader: IDataReader

Een exemplaar van IDataReader.

startRecord: Int32

De op nul gebaseerde index van de beginrecord.

maxRecords: Int32

Een geheel getal dat het maximum aantal records aangeeft.

Retouren

Int32

Het aantal rijen dat is toegevoegd aan of vernieuwd in de DataSet. Dit omvat geen rijen die worden beïnvloed door instructies die geen rijen retourneren.

Opmerkingen

Zie de opmerkingen voor System.Data.Common.DataAdapter.Fill(System.Data.DataSet) meer informatie.

Zie ook

overzicht van ADO.NET

Van toepassing op

Feedback

Is deze pagina nuttig?