DataTable.LoadDataRow メソッド

ソース:

DataTable.cs

ソース:

DataTable.cs

ソース:

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

パラメーター

戻り値

新しい DataRow。

例外

例

次の例では、 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または指定されていない場合、新しいデータが追加され、DataTableのすべての変更を受け入れるためにAcceptChangesが呼び出されます。引数がfalseされている場合、新しく追加された行は挿入としてマークされ、既存の行への変更は変更としてマークされます。

例外は、 ColumnChanging または RowChanging イベント中にも発生する可能性があります。 例外が発生した場合、行はテーブルに追加されません。

BeginLoadDataとEndLoadDataと組み合わせてLoadDataRowを使用します。

こちらもご覧ください

• DataTables
• DataTable イベントの処理

ソース:

DataTable.cs

ソース:

DataTable.cs

ソース:

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

パラメーター

戻り値

新しい DataRow。

注釈

LoadDataRow メソッドは、値の配列を受け取り、主キー列で一致する値を検索します。

列に既定値がある場合は、配列に null 値を渡して、その列の既定値を設定します。 同様に、列の AutoIncrement プロパティが true に設定されている場合は、配列に null 値を渡して、自動的に生成される行の値を設定します。

loadOption パラメーターの値は、配列内の値が既存の行にどのように適用されるかを決定するために使用されます。 たとえば、 loadOption が OverwriteChanges に設定されている場合、各列の Original 値と Current 値は受信行の値に置き換えられ、 RowState プロパティは Unchanged に設定されます。

例外は、 ColumnChanging または RowChanging イベント中にも発生する可能性があります。 例外が発生した場合、行はテーブルに追加されません。

BeginLoadDataとEndLoadDataと組み合わせてLoadDataRowを使用します。

こちらもご覧ください

• DataTables