DataTableExtensions.CopyToDataTable 方法

參考

定義

命名空間:: System.Data

組件:: System.Data.DataSetExtensions.dll

組件:: System.Data.Common.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

根據輸入 DataTable 物件，傳回包含 DataRow 物件複本的 IEnumerable<T>。

多載

CopyToDataTable<T>(IEnumerable<T>)	根據輸入 DataTable 物件 (其中泛型參數 `T` 為 DataRow) 傳回包含 IEnumerable<T> 物件複本的 DataRow。
CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption)	根據輸入 DataRow 物件 (其中泛型參數 `T` 為 DataTable)，將 IEnumerable<T> 物件複製到指定的 DataRow。
CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption, FillErrorEventHandler)	根據輸入 DataRow 物件 (其中泛型參數 `T` 為 DataTable)，將 IEnumerable<T> 物件複製到指定的 DataRow。

CopyToDataTable<T>(IEnumerable<T>)

來源:: DataTableExtensions.cs

來源:: DataTableExtensions.cs

來源:: DataTableExtensions.cs

根據輸入 DataTable 物件 (其中泛型參數 T 為 DataRow) 傳回包含 IEnumerable<T> 物件複本的 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

來源序列中的物件類型，通常是 DataRow。

參數

source: IEnumerable<T>

來源 IEnumerable<T> 序列。

傳回

DataTable

DataTable，包含當做 DataRow 物件型別的輸入序列。

例外狀況

ArgumentNullException

來源 IEnumerable<T> 序列為 null，而且無法建立新的資料表。

InvalidOperationException

來源序列中的 DataRow 具有 Deleted 的狀態。

來源序列不含任何 DataRow 物件。

來源序列中的 DataRow 為 null。

範例

下列範例會在 2001 年 8 月 8 日之後查詢 SalesOrderHeader 資料表，並使用 CopyToDataTable 方法從該查詢建立 DataTable 。接著，DataTable 便繫結至 BindingSource，而它會當做 DataGridView 的 Proxy。

// 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

備註

輸入參數Tsource的參數只能是型DataRow別或衍生自 DataRow的類型。

輸入序列可以是任何 IEnumerable<T> 來源，而不只是查詢或透過的 DataTable查詢。請注意，如果來源序列是查詢，則呼叫此運算符會強制立即執行。列舉來源序列也會導致擲回例外狀況。

目的地數據表的架構是以來源序列中第一個 DataRow 數據列的架構為基礎。數據表元數據會從 DataRow 元數據擷取，並從的數據 DataRow行值擷取數據表值。對於具 DataTable類型的，不會保留型別。數據與架構會傳送，但輸出數據表的結果數據列將不會屬於具型別 DataRow 。在RowState從來源DataRow複製到傳DataTable回的期間，不會保留和 RowError 屬性。

在來源DataRow中找到 Null 參考或可為 Null 的型別時，這個方法會將目的地DataTable中的值取代為值Value。

方法所傳回的產生的數據表具有預設數據表名稱。如果您想要命名 DataTable，請將它附加至 DataSet，或執行任何其他 DataTable 特定作業，則必須在建立並傳回數據表之後執行此動作。

如需詳細資訊，請參閱從查詢建立 DataTable。

適用於

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

來源:: DataTableExtensions.cs

來源:: DataTableExtensions.cs

來源:: DataTableExtensions.cs

根據輸入 DataRow 物件 (其中泛型參數 T 為 DataTable)，將 IEnumerable<T> 物件複製到指定的 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

來源序列中的物件類型，通常是 DataRow。

參數

source: IEnumerable<T>

來源 IEnumerable<T> 序列。

table: DataTable

目的 DataTable。

options: LoadOption

指定 LoadOption 載入選項的 DataTable 列舉型別。

例外狀況

ArgumentException

已複製的 DataRow 物件不適合目的 DataTable 的結構描述。

ArgumentNullException

來源 IEnumerable<T> 序列為 null，或者目的 DataTable 為 null。

InvalidOperationException

來源序列中的 DataRow 具有 Deleted 的狀態。

來源序列不含任何 DataRow 物件。

來源序列中的 DataRow 為 null。

備註

輸入參數Tsource的參數只能是型DataRow別，或衍生自 DataRow的類型。

輸入序列可以是任何 IEnumerable<T> 來源，而不只是透過的 DataTable查詢。請注意，如果來源序列是查詢，則呼叫此運算符會強制立即執行。列舉來源序列也會導致擲回例外狀況。

在來源DataRow中找到 Null 參考或可為 Null 的型別時，這個方法會將目的地DataTable中的值取代為值Value。

如需詳細資訊，請參閱從查詢建立 DataTable。

適用於

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

來源:: DataTableExtensions.cs

來源:: DataTableExtensions.cs

來源:: DataTableExtensions.cs

根據輸入 DataRow 物件 (其中泛型參數 T 為 DataTable)，將 IEnumerable<T> 物件複製到指定的 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;

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

來源序列中的物件類型，通常是 DataRow。

參數

source: IEnumerable<T>

來源 IEnumerable<T> 序列。

table: DataTable

目的 DataTable。

options: LoadOption

指定 LoadOption 載入選項的 DataTable 列舉型別。

errorHandler: FillErrorEventHandler

FillErrorEventHandler 委派，表示會處理錯誤的方法。

例外狀況

ArgumentException

已複製的 DataRow 物件不適合目的 DataTable 的結構描述。

ArgumentNullException

來源 IEnumerable<T> 序列為 null，或者目的 DataTable 為 null。

InvalidOperationException

來源序列中的 DataRow 具有 Deleted 的狀態。

-或-

來源序列不含任何 DataRow 物件。

-或-

來源序列中的 DataRow 為 null。

備註

輸入參數Tsource的參數只能是型DataRow別，或衍生自 DataRow的類型。

在來源DataRow中找到 Null 參考或可為 Null 的型別時，這個方法會將目的地DataTable中的值取代為值Value。

如果在目標數據表中的數據列復本期間擲回例外狀況，例如條件約束例外狀況， errorHandler 則會呼叫委派。會 FillErrorEventArgs 以下列值傳遞至 errorHandler 委派：

屬性 Values 會設定為源數據的複本。
屬性 DataTable 會設定為目標 DataTable。
屬性 Errors 會設定為攔截的例外狀況。

屬性 Continue 會在委派呼叫傳回之後讀取。 Continue如果屬性為 true，來源序列會繼續列舉並載入至數據表。 Continue如果屬性為 false，則會從方法擲回原始例外狀況CopyToDataTable。

如需詳細資訊，請參閱從查詢建立 DataTable。

適用於

DataTableExtensions.CopyToDataTable 方法

定義

多載

CopyToDataTable<T>(IEnumerable<T>)

類型參數

參數

傳回

例外狀況

範例

備註

適用於

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

類型參數

參數

例外狀況

備註

適用於

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

類型參數

參數

例外狀況

備註

適用於

意見反應

其他資源