DataRow

Мы видели, что коллекция объектов DataColumn представляет схему объекта DataTable. А коллекция объектов DataRow представляет конкретные данные в таблице. И если на складе имеются 20 автомобилей, то для хранения информации о них нужно 20 объектов DataRow. Некоторые (но не все) члены класса DataRow перечислены ниже:

HasErrors, GetColumnsInError(), GetColumnError(), ClearErrors(), RowError	Свойство HasErrors возвращает логическое значение, означающее наличие ошибок. Если они есть, то метод GetColumnsInError() позволяет получить ошибочные столбцы, а метод GetColumnError() — получить описание ошибки. Аналогично, метод ClearErrors() удаляет из строки всю информацию об ошибках. Свойство RowError позволяет создать текстовое описание ошибки для данной строки
ItemArray	Свойство, задающее или получающее все значения столбцов строки в виде массива объектов
RowState	Свойство, позволяющее зафиксировать текущее состояние объекта DataRow в содержащем его DataTable с помощью значений перечисления RowState (новый, измененный, не измененный или удаленный)
Table	Свойство, позволяющее получить ссылку на объект DataTable, содержащий данный объект DataRow
AcceptChanges(), RejectChanges()	Методы для фиксации или отмены всех изменений, выполненных в данной строке с момента последнего вызова AcceptChanges()
BeginEdit(), EndEdit(), CancelEdit()	Методы, начинающие, заканчивающие или отменяющие операцию редактирования для объекта DataRow
Delete()	Метод, помечающий данную строку для удаления при вызове метода AcceptChanges()
IsNull()	Метод, получающий значение, которое указывает, содержит ли заданный столбец пустое значение

Работа с объектами DataRow несколько отличается от работы с DataColumn: невозможно напрямую создать экземпляр данного типа, т.к. у него нет общедоступного конструктора:

// Ошибка! Нет общедоступного конструктора!DataRow dr = new DataRow();

Вместо этого новый объект DataRow можно получить из конкретного DataTable. Предположим, например, что в таблицу Inventory нужно вставить две строки. Метод DataTable.NewRow() позволяет получить очередное место в таблице, после чего можно заполнить каждый столбец с помощью индексатора типа. При этом можно указать либо строковое имя, присвоенное объекту DataColumn, либо номер его позиции (начиная с нуля):

// Добавление строк в таблицу Inventory DataRow carRow = inventoryTable.NewRow(); carRow["Make"] = "BMW"; carRow["Color"] = "Black"; carRow["PetName"] = "Hamlet"; inventoryTable.Rows.Add(carRow); carRow = inventoryTable.NewRow(); carRow[1] = "Saab"; carRow[2] = "Red"; carRow[3] = "Sea Breeze"; inventoryTable.Rows.Add(carRow);

Если передать методу индексатора типа DataRow неверное имя столбца или позицию, будет сгенерировано исключение времени выполнения.

Теперь у вас есть один объект DataTable, содержащий две строки. Конечно, этот общий процесс можно повторить, чтобы создать ряд объектов DataTable, определить их схемы и заполнить данными. Но прежде чем вставить объект inventoryTable в объект DataSet, необходимо разобраться с очень важным свойством RowState.

Дата добавления: 2015-05-09