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

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


DataRow.ItemArray Свойство

Определение

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

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

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

Object[]

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

Исключения

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

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

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

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

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

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

Примеры

В следующих примерах показано, как получить и задать значения с помощью 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]);
        }
    }
}

Комментарии

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

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

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

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