Использование DataTable

6. Использование DataTable

Чтобы использовать DataTable, Вы должны подключить System.Data.

6.1. Создание DataTable

Объект DataTable имеет две конструкции:

public DataTable()
public DataTable(string tableName)

Следующий пример создает экземпляр объекта DataTable:

[VB]
Dim workTable as DataTable
workTable = New DataTable("Customer")
workTable.CaseSensitive = false
workTable.MinimumCapacity = 100

[C#]
DataTable workTable = new DataTable("Customer");
workTable.CaseSensitive = false;
workTable.MinimumCapacity = 100;
 

В этом примере создаётся объект DataTable и устанавливается его имя. Также Вы можете создавать объект DataTable без того, чтобы сразу задавать его имя, а имя присвоить позже, воспользовавшись свойством TableName объекта DataTable:

DataTable worktable = new DataTable();
worktable.TableName = "Customers";

Объект DataTable создаётся с заданными по умолчанию параметрами свойств. Среди прочих свойств DataTable, свойство CaseSensitive указывает, является ли схема, которая добавляет строки к таблице зависимой от регистра. Вы можете изменять установку CaseSensitive для сравнений строки при сортировке, поиске и фильтрации (sorting, searching и filtering). Свойство MinimumCapacity определяет число строк, которое система должна создать перед получением данных. Если для вашей системы критична эффективность, Вы можете изменить установленное по умолчанию начальное значение параметра, в целях оптимизации эффективности.

6.2. Добавление столбцов в DataTable

DataTable содержит совокупность объектов DataColumn. Эта совокупность определяет структуру таблицы. Чтобы добавить новый столбец в эту совокупность, используйте метод Add. Представленный ниже пример добавляет три столбца к DataTable, используя метод Add из ColumnsCollection. Метод определяет свойства DataType и ColumnName.

[VB]
Dim workTable as DataTable
Dim workColumn as DataColumn

WorkTable = new DataTable("Customers")

workColumn = workTable.Columns.Add("CustID",
System.Type.GetType("System.Int32") )

workColumn.AllowNull = false
workColumn.Unique = true
     
workColumn = workTable.Columns.Add("CustomerNameLast",
System.Type.GetType("System.String") )
workColumn = workTable.Columns.Add("CustomerNameFirst",
System.Type.GetType("System.String") )

workColumn = workTable.Columns.Add("Purchases",
System.Type.GetType("System.Double"))

[C#]
DataColumn workColumn = null;

DataTable workTable = new DataTable("Customers");

workColumn = workTable.Columns.Add("CustID",
System.Type.GetType("System.Int32") );

workColumn.AllowNull = false;
workColumn.Unique = true;

workColumn = workTable.Columns.Add("CustomerNameLast",
System.Type.GetType("System.String") );
workColumn = workTable.Columns.Add("CustomerNameFirst",
System.Type.GetType("System.String") );
workColumn = workTable.Columns.Add("Purchases",
System.Type.GetType("System.Double") );

В этом примере, сначала объявляется переменная типа DataColumn с именем "workColumn". Для C#, переменная инициализируется null.

DataColumn workColumn = null;

Затем, объявляется экземпляр таблицы, чтобы добавить новые столбцы, и называем её Customers.

DataTable worktable = new DataTable("Customers");

После создания таблицы, начните добавлять в неё новые столбцы. Типы данных, назначаемые столбцам должны быть типами данных, принятыми в .NET FRAMEWORK, а не у OLE DB или, как определенные в базе данных типы. Чтобы установить тип, используйте System функцию GetType, которая возвращает название для требующегося типа данных. В этом примере добавляется три столбца: CustID (type: Int32), CustomerNameLast (type: String), и CustomerNameFirst (type: String).

workColumn = workTable.Columns.Add("CustID",
System.Type.GetType("System.Int32") );

System.Type.GetType("System.Int32")

Метод GetType возвращает null, если указанный тип не может быть загружен.
ColumnsCollection в DataTable имеет две перегрузки метода Add:

Public DataColumn Add(String columnname, Type type)
Public DataColumn Add(String columnname)

6.3. Создание Expression Columns

ADO.NET позволяет также создавать и определять Expression (выражение) столбцы, которые содержат вычисляемые значения. Выражения в ADO.NET используются для:

- Фильтрации;
- Вычислений;
- Агрегирования информации столбцов.

Чтобы создавать Expression столбец, установите свойство DataType на тип, соответствующий возвращаемому выражением значения. После этого, установите свойство Expression на допустимое выражение. Следующий пример показывает, как создать Expression столбец, который вычисляет налог с продаж 8.6 процентов (.086):

[VB]
Dim sales_tax As DataColumn = New DataColumn
sales_tax.DataType = System.Type.GetType("System.Currency")
sales_tax.Expression = "total * .086"

[C#]
DataColumn sales_tax = New DataColumn;
sales_tax.DataType = System.Type.GetType("System.Currency");
sales_tax.Expression = "total * .086";

Вы также можете создать Expression столбец, используя метода Add. Например, показанный ниже код добавляет столбец, который вычисляет для заказчика скидку в 10 процентов от закупки. Выражение умножает столбец "Purchases" на 10 процентов

[VB]
Dim workColumn As DataColumn
workColumn = workTable.Columns.Add("Rebates", _
System.Type.GetType("System.Double"), "Purchases * .1" )

[C#]
System.Data.DataColumn workColumn;
workColumn = workTable.Columns.Add("Rebates",
System.Type.GetType("System.Double"), "Purchases * .1");

Выражения DataSet могут ссылаться на другие Expression столбцы. Однако, циклическая зависимость, в которой два выражения ссылаются друг на друга, вызовет ошибку. Для выяснения правил использования выражений, см. соответствующую тему справочника по .NET Framework SDK, для свойств Expression класса DataColumn.

6.4. Создание AutoIncrement столбцов

Другая особенность DataColumn, это возможность автоприращения (auto-incrementation). Auto-incrementing столбец автоматически увеличивает значение, содержащееся в столбце, когда добавляются новые строки. Чтобы создавать Auto-incrementing столбец, установите свойство AutoIncrement этого столбца к истине. После этого, отсчёт значений столбца начнётся со значения, определенного в свойстве столбца AutoIncrementSeed. При добавлении каждой строки, значение столбца AutoIncrement будет увеличиваться на величину, указанную в свойстве столбца AutoIncrementStep.
Например, чтобы создать столбец, который начинается с 200 и увеличивается с приращением в 3 шага:

[VB]
workColumn = workTable.Columns.Add _
   ("CustID", System.Type.GetType("System.Int32")
workColumn.AutoIncrement = True
workColumn.AutoIncrementSeed = 200
workColumn.AutoIncrementStep = 3

[C#]
workColumn = workTable.Columns.Add("CustID",
System.Type.GetType("System.Int32") );
workColumn.AutoIncrement = true;
workColumn.AutoIncrementSeed = 200;
workColumn.AutoIncrementStep = 3;

По аналогии, можно заставить столбец быть read-only (только для чтения), установив его свойство ReadOnly в истину.

6.5. Создание первичного ключа для таблицы

Общее принятым правилом для базы данных является то, что каждая таблица имеет столбец, или группу столбцов, которые уникально идентифицирует каждую строку в таблице. Этот столбец (или столбцы) называется первичным ключом (primary key).
Для таблицы Customers, столбец CustID будет первичным ключом. Чтобы определить этот столбец, как первичный ключ, установите некоторые дополнительные свойства для столбца CustID, которые заставят его работать подобно первичному ключу в базе данных. Первое из этих свойств AllowNull, которое определят, допустимо ли значение null. Как это сделано у первичного ключа в базе данных, установите свойство в false.

 workColumn.AllowNull = false;

Свойство Unique определяет, должны ли значения в столбце быть уникальными. Другими словами, никакие два значения в столбце не могут быть идентичны. Так как столбец будет первичным ключом, устанавливать это значение в true.

 workColumn.Unique = true;

Теперь, когда столбец имеет всё необходимое для выполнения роли первичного ключа, ему может быть установлено свойство PrimaryKey объекта DataTable:

[VB]
Dim myColArray As DataColumn()
myColArray = workTable.Columns("CustID")
workTable.PrimaryKey = myColArray

[C#]
workTable.PrimaryKey = new DataColumn[] {worktable["CustID"]};

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

[VB]
myColArray(0) = workTable.Columns("Col1")
myColArray(1) = workTable.Columns("Col2")
workTable.PrimaryKey = myColArray

[C#]
workTable.PrimaryKey = new DataColumn[] {worktable["Col1"], worktable["Col2"]};

6.6. Порядок применения Insert, Update и Delete

Вообще, все Insert, Update и Delete передаются к SQL Server в том же самом порядке строки, в каком он был возвращён первоначальной инструкцией Update. Порядок, в котором исполняются запланированные инструкцией Update изменения, при некоторых обстоятельствах, может вызвать проблемы при модификации. Например, рассмотрим следующий алгоритм:

- Заполним объект DataSet, включая ключевой столбец.
- Изменим ключевое значение одной строки (например, 3 заменим на 26).
- Вставим новую строку, используя старое ключевое значение.

Вышеупомянутая последовательность операций приведёт к ошибке. Это произойдёт потому, что новая строка вставлена в набор данных в порядке сортировки. Все Insert, Update и Delete обрабатываются последовательно, так что вставка новой строки произойдёт раньше, чем будет выполнена модификация старой строки.