英語で読む

次の方法で共有


DataRow.ItemArray プロパティ

定義

配列を使用してこの行のすべての値を取得または設定します。

public object?[] ItemArray { get; set; }
public object[] ItemArray { get; set; }

プロパティ値

Object[]

Object 型の配列。

例外

配列がテーブルの列数より大きいです。

配列内の値が、各値の DataType 内の DataColumn と一致していません。

編集が制約に違反しています。

編集によって読み取り専用の列の値を変更しようとしています。

編集によって、AllowDBNull オブジェクトの DataColumnfalse である列に null 値を入力しようとしています。

行が削除されました。

次の例では、 プロパティを使用して値を取得および設定する方法を ItemArray 示します。

private void CreateRowsWithItemArray()
{
    // Make a DataTable using the function below.
    DataTable dt = MakeTableWithAutoIncrement();
    DataRow relation;
    // Declare the array variable.
    object [] rowArray = new object[2];
    // Create 10 new rows and add to DataRowCollection.
    for(int i = 0; i <10; i++)
    {
        rowArray[0]=null;
        rowArray[1]= "item " + i;
        relation = dt.NewRow();
        relation.ItemArray = rowArray;
        dt.Rows.Add(relation);
    }
    PrintTable(dt);
}

private DataTable MakeTableWithAutoIncrement()
{
    // Make a table with one AutoIncrement column.
    DataTable table = new DataTable("table");
    DataColumn idColumn = new DataColumn("id",
        Type.GetType("System.Int32"));
    idColumn.AutoIncrement = true;
    idColumn.AutoIncrementSeed = 10;
    table.Columns.Add(idColumn);

    DataColumn firstNameColumn = new DataColumn("Item",
        Type.GetType("System.String"));
    table.Columns.Add(firstNameColumn);
    return table;
}

private void PrintTable(DataTable table)
{
    foreach(DataRow row in table.Rows)
    {
        foreach(DataColumn column in table.Columns)
        {
            Console.WriteLine(row[column]);
        }
    }
}

注釈

このプロパティを使用すると、配列を使用してこの行の値を設定または取得できます。 このプロパティを使用して値を設定する場合、配列のサイズと順序は列コレクションと同じである必要があります。 をItemArray渡すとnull、値が指定されなかったことを示します。

ユーザーは、イベントまたはイベントで例外をColumnChangingRowChanging生成できます。

適用対象

製品 バージョン
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

こちらもご覧ください