DataRow DataRow DataRow DataRow Class

Определение

Представляет строку данных в DataTable.Represents a row of data in a DataTable.

public ref class DataRow
[System.Serializable]
public class DataRow
type DataRow = class
Public Class DataRow
Наследование
DataRowDataRowDataRowDataRow
Атрибуты

Примеры

В следующем примере создается новый DataRow путем вызова NewRow метод DataTable объекта.The following example creates a new DataRow by calling the NewRow method of the DataTable object.

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 DataTable = new DataTable("Names") 

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

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

    Dim lNameColumn As DataColumn = 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

Комментарии

DataRow И DataColumn объекты являются основными компонентами DataTable.The DataRow and DataColumn objects are primary components of a DataTable. Используйте DataRow объект, свойства и методы для получения и оценки; и вставки, удаления и обновите значения в DataTable.Use the DataRow object and its properties and methods to retrieve and evaluate; and insert, delete, and update the values in the DataTable. DataRowCollection Представляет фактический DataRow объекты в DataTableи DataColumnCollection содержит DataColumn объекты, которые описывают схему DataTable.The DataRowCollection represents the actual DataRow objects in the DataTable, and the DataColumnCollection contains the DataColumn objects that describe the schema of the DataTable. Используйте перегруженные Item[String, DataRowVersion] свойство для возврата или установите для параметра DataColumn.Use the overloaded Item[String, DataRowVersion] property to return or set the value of a DataColumn.

Используйте HasVersion и IsNull свойства, чтобы определить состояние значение конкретной строки и RowState свойства, чтобы определить состояние строки, относительно его родительского элемента DataTable.Use the HasVersion and IsNull properties to determine the status of a particular row value, and the RowState property to determine the state of the row relative to its parent DataTable.

Чтобы создать новую DataRow, использовать NewRow метод DataTable объекта.To create a new DataRow, use the NewRow method of the DataTable object. После создания нового DataRow, использовать Add метод для добавления нового DataRow для DataRowCollection.After creating a new DataRow, use the Add method to add the new DataRow to the DataRowCollection. Наконец, вызовите AcceptChanges метод DataTable объект для добавления.Finally, call the AcceptChanges method of the DataTable object to confirm the addition. Дополнительные сведения о добавлении данных к DataTable, см. в разделе Добавление данных в таблицу данных.For more information about adding data to a DataTable, see Adding Data to a DataTable.

Вы можете удалить DataRow из DataRowCollection путем вызова Remove метод DataRowCollection, или путем вызова Delete метод DataRow объекта.You can delete a DataRow from the DataRowCollection by calling the Remove method of the DataRowCollection, or by calling the Delete method of the DataRow object. Remove Метод удаляет строку из коллекции.The Remove method removes the row from the collection. Напротив Delete метки DataRow для удаления.In contrast, Delete marks the DataRow for removal. Фактическое удаление происходит при вызове AcceptChanges метод.The actual removal occurs when you call AcceptChanges method. Путем вызова Delete, позволяет программно проверять, какие строки помечены для удаления, прежде чем выполнять их фактическое удаление.By calling Delete, you can programmatically check which rows are marked for removal before actually deleting them. Дополнительные сведения см. в разделе удаление DataRow.For more information, see DataRow Deletion.

Конструкторы

DataRow(DataRowBuilder) DataRow(DataRowBuilder) DataRow(DataRowBuilder) DataRow(DataRowBuilder)

Инициализирует новый экземпляр DataRow.Initializes a new instance of the DataRow. Создает строку из построителя.Constructs a row from the builder. Только для внутреннего использования.Only for internal usage.

Свойства

HasErrors HasErrors HasErrors HasErrors

Получает значение, показывающее, есть ли ошибки в строке.Gets a value that indicates whether there are errors in a row.

ItemArray ItemArray ItemArray ItemArray

Возвращает или задает все значения для этой строки с помощью массива.Gets or sets all the values for this row through an array.

Item[DataColumn, DataRowVersion] Item[DataColumn, DataRowVersion] Item[DataColumn, DataRowVersion] Item[DataColumn, DataRowVersion]

Получает указанную версию данных, сохраненных в указанном объекте DataColumn.Gets the specified version of data stored in the specified DataColumn.

Item[DataColumn] Item[DataColumn] Item[DataColumn] Item[DataColumn]

Возвращает или задает данные, сохраненные в указанном объекте DataColumn.Gets or sets the data stored in the specified DataColumn.

Item[Int32, DataRowVersion] Item[Int32, DataRowVersion] Item[Int32, DataRowVersion] Item[Int32, DataRowVersion]

Получает данные, сохраненные в столбце, указанном по индексу и версии извлекаемых данных.Gets the data stored in the column, specified by index and version of the data to retrieve.

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Возвращает или задает данные, сохраненные в столбце, указанном по индексу.Gets or sets the data stored in the column specified by index.

Item[String, DataRowVersion] Item[String, DataRowVersion] Item[String, DataRowVersion] Item[String, DataRowVersion]

Получает указанную версию данных, сохраненных в именованном столбце.Gets the specified version of data stored in the named column.

Item[String] Item[String] Item[String] Item[String]

Возвращает или задает данные, сохраненные в столбце, указанном по имени.Gets or sets the data stored in the column specified by name.

RowError RowError RowError RowError

Возвращает или задает настраиваемое описание ошибки для строки.Gets or sets the custom error description for a row.

RowState RowState RowState RowState

Получает текущее состояние строки, относящееся к ее отношению к коллекции DataRowCollection.Gets the current state of the row with regard to its relationship to the DataRowCollection.

Table Table Table Table

Получает объект DataTable, для которого эта строка имеет схему.Gets the DataTable for which this row has a schema.

Методы

AcceptChanges() AcceptChanges() AcceptChanges() AcceptChanges()

Фиксирует все изменения, внесенные в эту строку со времени последнего вызова метода AcceptChanges().Commits all the changes made to this row since the last time AcceptChanges() was called.

BeginEdit() BeginEdit() BeginEdit() BeginEdit()

Начинает операцию изменения объекта DataRow.Starts an edit operation on a DataRow object.

CancelEdit() CancelEdit() CancelEdit() CancelEdit()

Отменяет текущее изменение строки.Cancels the current edit on the row.

ClearErrors() ClearErrors() ClearErrors() ClearErrors()

Очищает ошибки для строки.Clears the errors for the row. Это относится к свойству RowError и ошибкам, установленным с помощью метода SetColumnError(Int32, String).This includes the RowError and errors set with SetColumnError(Int32, String).

Delete() Delete() Delete() Delete()

Удаляет объект DataRow.Deletes the DataRow.

EndEdit() EndEdit() EndEdit() EndEdit()

Прекращает изменение строки.Ends the edit occurring on the row.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetChildRows(DataRelation) GetChildRows(DataRelation) GetChildRows(DataRelation) GetChildRows(DataRelation)

Получает дочерние строки этого объекта DataRow с помощью указанного объекта DataRelation.Gets the child rows of this DataRow using the specified DataRelation.

GetChildRows(DataRelation, DataRowVersion) GetChildRows(DataRelation, DataRowVersion) GetChildRows(DataRelation, DataRowVersion) GetChildRows(DataRelation, DataRowVersion)

Получает дочерние строки объекта DataRow с помощью указанных объектов DataRelation и DataRowVersion.Gets the child rows of a DataRow using the specified DataRelation, and DataRowVersion.

GetChildRows(String) GetChildRows(String) GetChildRows(String) GetChildRows(String)

Получает дочерние строки объекта DataRow с помощью указанного свойства RelationName объекта DataRelation.Gets the child rows of a DataRow using the specified RelationName of a DataRelation.

GetChildRows(String, DataRowVersion) GetChildRows(String, DataRowVersion) GetChildRows(String, DataRowVersion) GetChildRows(String, DataRowVersion)

Получает дочерние строки объекта DataRow с помощью указанного свойства RelationName объектов DataRelation и DataRowVersion.Gets the child rows of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetColumnError(DataColumn) GetColumnError(DataColumn) GetColumnError(DataColumn) GetColumnError(DataColumn)

Получает описание ошибки указанного объекта DataColumn.Gets the error description of the specified DataColumn.

GetColumnError(Int32) GetColumnError(Int32) GetColumnError(Int32) GetColumnError(Int32)

Получает описание ошибки для столбца, указанного по индексу.Gets the error description for the column specified by index.

GetColumnError(String) GetColumnError(String) GetColumnError(String) GetColumnError(String)

Получает описание ошибки для столбца, указанного по имени.Gets the error description for a column, specified by name.

GetColumnsInError() GetColumnsInError() GetColumnsInError() GetColumnsInError()

Получает массив столбцов с ошибками.Gets an array of columns that have errors.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetParentRow(DataRelation) GetParentRow(DataRelation) GetParentRow(DataRelation) GetParentRow(DataRelation)

Получает родительскую строку объекта DataRow с помощью указанного объекта DataRelation.Gets the parent row of a DataRow using the specified DataRelation.

GetParentRow(DataRelation, DataRowVersion) GetParentRow(DataRelation, DataRowVersion) GetParentRow(DataRelation, DataRowVersion) GetParentRow(DataRelation, DataRowVersion)

Получает родительскую строку объекта DataRow с помощью указанных объектов DataRelation и DataRowVersion.Gets the parent row of a DataRow using the specified DataRelation, and DataRowVersion.

GetParentRow(String) GetParentRow(String) GetParentRow(String) GetParentRow(String)

Получает родительскую строку объекта DataRow с помощью указанного свойства RelationName объекта DataRelation.Gets the parent row of a DataRow using the specified RelationName of a DataRelation.

GetParentRow(String, DataRowVersion) GetParentRow(String, DataRowVersion) GetParentRow(String, DataRowVersion) GetParentRow(String, DataRowVersion)

Получает родительскую строку объекта DataRow с помощью указанного свойства RelationName объектов DataRelation и DataRowVersion.Gets the parent row of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetParentRows(DataRelation) GetParentRows(DataRelation) GetParentRows(DataRelation) GetParentRows(DataRelation)

Получает родительские строки объекта DataRow с помощью указанного объекта DataRelation.Gets the parent rows of a DataRow using the specified DataRelation.

GetParentRows(DataRelation, DataRowVersion) GetParentRows(DataRelation, DataRowVersion) GetParentRows(DataRelation, DataRowVersion) GetParentRows(DataRelation, DataRowVersion)

Получает родительские строки объекта DataRow с помощью указанных объектов DataRelation и DataRowVersion.Gets the parent rows of a DataRow using the specified DataRelation, and DataRowVersion.

GetParentRows(String) GetParentRows(String) GetParentRows(String) GetParentRows(String)

Получает родительские строки объекта DataRow с помощью указанного свойства RelationName объекта DataRelation.Gets the parent rows of a DataRow using the specified RelationName of a DataRelation.

GetParentRows(String, DataRowVersion) GetParentRows(String, DataRowVersion) GetParentRows(String, DataRowVersion) GetParentRows(String, DataRowVersion)

Получает родительские строки объекта DataRow с помощью указанного свойства RelationName объектов DataRelation и DataRowVersion.Gets the parent rows of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
HasVersion(DataRowVersion) HasVersion(DataRowVersion) HasVersion(DataRowVersion) HasVersion(DataRowVersion)

Получает значение, показывающее, существует ли указанная версия.Gets a value that indicates whether a specified version exists.

IsNull(DataColumn) IsNull(DataColumn) IsNull(DataColumn) IsNull(DataColumn)

Получает значение, показывающее, содержит ли указанный объект DataColumn значение null.Gets a value that indicates whether the specified DataColumn contains a null value.

IsNull(DataColumn, DataRowVersion) IsNull(DataColumn, DataRowVersion) IsNull(DataColumn, DataRowVersion) IsNull(DataColumn, DataRowVersion)

Получает значение, показывающее, содержит ли указанные объекты DataColumn и DataRowVersion значение null.Gets a value that indicates whether the specified DataColumn and DataRowVersion contains a null value.

IsNull(Int32) IsNull(Int32) IsNull(Int32) IsNull(Int32)

Получает значение, показывающее, содержит ли столбец по указанному индексу значение null.Gets a value that indicates whether the column at the specified index contains a null value.

IsNull(String) IsNull(String) IsNull(String) IsNull(String)

Получает значение, показывающее, содержит ли названный столбец значение null.Gets a value that indicates whether the named column contains a null value.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
RejectChanges() RejectChanges() RejectChanges() RejectChanges()

Отменяет все изменения, внесенные в строку после последнего вызова метода AcceptChanges().Rejects all changes made to the row since AcceptChanges() was last called.

SetAdded() SetAdded() SetAdded() SetAdded()

Изменяет значение свойства RowState объекта DataRow на Added.Changes the RowState of a DataRow to Added.

SetColumnError(DataColumn, String) SetColumnError(DataColumn, String) SetColumnError(DataColumn, String) SetColumnError(DataColumn, String)

Задает описание ошибки для столбца, указанного как DataColumn.Sets the error description for a column specified as a DataColumn.

SetColumnError(Int32, String) SetColumnError(Int32, String) SetColumnError(Int32, String) SetColumnError(Int32, String)

Задает описание ошибки для столбца, указанного по индексу.Sets the error description for a column specified by index.

SetColumnError(String, String) SetColumnError(String, String) SetColumnError(String, String) SetColumnError(String, String)

Задает описание ошибки для столбца, указанного по имени.Sets the error description for a column specified by name.

SetModified() SetModified() SetModified() SetModified()

Изменяет значение свойства RowState объекта DataRow на Modified.Changes the RowState of a DataRow to Modified.

SetNull(DataColumn) SetNull(DataColumn) SetNull(DataColumn) SetNull(DataColumn)

Задает значение null указанному параметру DataColumn.Sets the value of the specified DataColumn to a null value.

SetParentRow(DataRow) SetParentRow(DataRow) SetParentRow(DataRow) SetParentRow(DataRow)

Задает родительскую строку DataRow с указанным новым родительским объектом DataRow.Sets the parent row of a DataRow with specified new parent DataRow.

SetParentRow(DataRow, DataRelation) SetParentRow(DataRow, DataRelation) SetParentRow(DataRow, DataRelation) SetParentRow(DataRow, DataRelation)

Задает родительскую строку DataRow с указанными новыми родительскими объектами DataRow и DataRelation.Sets the parent row of a DataRow with specified new parent DataRow and DataRelation.

ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

Методы расширения

Field<T>(DataRow, DataColumn) Field<T>(DataRow, DataColumn) Field<T>(DataRow, DataColumn) Field<T>(DataRow, DataColumn)

Предоставляет строго типизированный доступ к каждому значению столбца в указанной строке.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, DataColumn) Метод также поддерживает типы, допускающие значение NULL.The Field<T>(DataRow, DataColumn) method also supports nullable types.

Field<T>(DataRow, DataColumn, DataRowVersion) Field<T>(DataRow, DataColumn, DataRowVersion) Field<T>(DataRow, DataColumn, DataRowVersion) Field<T>(DataRow, DataColumn, DataRowVersion)

Предоставляет строго типизированный доступ к каждому значению столбца в указанной строке.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, DataColumn, DataRowVersion) Метод также поддерживает типы, допускающие значение NULL.The Field<T>(DataRow, DataColumn, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, Int32) Field<T>(DataRow, Int32) Field<T>(DataRow, Int32) Field<T>(DataRow, Int32)

Предоставляет строго типизированный доступ к каждому значению столбца в указанной строке.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, Int32) Метод также поддерживает типы, допускающие значение NULL.The Field<T>(DataRow, Int32) method also supports nullable types.

Field<T>(DataRow, Int32, DataRowVersion) Field<T>(DataRow, Int32, DataRowVersion) Field<T>(DataRow, Int32, DataRowVersion) Field<T>(DataRow, Int32, DataRowVersion)

Предоставляет строго типизированный доступ к каждому значению столбца в указанной строке.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, Int32, DataRowVersion) Метод также поддерживает типы, допускающие значение NULL.The Field<T>(DataRow, Int32, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, String) Field<T>(DataRow, String) Field<T>(DataRow, String) Field<T>(DataRow, String)

Предоставляет строго типизированный доступ к каждому значению столбца в указанной строке.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, String) Метод также поддерживает типы, допускающие значение NULL.The Field<T>(DataRow, String) method also supports nullable types.

Field<T>(DataRow, String, DataRowVersion) Field<T>(DataRow, String, DataRowVersion) Field<T>(DataRow, String, DataRowVersion) Field<T>(DataRow, String, DataRowVersion)

Предоставляет строго типизированный доступ к каждому значению столбца в указанной строке.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, String, DataRowVersion) Метод также поддерживает типы, допускающие значение NULL.The Field<T>(DataRow, String, DataRowVersion) method also supports nullable types.

SetField<T>(DataRow, DataColumn, T) SetField<T>(DataRow, DataColumn, T) SetField<T>(DataRow, DataColumn, T) SetField<T>(DataRow, DataColumn, T)

Задает новое значение для указанного столбца в DataRow.Sets a new value for the specified column in the DataRow. SetField<T>(DataRow, DataColumn, T) Метод также поддерживает типы, допускающие значение NULL.The SetField<T>(DataRow, DataColumn, T) method also supports nullable types.

SetField<T>(DataRow, Int32, T) SetField<T>(DataRow, Int32, T) SetField<T>(DataRow, Int32, T) SetField<T>(DataRow, Int32, T)

Задает новое значение для указанного столбца в DataRow вызывается метод.Sets a new value for the specified column in the DataRow the method is called on. SetField<T>(DataRow, Int32, T) Метод также поддерживает типы, допускающие значение NULL.The SetField<T>(DataRow, Int32, T) method also supports nullable types.

SetField<T>(DataRow, String, T) SetField<T>(DataRow, String, T) SetField<T>(DataRow, String, T) SetField<T>(DataRow, String, T)

Задает новое значение для указанного столбца в DataRow.Sets a new value for the specified column in the DataRow. SetField<T>(DataRow, String, T) Метод также поддерживает типы, допускающие значение NULL.The SetField<T>(DataRow, String, T) method also supports nullable types.

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

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

Этот тип является безопасным для многопоточных операций чтения.This type is safe for multithreaded read operations. Необходимо синхронизировать все операции записи.You must synchronize any write operations.

Дополнительно