DataTableExtensions.CopyToDataTable DataTableExtensions.CopyToDataTable DataTableExtensions.CopyToDataTable DataTableExtensions.CopyToDataTable Method

指定した入力 DataTable オブジェクトに応じて (ジェネリック パラメーター T は DataRow)、IEnumerable<T> オブジェクトのコピーを格納する DataRow を返します。Returns a DataTable that contains copies of the DataRow objects, given an input IEnumerable<T> object where the generic parameter T is 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

型パラメーター

パラメーター

戻り値

例外

例

次の例は、2001 年 8 月 8 日後に、SalesOrderHeader テーブルの注文に対してクエリを実行しを使用して、CopyToDataTableを作成する方法、DataTableからクエリを実行します。The following example queries the SalesOrderHeader table for orders after August 8, 2001, and uses the CopyToDataTable method to create a DataTable from that query. 次に、DataTable が BindingSource にバインドされます。これは DataGridView のプロキシとして機能します。The DataTable is then bound to a BindingSource, which acts as proxy for a DataGridView.

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

注釈

パラメーターT入力パラメーターのsource型であることができますDataRowから派生した型またはDataRowします。The parameter T of the input parameter source can only be of type DataRow or a type derived from DataRow.

入力シーケンスには、IEnumerable<T>ソース、クエリまたはクエリのだけでなく、DataTableします。The input sequence can be any IEnumerable<T> source, not only a query or a query over a DataTable. ソース シーケンスがクエリの場合は、この演算子を呼び出して強制的に即時実行に注意してください。Note that if the source sequence is a query, calling this operator will force immediate execution. ソース シーケンスを列挙すると、例外がスローされることもあります。Enumerating the source sequence can also cause exceptions to be thrown.

レプリケーション先テーブルのスキーマは、最初のスキーマに基づいてDataRowソース シーケンス内の行。The schema of the destination table is based on the schema of the first DataRow row in the source sequence. テーブルのメタデータがから抽出された、DataRowメタデータと、テーブルの列の値から値をDataRowします。The table metadata is extracted from the DataRow metadata and the table values from the column values of the DataRow. 型指定されたDataTable型は保持されません。For a typed DataTable, types are not preserved. データとスキーマが転送されるが、出力テーブルの結果の行は、型指定されたDataRow型。The data and schema are transferred, but the resulting rows of the output table will not be of the typed DataRow type. RowStateとRowErrorプロパティは、ソースからのコピー中に保持されませんDataRowに返されたDataTableします。The RowState and RowError properties are not preserved during the copy from the source DataRow to the returned DataTable.

ときに、 null参照または null 許容型の値を持つnullがソースで見つかったDataRow、このメソッドは、宛先の値を置き換えますDataTableの値を持つValueします。When a null reference or nullable type with a value of null is found in a source DataRow, this method replaces the value in the destination DataTable with a value of Value.

メソッドによって返される生成されたテーブルには、既定のテーブル名があります。The generated table returned by the method has the default table name. 名前を付ける場合、 DataTable、アタッチ先、 DataSet、またはその他の実行DataTable、特定の操作を行う必要があります、テーブルが作成され、返された後です。If you want to name the DataTable, attach it to a DataSet, or perform any other DataTable specific operation, you must do so after the table is created and returned.

詳細については、次を参照してください。 、クエリからのデータ テーブルを作成するします。For more information, see Creating a DataTable From a Query.

指定した入力 DataRow オブジェクトに応じて (ジェネリック パラメーター T は DataTable)、指定した IEnumerable<T> に DataRow オブジェクトをコピーします。Copies DataRow objects to the specified DataTable, given an input IEnumerable<T> object where the generic parameter T is 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入力パラメーターのsource型であることができますDataRowから派生した型またはDataRowします。The parameter T of the input parameter source can only be of type DataRow, or a type derived from DataRow.

入力シーケンスには、いずれかを指定できるIEnumerable<T>ソース、クエリだけでなく経由で、DataTableします。The input sequence can be any IEnumerable<T> source, not only a query over a DataTable. ソース シーケンスがクエリの場合は、この演算子を呼び出して強制的に即時実行に注意してください。Note that if the source sequence is a query, calling this operator will force immediate execution. ソース シーケンスを列挙すると、例外がスローされることもあります。Enumerating the source sequence can also cause exceptions to be thrown.

レプリケーション先テーブルのスキーマは、最初のスキーマに基づいてDataRowソース シーケンス内の行。The schema of the destination table is based on the schema of the first DataRow row in the source sequence. テーブルのメタデータがから抽出された、DataRowメタデータと、テーブルの列の値から値をDataRowします。The table metadata is extracted from the DataRow metadata and the table values from the column values of the DataRow. 型指定されたDataTable型は保持されません。For a typed DataTable, types are not preserved. データとスキーマが転送されるが、出力テーブルの結果の行は、型指定されたDataRow型。The data and schema are transferred, but the resulting rows of the output table will not be of the typed DataRow type. RowStateとRowErrorプロパティは、ソースからのコピー中に保持されませんDataRowに返されたDataTableします。The RowState and RowError properties are not preserved during the copy from the source DataRow to the returned DataTable.

ときに、 null参照または null 許容型の値を持つnullがソースで見つかったDataRow、このメソッドは、宛先の値を置き換えますDataTableの値を持つValueします。When a null reference or nullable type with a value of null is found in a source DataRow, this method replaces the value in the destination DataTable with a value of Value.

メソッドによって返される生成されたテーブルには、既定のテーブル名があります。The generated table returned by the method has the default table name. 名前を付ける場合、 DataTable、アタッチ先、 DataSet、またはその他の実行DataTable、特定の操作を行う必要があります、テーブルが作成され、返された後です。If you want to name the DataTable, attach it to a DataSet, or perform any other DataTable specific operation, you must do so after the table is created and returned.

詳細については、次を参照してください。 、クエリからのデータ テーブルを作成するします。For more information, see Creating a DataTable From a Query.

指定した入力 DataRow オブジェクトに応じて (ジェネリック パラメーター T は DataTable)、指定した IEnumerable<T> に DataRow オブジェクトをコピーします。Copies DataRow objects to the specified DataTable, given an input IEnumerable<T> object where the generic parameter T is 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入力パラメーターのsource型であることができますDataRowから派生した型またはDataRowします。The parameter T of the input parameter source can only be of type DataRow, or a type derived from DataRow.

入力シーケンスには、いずれかを指定できるIEnumerable<T>ソース、クエリだけでなく経由で、DataTableします。The input sequence can be any IEnumerable<T> source, not only a query over a DataTable. ソース シーケンスがクエリの場合は、この演算子を呼び出して強制的に即時実行に注意してください。Note that if the source sequence is a query, calling this operator will force immediate execution. ソース シーケンスを列挙すると、例外がスローされることもあります。Enumerating the source sequence can also cause exceptions to be thrown.

レプリケーション先テーブルのスキーマは、最初のスキーマに基づいてDataRowソース シーケンス内の行。The schema of the destination table is based on the schema of the first DataRow row in the source sequence. テーブルのメタデータがから抽出された、DataRowメタデータと、テーブルの列の値から値をDataRowします。The table metadata is extracted from the DataRow metadata and the table values from the column values of the DataRow. 型指定されたDataTable型は保持されません。For a typed DataTable, types are not preserved. データとスキーマが転送されるが、出力テーブルの結果の行は、型指定されたDataRow型。The data and schema are transferred, but the resulting rows of the output table will not be of the typed DataRow type. RowStateとRowErrorプロパティは、ソースからのコピー中に保持されませんDataRowに返されたDataTableします。The RowState and RowError properties are not preserved during the copy from the source DataRow to the returned DataTable.

ときに、 null参照または null 許容型の値を持つnullがソースで見つかったDataRow、このメソッドは、宛先の値を置き換えますDataTableの値を持つValueします。When a null reference or nullable type with a value of null is found in a source DataRow, this method replaces the value in the destination DataTable with a value of Value.

メソッドによって返される生成されたテーブルには、既定のテーブル名があります。The generated table returned by the method has the default table name. 名前を付ける場合、 DataTable、アタッチ先、 DataSet、またはその他の実行DataTable、特定の操作を行う必要があります、テーブルが作成され、返された後です。If you want to name the DataTable, attach it to a DataSet, or perform any other DataTable specific operation, you must do so after the table is created and returned.

制約の例外など、対象テーブルへのデータ行のコピー中に例外がスローされた場合、errorHandlerデリゲートが呼び出されます。If an exception is thrown during the copy of a data row into the target table, such as a constraint exception, the errorHandler delegate is called. AFillErrorEventArgsに渡される、errorHandler次の値を持つデリゲートします。A FillErrorEventArgs is passed to the errorHandler delegate with the following values:

• Valuesプロパティが、ソース データのコピーに設定します。The Values property is set to a copy of the source data.

• DataTableプロパティがターゲットDataTableします。The DataTable property is set to the target DataTable.

• Errorsプロパティがキャッチされた例外に設定します。The Errors property is set to the caught exception.

Continueデリゲートの呼び出しが返された後に、プロパティは読み取り専用です。The Continue property is read after the delegate call returns. 場合、Continueプロパティはtrueが列挙され、データ テーブルに読み込まれる、ソース シーケンスが続行されます。If the Continue property is true, the source sequence continues to be enumerated and loaded into the data table. 場合、Continueプロパティはfalseから、元の例外がスローされる、CopyToDataTableメソッド。If the Continue property is false, the original exception is thrown from the CopyToDataTable method.

詳細については、次を参照してください。 、クエリからのデータ テーブルを作成するします。For more information, see Creating a DataTable From a Query.