Прочитать на английском

Поделиться через


DataRow.ItemArray Свойство

Определение

Возвращает или задает все значения для этой строки с помощью массива.

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

Значение свойства

Object[]

Массив типа Object.

Исключения

Размер массива превышает число столбцов в таблице.

Значение в массиве не соответствует его свойству DataType в его соответствующем объекте DataColumn.

Изменение привело к нарушению ограничения.

При изменении была предпринята попытка изменить значение столбца, доступное только для чтения.

При изменении была предпринята попытка значение null в столбец, у которого свойство AllowDBNull объекта DataColumn имеет значение false.

Строка была удалена.

Примеры

В следующих примерах показано, как получить и задать значения с помощью ItemArray свойства .

C#
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]);
        }
    }
}

Комментарии

Это свойство можно использовать для задания или получения значений для этой строки через массив. Если это свойство используется для задания значений, массив должен иметь тот же размер и упорядочение, что и коллекция столбцов. Передача null указывает, ItemArray что значение не указано.

Пользователи могут создавать исключения в событии ColumnChanging или событии RowChanging .

Применяется к

Продукт Версии
.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

См. также раздел