DataTableExtensions.CopyToDataTable 方法

定義

命名空間:

System.Data

組件:

System.Data.Common.dll

根據輸入 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

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

C#

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

類型參數

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。

C#

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

備註

輸入參數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

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

C#

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;

類型參數

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 數據列的架構為基礎。 數據表元數據會從 DataRow 元數據擷取，並從的數據 DataRow行值擷取數據表值。 對於具 DataTable類型的 ，不會保留型別。 數據與架構會傳送，但輸出數據表的結果數據列將不會屬於具型別 DataRow 。 在RowState從來源DataRow複製到傳DataTable回 的 期間，不會保留 和 RowError 屬性。

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

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

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

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

來源:

DataTableExtensions.cs

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

C#

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;

類型參數

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的類型。

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

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

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

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

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

• 屬性 Values 會設定為源數據的複本。

• 屬性 DataTable 會設定為目標 DataTable。

• 屬性 Errors 會設定為攔截的例外狀況。

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

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