DataRow Класс

Определение

public ref class DataRow

[System.Serializable]
public class DataRow

public class DataRow

[<System.Serializable>]
type DataRow = class

type DataRow = class

Public Class DataRow

Наследование

Object

DataRow

Атрибуты

SerializableAttribute

Примеры

В следующем примере создается новое DataRow путем вызова NewRow метода DataTable объекта.

private void CreateNewDataRow()
{
    // Use the MakeTable function below to create a new table.
    DataTable table;
    table = MakeNamesTable();

    // Once a table has been created, use the
    // NewRow to create a DataRow.
    DataRow row;
    row = table.NewRow();

    // Then add the new row to the collection.
    row["fName"] = "John";
    row["lName"] = "Smith";
    table.Rows.Add(row);

    foreach(DataColumn column in table.Columns)
        Console.WriteLine(column.ColumnName);
    dataGrid1.DataSource=table;
}

private DataTable MakeNamesTable()
{
    // Create a new DataTable titled 'Names.'
    DataTable namesTable = new DataTable("Names");

    // Add three column objects to the table.
    DataColumn idColumn = new  DataColumn();
    idColumn.DataType = System.Type.GetType("System.Int32");
    idColumn.ColumnName = "id";
    idColumn.AutoIncrement = true;
    namesTable.Columns.Add(idColumn);

    DataColumn fNameColumn = new DataColumn();
    fNameColumn.DataType = System.Type.GetType("System.String");
    fNameColumn.ColumnName = "Fname";
    fNameColumn.DefaultValue = "Fname";
    namesTable.Columns.Add(fNameColumn);

    DataColumn lNameColumn = new DataColumn();
    lNameColumn.DataType = System.Type.GetType("System.String");
    lNameColumn.ColumnName = "LName";
    namesTable.Columns.Add(lNameColumn);

    // Create an array for DataColumn objects.
    DataColumn [] keys = new DataColumn [1];
    keys[0] = idColumn;
    namesTable.PrimaryKey = keys;

    // Return the new DataTable.
    return namesTable;
}

Private Sub CreateNewDataRow()
    ' Use the MakeTable function below to create a new table.
    Dim table As DataTable
    table = MakeNamesTable()

    ' Once a table has been created, use the 
    ' NewRow to create a DataRow.
    Dim row As DataRow 
    row = table.NewRow()

    ' Then add the new row to the collection.
    row("fName") = "John"
    row("lName") = "Smith"
    table.Rows.Add(row)
    
    Dim column As DataColumn
    For Each column in table.Columns
       Console.WriteLine(column.ColumnName)
    Next
    DataGrid1.DataSource=table
 End Sub
 
 Private Function MakeNamesTable() As DataTable
    ' Create a new DataTable titled 'Names.'
    Dim namesTable As New DataTable("Names") 

    ' Add three column objects to the table.
    Dim idColumn As New DataColumn()
    idColumn.DataType = System.Type.GetType("System.Int32")
    idColumn.ColumnName = "id"
    idColumn.AutoIncrement = True
    namesTable.Columns.Add(idColumn)

    Dim fNameColumn As New DataColumn()
    fNameColumn.DataType = System.Type.GetType("System.String")
    fNameColumn.ColumnName = "Fname"
    fNameColumn.DefaultValue = "Fname"
    namesTable.Columns.Add(fNameColumn)

    Dim lNameColumn As New DataColumn()
    lNameColumn.DataType = System.Type.GetType("System.String")
    lNameColumn.ColumnName = "LName"
    namesTable.Columns.Add(lNameColumn)

    ' Create an array for DataColumn objects.
    Dim keys(0) As DataColumn 
    keys(0) = idColumn
    namesTable.PrimaryKey = keys

    ' Return the new DataTable.
    MakeNamesTable = namesTable
 End Function

Комментарии

И DataRowDataColumn объекты являются основными компонентами объекта DataTable. DataRow Используйте объект и его свойства и методы для получения и оценки; и вставки, удаления и обновления значений в объектеDataTable. Представляет DataRowCollection фактические DataRow объекты в объекте DataTableи DataColumnCollection содержит DataColumn объекты, описывающие схему объекта DataTable. Используйте перегруженное Item[] свойство для возврата или задания значения DataColumn.

HasVersion IsNull Используйте свойства для определения состояния определенного значения строки и RowState свойства, чтобы определить состояние строки относительно родительского DataTableзначения.

Чтобы создать новый DataRowобъект, используйте NewRow метод DataTable объекта. После создания нового DataRowиспользуйте Add метод для добавления нового DataRow в .DataRowCollection Наконец, вызовите AcceptChanges метод DataTable объекта, чтобы подтвердить добавление. Дополнительные сведения о добавлении данных в DataTableнабор данных см. в разделе "Добавление данных в dataTable".

Можно удалить DataRow из объекта, Remove вызвав метод DataRowCollectionобъекта или вызвав Delete метод DataRow объекта.DataRowCollection Метод Remove удаляет строку из коллекции. Напротив, Delete помечает DataRow удаление. Фактическое удаление происходит при вызове AcceptChanges метода. При вызове Deleteможно программно проверить, какие строки помечены для удаления перед их удалением. Дополнительные сведения см. в разделе "Удаление dataRow".

Потокобезопасность

Этот тип является безопасным для многопоточных операций чтения. Необходимо синхронизировать все операции записи.

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

• AcceptChanges()
• Add(DataRow)
• DataColumnCollection
• DataColumn
• DataRowView
• DataTable
• HasVersion(DataRowVersion)
• IsNull(Int32)
• Item[Int32]
• NewRow()
• DataRowCollection
• Using DataSets в ADO.NET