DataTable.LoadDataRow メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
特定の行を検索し、更新します。 一致する行が見つからない場合は、指定した値を使用して新しい行が作成されます。
オーバーロード
LoadDataRow(Object[], Boolean) |
特定の行を検索し、更新します。 一致する行が見つからない場合は、指定した値を使用して新しい行が作成されます。 |
LoadDataRow(Object[], LoadOption) |
特定の行を検索し、更新します。 一致する行が見つからない場合は、指定した値を使用して新しい行が作成されます。 |
LoadDataRow(Object[], Boolean)
- ソース:
- DataTable.cs
- ソース:
- DataTable.cs
- ソース:
- DataTable.cs
特定の行を検索し、更新します。 一致する行が見つからない場合は、指定した値を使用して新しい行が作成されます。
public:
System::Data::DataRow ^ LoadDataRow(cli::array <System::Object ^> ^ values, bool fAcceptChanges);
public System.Data.DataRow LoadDataRow (object?[] values, bool fAcceptChanges);
public System.Data.DataRow LoadDataRow (object[] values, bool fAcceptChanges);
member this.LoadDataRow : obj[] * bool -> System.Data.DataRow
Public Function LoadDataRow (values As Object(), fAcceptChanges As Boolean) As DataRow
パラメーター
- values
- Object[]
新しい行の作成に使用する値の配列。
- fAcceptChanges
- Boolean
変更を受け入れる場合は true
。それ以外の場合は false
。
戻り値
新しい DataRow。
例外
配列がテーブルの列数より大きいです。
値が各列の型と一致していません。
この行を追加すると、制約が無効になります。
AllowDBNull が false である列に null を格納しようとしています。
例
次の例では、 メソッドを LoadDataRow 使用して行の検索を試みます。 このような行が見つからない場合は、値を使用して新しい行が作成されます。
using System;
using System.Data;
class MyDataSet {
public static void Main() {
DataTable dt = new DataTable();
DataColumn dc1 = new DataColumn("col1");
DataColumn dc2 = new DataColumn("col2");
DataColumn dc3 = new DataColumn("col3");
dt.Columns.Add(dc1);
dt.Columns.Add(dc2);
dt.Columns.Add(dc3);
// Create an array for the values.
object[] newRow = new object[3];
// Set the values of the array.
newRow[0] = "Hello";
newRow[1] = "World";
newRow[2] = "two";
DataRow row;
dt.BeginLoadData();
// Add the new row to the rows collection.
row = dt.LoadDataRow(newRow, true);
foreach (DataRow dr in dt.Rows) {
Console.WriteLine(String.Format("Row: {0}, {1}, {2}", dr["col1"], dr["col2"], dr["col3"]));
}
dt.EndLoadData();
}
}
Imports System.Data
Class MyDataSet
Public Shared Sub Main()
Dim dt As New DataTable()
Dim dc1 As New DataColumn("col1")
Dim dc2 As New DataColumn("col2")
Dim dc3 As New DataColumn("col3")
dt.Columns.Add(dc1)
dt.Columns.Add(dc2)
dt.Columns.Add(dc3)
' Create an array for the values.
Dim newRow As Object() = New Object(2) {}
' Set the values of the array.
newRow(0) = "Hello"
newRow(1) = "World"
newRow(2) = "two"
Dim row As DataRow
dt.BeginLoadData()
' Add the new row to the rows collection.
row = dt.LoadDataRow(newRow, True)
For Each dr As DataRow In dt.Rows
Console.WriteLine([String].Format("Row: {0}, {1}, {2}", dr("col1"), dr("col2"), dr("col3")))
Next
dt.EndLoadData()
End Sub
End Class
注釈
メソッドは LoadDataRow 値の配列を受け取り、主キー列で一致する値を検索します。
列に既定値がある場合は、配列に null 値を渡して、その列の既定値を設定します。 同様に、列の AutoIncrement プロパティが true に設定されている場合は、配列に null 値を渡して、自動的に生成される行の値を設定します。
パラメーターが fAcceptChanges
指定されていない場合は true
、新しいデータが追加され AcceptChanges 、 でのすべての変更 DataTableを受け入れるようにが呼び出されます。引数が の場合、 false
新しく追加された行は挿入としてマークされ、既存の行に対する変更は変更としてマークされます。
例外は、 または RowChanging イベントのColumnChanging間にも発生する可能性があります。 例外が発生した場合、行はテーブルに追加されません。
と EndLoadDataとBeginLoadDataを組み合わせて使用LoadDataRowします。
こちらもご覧ください
適用対象
LoadDataRow(Object[], LoadOption)
- ソース:
- DataTable.cs
- ソース:
- DataTable.cs
- ソース:
- DataTable.cs
特定の行を検索し、更新します。 一致する行が見つからない場合は、指定した値を使用して新しい行が作成されます。
public:
System::Data::DataRow ^ LoadDataRow(cli::array <System::Object ^> ^ values, System::Data::LoadOption loadOption);
public System.Data.DataRow LoadDataRow (object?[] values, System.Data.LoadOption loadOption);
public System.Data.DataRow LoadDataRow (object[] values, System.Data.LoadOption loadOption);
member this.LoadDataRow : obj[] * System.Data.LoadOption -> System.Data.DataRow
Public Function LoadDataRow (values As Object(), loadOption As LoadOption) As DataRow
パラメーター
- values
- Object[]
新しい行の作成に使用する値の配列。
- loadOption
- LoadOption
配列値を既存の行にある対応する値に適用する方法を決定するために使用します。
戻り値
新しい DataRow。
注釈
メソッドは LoadDataRow 値の配列を受け取り、主キー列で一致する値を検索します。
列に既定値がある場合は、配列に null 値を渡して、その列の既定値を設定します。 同様に、列の AutoIncrement プロパティが true に設定されている場合は、配列に null 値を渡して、自動的に生成される行の値を設定します。
パラメーターの値は、配列内の loadOption
値を既存の行に適用する方法を決定するために使用されます。 たとえば、 が にOverwriteChanges
設定されている場合loadOption
、Original
各列の と Current
の値は受信行の値に置き換えられ、 RowState
プロパティは にUnchanged
設定されます。
例外は、 または RowChanging イベントのColumnChanging間にも発生する可能性があります。 例外が発生した場合、行はテーブルに追加されません。
と EndLoadDataとBeginLoadDataを組み合わせて使用LoadDataRowします。
こちらもご覧ください
適用対象
.NET