DataTableExtensions.CopyToDataTable Metódus

Definíció

Névtér:

System.Data

Szerelvények:

netstandard.dll, System.Data.Common.dll

Olyan értéket DataTable ad vissza, amely az DataRow objektumok másolatait tartalmazza egy bemeneti IEnumerable<T> objektummal.

Túlterhelések

Name	Description
CopyToDataTable<T>(IEnumerable<T>)	Olyan értéket ad DataTable vissza, amely az DataRow objektumok másolatait tartalmazza, egy olyan bemeneti IEnumerable<T> objektumot ad vissza, amelyben az általános paraméter T szerepel DataRow.
CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption)	Objektumok másolása DataRow a megadott DataTableértékre egy olyan bemeneti IEnumerable<T> objektum alapján, amelyben az általános paraméter T szerepel DataRow.
CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption, FillErrorEventHandler)	Objektumok másolása DataRow a megadott DataTableértékre egy olyan bemeneti IEnumerable<T> objektum alapján, amelyben az általános paraméter T szerepel DataRow.

CopyToDataTable<T>(IEnumerable<T>)

Forrás:

DataTableExtensions.cs

Olyan értéket ad DataTable vissza, amely az DataRow objektumok másolatait tartalmazza, egy olyan bemeneti IEnumerable<T> objektumot ad vissza, amelyben az általános paraméter T szerepel DataRow.

public:
generic <typename T>
 where T : System::Data::DataRow[System::Runtime::CompilerServices::Extension]
 static System::Data::DataTable ^ CopyToDataTable(System::Collections::Generic::IEnumerable<T> ^ source);

public static System.Data.DataTable CopyToDataTable<T>(this System.Collections.Generic.IEnumerable<T> source) where T : System.Data.DataRow;

static member CopyToDataTable : seq<'T (requires 'T :> System.Data.DataRow)> -> System.Data.DataTable (requires 'T :> System.Data.DataRow)

<Extension()>
Public Function CopyToDataTable(Of T As DataRow) (source As IEnumerable(Of T)) As DataTable

Típusparaméterek

T

Általában a forrásütemezés DataRowobjektumtípusa.

Paraméterek

source

IEnumerable<T>

A forrásütemezés IEnumerable<T> .

Válaszok

DataTable

A DataTable bemeneti sorrendet az objektumok típusaként DataRow tartalmazza.

Kivételek

ArgumentNullException

A forrásütemezés IEnumerable<T> és null egy új tábla nem hozható létre.

InvalidOperationException

A DataRow forrásütemezés egyikének állapota Deleted.

A forrásütemezés nem tartalmaz DataRow objektumokat.

A DataRow forrásütemezés a következő null.

Példák

Az alábbi példa lekérdezi a SalesOrderHeader táblát a 2001 CopyToDataTableDataTable . Ezután a DataTable egy BindingSource-hoz van kötve, amely proxyként szolgál egy DataGridView számára.

// Bind the System.Windows.Forms.DataGridView object
// to the System.Windows.Forms.BindingSource object.
dataGridView.DataSource = bindingSource;

// Fill the DataSet.
DataSet ds = new DataSet();
ds.Locale = CultureInfo.InvariantCulture;
FillDataSet(ds);

DataTable orders = ds.Tables["SalesOrderHeader"];

// Query the SalesOrderHeader table for orders placed
// after August 8, 2001.
IEnumerable<DataRow> query =
    from order in orders.AsEnumerable()
    where order.Field<DateTime>("OrderDate") > new DateTime(2001, 8, 1)
    select order;

// Create a table from the query.
DataTable boundTable = query.CopyToDataTable<DataRow>();

// Bind the table to a System.Windows.Forms.BindingSource object,
// which acts as a proxy for a System.Windows.Forms.DataGridView object.
bindingSource.DataSource = boundTable;

' Bind the System.Windows.Forms.DataGridView object
' to the System.Windows.Forms.BindingSource object.
dataGridView.DataSource = bindingSource

' Fill the DataSet.
Dim ds As New DataSet()
ds.Locale = CultureInfo.InvariantCulture
' See the FillDataSet method in the Loading Data Into a DataSet topic.
FillDataSet(ds)

Dim orders As DataTable = ds.Tables("SalesOrderHeader")

' Query the SalesOrderHeader table for orders placed 
'  after August 8, 2001.
Dim query = _
    From order In orders.AsEnumerable() _
    Where order.Field(Of DateTime)("OrderDate") > New DateTime(2001, 8, 1) _
    Select order

' Create a table from the query.
Dim boundTable As DataTable = query.CopyToDataTable()

' Bind the table to a System.Windows.Forms.BindingSource object, 
' which acts as a proxy for a System.Windows.Forms.DataGridView object.
bindingSource.DataSource = boundTable

Megjegyzések

A bemeneti paraméter paramétere T csak típusból source vagy típusból DataRowszármazhat.DataRow

A bemeneti sorrend bármilyen IEnumerable<T> forrás lehet, nem csak lekérdezés vagy lekérdezés egy DataTableadott lekérdezésen keresztül. Vegye figyelembe, hogy ha a forrásütemezés egy lekérdezés, az operátor meghívása azonnali végrehajtást kényszerít. A forrásütemezés számbavétele kivételeket is okozhat.

A céltábla sémája a forrásütemezés első DataRow sorának sémáján alapul. A tábla metaadatai a DataRow metaadatokból és a tábla értékeiből lesznek kinyerve a DataRow. A gépelt DataTabletípusok nem maradnak meg. Az adatok és a séma átvitele megtörtént, de a kimeneti tábla eredménysorai nem lesznek gépelt DataRow típusúak. RowState A RowError forrásból a visszaadottba DataRowmásolt példány nem őrzi meg a DataTable tulajdonságokat.

Ha egy forrásban null értékű hivatkozás vagy null értékű null értékű DataRow ez a metódus a célban DataTable lévő értéket egy értékre cseréliValue.

A metódus által visszaadott létrehozott tábla az alapértelmezett táblanévvel rendelkezik. Ha el szeretné nevezni a DataTabletáblát, csatolja egy DataSet, vagy bármilyen más DataTable konkrét műveletet hajt végre, ezt a tábla létrehozása és visszaadása után kell elvégeznie.

További információ: DataTable létrehozása lekérdezésből.

CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption)

Forrás:

DataTableExtensions.cs

Objektumok másolása DataRow a megadott DataTableértékre egy olyan bemeneti IEnumerable<T> objektum alapján, amelyben az általános paraméter T szerepel DataRow.

public:
generic <typename T>
 where T : System::Data::DataRow[System::Runtime::CompilerServices::Extension]
 static void CopyToDataTable(System::Collections::Generic::IEnumerable<T> ^ source, System::Data::DataTable ^ table, System::Data::LoadOption options);

public static void CopyToDataTable<T>(this System.Collections.Generic.IEnumerable<T> source, System.Data.DataTable table, System.Data.LoadOption options) where T : System.Data.DataRow;

static member CopyToDataTable : seq<'T (requires 'T :> System.Data.DataRow)> * System.Data.DataTable * System.Data.LoadOption -> unit (requires 'T :> System.Data.DataRow)

<Extension()>
Public Sub CopyToDataTable(Of T As DataRow) (source As IEnumerable(Of T), table As DataTable, options As LoadOption)

Típusparaméterek

T

Általában a forrásütemezés DataRowobjektumtípusa.

Paraméterek

source

IEnumerable<T>

A forrásütemezés IEnumerable<T> .

table

DataTable

A cél DataTable.

options

LoadOption

A LoadOption terhelési beállításokat meghatározó DataTable enumerálás.

Kivételek

ArgumentException

A másolt DataRow objektumok nem felelnek meg a cél DataTablesémájának.

ArgumentNullException

A forrásütemezés IEnumerable<T> vagy null a célhelyDataTable.null

InvalidOperationException

A DataRow forrásütemezés egyikének állapota Deleted.

A forrásütemezés nem tartalmaz DataRow objektumokat.

A DataRow forrásütemezés a következő null.

Megjegyzések

A bemeneti paraméter T paramétere source csak típus DataRowlehet, vagy származtatható típus.DataRow

A bemeneti sorozat bármilyen IEnumerable<T> forrás lehet, nem csak egy lekérdezés egy DataTable. Vegye figyelembe, hogy ha a forrásütemezés egy lekérdezés, az operátor meghívása azonnali végrehajtást kényszerít. A forrásütemezés számbavétele kivételeket is okozhat.

A céltábla sémája a forrásütemezés első DataRow sorának sémáján alapul. A tábla metaadatai a DataRow metaadatokból és a tábla értékeiből lesznek kinyerve a DataRow. A gépelt DataTabletípusok nem maradnak meg. Az adatok és a séma átvitele megtörtént, de a kimeneti tábla eredménysorai nem lesznek gépelt DataRow típusúak. RowState A RowError forrásból a visszaadottba DataRowmásolt példány nem őrzi meg a DataTable tulajdonságokat.

Ha egy forrásban null értékű hivatkozás vagy null értékű null értékű DataRow ez a metódus a célban DataTable lévő értéket egy értékre cseréliValue.

A metódus által visszaadott létrehozott tábla az alapértelmezett táblanévvel rendelkezik. Ha el szeretné nevezni a DataTabletáblát, csatolja egy DataSet, vagy bármilyen más DataTable konkrét műveletet hajt végre, ezt a tábla létrehozása és visszaadása után kell elvégeznie.

További információ: DataTable létrehozása lekérdezésből.

CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption, FillErrorEventHandler)

Forrás:

DataTableExtensions.cs

Objektumok másolása DataRow a megadott DataTableértékre egy olyan bemeneti IEnumerable<T> objektum alapján, amelyben az általános paraméter T szerepel DataRow.

public:
generic <typename T>
 where T : System::Data::DataRow[System::Runtime::CompilerServices::Extension]
 static void CopyToDataTable(System::Collections::Generic::IEnumerable<T> ^ source, System::Data::DataTable ^ table, System::Data::LoadOption options, System::Data::FillErrorEventHandler ^ errorHandler);

public static void CopyToDataTable<T>(this System.Collections.Generic.IEnumerable<T> source, System.Data.DataTable table, System.Data.LoadOption options, System.Data.FillErrorEventHandler? errorHandler) where T : System.Data.DataRow;

static member CopyToDataTable : seq<'T (requires 'T :> System.Data.DataRow)> * System.Data.DataTable * System.Data.LoadOption * System.Data.FillErrorEventHandler -> unit (requires 'T :> System.Data.DataRow)

<Extension()>
Public Sub CopyToDataTable(Of T As DataRow) (source As IEnumerable(Of T), table As DataTable, options As LoadOption, errorHandler As FillErrorEventHandler)

Típusparaméterek

T

Általában a forrásütemezés DataRowobjektumtípusa.

Paraméterek

source

IEnumerable<T>

A forrásütemezés IEnumerable<T> .

table

DataTable

A cél DataTable.

options

LoadOption

A LoadOption terhelési beállításokat meghatározó DataTable enumerálás.

errorHandler

FillErrorEventHandler

Egy FillErrorEventHandler olyan meghatalmazott, amely a hibát kezelő metódust jelöli.

Kivételek

ArgumentException

A másolt DataRow objektumok nem felelnek meg a cél DataTablesémájának.

ArgumentNullException

A forrásütemezés IEnumerable<T> vagy null a célhelyDataTable.null

InvalidOperationException

A DataRow forrásütemezés egyikének állapota Deleted.

-vagy-

A forrásütemezés nem tartalmaz DataRow objektumokat.

-vagy-

A DataRow forrásütemezés a következő null.

Megjegyzések

A bemeneti paraméter T paramétere source csak típus DataRowlehet, vagy származtatható típus.DataRow

A bemeneti sorozat bármilyen IEnumerable<T> forrás lehet, nem csak egy lekérdezés egy DataTable. Vegye figyelembe, hogy ha a forrásütemezés egy lekérdezés, az operátor meghívása azonnali végrehajtást kényszerít. A forrásütemezés számbavétele kivételeket is okozhat.

A céltábla sémája a forrásütemezés első DataRow sorának sémáján alapul. A tábla metaadatai a DataRow metaadatokból és a tábla értékeiből lesznek kinyerve a DataRow. A gépelt DataTabletípusok nem maradnak meg. Az adatok és a séma átvitele megtörtént, de a kimeneti tábla eredménysorai nem lesznek gépelt DataRow típusúak. RowState A RowError forrásból a visszaadottba DataRowmásolt példány nem őrzi meg a DataTable tulajdonságokat.

Ha egy forrásban null értékű hivatkozás vagy null értékű null értékű DataRow ez a metódus a célban DataTable lévő értéket egy értékre cseréliValue.

A metódus által visszaadott létrehozott tábla az alapértelmezett táblanévvel rendelkezik. Ha el szeretné nevezni a DataTabletáblát, csatolja egy DataSet, vagy bármilyen más DataTable konkrét műveletet hajt végre, ezt a tábla létrehozása és visszaadása után kell elvégeznie.

Ha egy adatsor céltáblába másolása során kivételt (például kényszerkivételt) ad ki, a errorHandler meghatalmazott meghívása történik. Az A FillErrorEventArgs a következő értékekkel lesz átadva a errorHandler meghatalmazottnak:

• A Values tulajdonság a forrásadatok másolatára van beállítva.

• A DataTable tulajdonság a célhoz DataTablevan állítva.

• A Errors tulajdonság a kifogott kivételre van állítva.

A Continue tulajdonság a delegált hívás visszatérése után lesz beolvasva. Ha a Continue tulajdonság az true, a forrásütemezés továbbra is enumerálva lesz, és betöltődik az adattáblába. Ha a Continue tulajdonság az false, az eredeti kivételt a CopyToDataTable metódus okozza.

További információ: DataTable létrehozása lekérdezésből.