DataRow Clase

Definición

Representa una fila de datos en un DataTable.

public ref class DataRow
public class DataRow
[System.Serializable]
public class DataRow
type DataRow = class
[<System.Serializable>]
type DataRow = class
Public Class DataRow
Herencia
DataRow
Atributos

Ejemplos

En el ejemplo siguiente se crea un nuevo DataRow mediante una llamada al NewRow método del DataTable objeto .

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

Comentarios

Los DataRow objetos y DataColumn son componentes principales de .DataTable Use el DataRow objeto y sus propiedades y métodos para recuperar y evaluar; e insertar, eliminar y actualizar los valores de DataTable. DataRowCollection representa los objetos reales DataRow de DataTabley DataColumnCollection contiene los DataColumn objetos que describen el esquema de DataTable. Utilice la propiedad sobrecargada Item[] para devolver o establecer el valor de .DataColumn

Use las HasVersion propiedades y IsNull para determinar el estado de un valor de fila determinado y la RowState propiedad para determinar el estado de la fila en relación con su elemento primario DataTable.

Para crear un objeto DataRow, use el NewRow método del DataTable objeto . Después de crear un objeto DataRow, use el Add método para agregar el nuevo DataRow a DataRowCollection. Por último, llame al AcceptChanges método del DataTable objeto para confirmar la adición. Para obtener más información sobre cómo agregar datos a , DataTablevea Agregar datos a una DataTable.

Puede eliminar de DataRowDataRowCollection mediante una llamada al Remove método de DataRowCollection, o llamando al Delete método del DataRow objeto . El Remove método quita la fila de la colección. Por el contrario, Delete marca para DataRow su eliminación. La eliminación real se produce cuando se llama al AcceptChanges método . Al llamar a Delete, puede comprobar mediante programación qué filas se marcan para su eliminación antes de eliminarlas realmente. Para obtener más información, consulte Eliminación de dataRow.

Constructores

DataRow(DataRowBuilder)

Inicializa una nueva instancia de la clase DataRow mediante el generador especificado. Solo para uso interno.

Propiedades

HasErrors

Obtiene un valor que indica si hay errores en una fila.

Item[DataColumn, DataRowVersion]

Obtiene la versión específica de datos almacenados en el DataColumn determinado.

Item[DataColumn]

Obtiene o establece los datos almacenados en el DataColumn especificado.

Item[Int32, DataRowVersion]

Obtiene los datos almacenados en la columna, especificada mediante índice y versión de los datos que se van a recuperar.

Item[Int32]

Obtiene o establece los datos almacenados en la columna especificada mediante un índice.

Item[String, DataRowVersion]

Obtiene la versión específica de datos almacenados en la columna con nombre.

Item[String]

Obtiene o establece los datos almacenados en la columna especificada mediante un nombre.

ItemArray

Obtiene o establece todos los valores de esta fila mediante una matriz.

RowError

Obtiene o establece la descripción de error personalizada para una fila.

RowState

Obtiene el estado actual de la fila con respecto a su relación con la colección DataRowCollection.

Table

Obtiene el DataTable para el que esta fila tiene un esquema.

Métodos

AcceptChanges()

Confirma todos los cambios realizados en esta fila desde la última vez que se llamó a AcceptChanges().

BeginEdit()

Inicia una operación de edición en un objeto DataRow.

CancelEdit()

Cancela la edición actual de la fila.

ClearErrors()

Borra los errores respecto de la fila. Incluye la propiedad RowError y los errores establecidos con SetColumnError(Int32, String).

Delete()

Elimina DataRow.

EndEdit()

Finaliza la edición que se está produciendo en la fila.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetChildRows(DataRelation)

Obtiene las filas secundarias de este DataRow mediante el DataRelation especificado.

GetChildRows(DataRelation, DataRowVersion)

Obtiene las filas secundarias de un DataRow mediante el DataRelation especificado y DataRowVersion.

GetChildRows(String)

Obtiene las filas secundarias de un DataRow mediante el RelationName especificado de un DataRelation.

GetChildRows(String, DataRowVersion)

Obtiene las filas secundarias de un DataRow mediante el RelationName especificado de un DataRelation y DataRowVersion.

GetColumnError(DataColumn)

Obtiene la descripción de error del DataColumn especificado.

GetColumnError(Int32)

Obtiene la descripción de error para la columna especificada mediante un índice.

GetColumnError(String)

Obtiene la descripción de error para una columna, especificada mediante un nombre.

GetColumnsInError()

Obtiene una matriz de columnas que tienen errores.

GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetParentRow(DataRelation)

Obtiene la fila primaria de un DataRow mediante el DataRelation especificado.

GetParentRow(DataRelation, DataRowVersion)

Obtiene la fila primaria de DataRow mediante el DataRelation especificado y DataRowVersion.

GetParentRow(String)

Obtiene la fila primaria de DataRow mediante el RelationName especificado de DataRelation.

GetParentRow(String, DataRowVersion)

Obtiene la fila primaria de un DataRow mediante el RelationName especificado de un DataRelation y DataRowVersion.

GetParentRows(DataRelation)

Obtiene las filas primarias de DataRow mediante el DataRelation especificado.

GetParentRows(DataRelation, DataRowVersion)

Obtiene las filas primarias de DataRow mediante el DataRelation especificado y DataRowVersion.

GetParentRows(String)

Obtiene las filas primarias de DataRow mediante el RelationName especificado de un DataRelation.

GetParentRows(String, DataRowVersion)

Obtiene las filas primarias de un DataRow mediante el RelationName especificado de un DataRelation y DataRowVersion.

GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
HasVersion(DataRowVersion)

Obtiene un valor que indica si existe una versión especificada.

IsNull(DataColumn)

Obtiene un valor que indica si el objeto DataColumn especificado contiene un valor null.

IsNull(DataColumn, DataRowVersion)

Obtiene un valor que indica si el objeto DataColumn y la enumeración DataRowVersion especificados contiene un valor null.

IsNull(Int32)

Obtiene un valor que indica si la columna en el índice especificado contiene un valor null.

IsNull(String)

Obtiene un valor que indica si la columna con nombre contiene un valor null.

MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
RejectChanges()

Rechaza todos los cambios realizados en esta fila desde la última vez que se llamó a AcceptChanges().

SetAdded()

Cambia la propiedad RowState de un objeto DataRow a Added.

SetColumnError(DataColumn, String)

Establece la descripción de error para una columna especificada como DataColumn.

SetColumnError(Int32, String)

Establece la descripción de error para una columna especificada mediante un índice.

SetColumnError(String, String)

Establece la descripción de error para una columna especificada mediante un nombre.

SetModified()

Cambia la propiedad RowState de un objeto DataRow a Modified.

SetNull(DataColumn)

Establece el valor del objeto DataColumn especificado en un valor null.

SetParentRow(DataRow)

Establece la fila primaria de un DataRow con un nuevo DataRow primario especificado.

SetParentRow(DataRow, DataRelation)

Establece la fila primaria de un DataRow con un nuevo DataRow primario especificado y DataRelation.

ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Métodos de extensión

Field<T>(DataRow, DataColumn)

Proporciona acceso fuertemente tipado a cada uno de los valores de columna de la fila especificada. El método Field<T>(DataRow, DataColumn) también admite tipos que aceptan valores NULL.

Field<T>(DataRow, DataColumn, DataRowVersion)

Proporciona acceso fuertemente tipado a cada uno de los valores de columna de la fila especificada. El método Field<T>(DataRow, DataColumn, DataRowVersion) también admite tipos que aceptan valores NULL.

Field<T>(DataRow, Int32)

Proporciona acceso fuertemente tipado a cada uno de los valores de columna de la fila especificada. El método Field<T>(DataRow, Int32) también admite tipos que aceptan valores NULL.

Field<T>(DataRow, Int32, DataRowVersion)

Proporciona acceso fuertemente tipado a cada uno de los valores de columna de la fila especificada. El método Field<T>(DataRow, Int32, DataRowVersion) también admite tipos que aceptan valores NULL.

Field<T>(DataRow, String)

Proporciona acceso fuertemente tipado a cada uno de los valores de columna de la fila especificada. El método Field<T>(DataRow, String) también admite tipos que aceptan valores NULL.

Field<T>(DataRow, String, DataRowVersion)

Proporciona acceso fuertemente tipado a cada uno de los valores de columna de la fila especificada. El método Field<T>(DataRow, String, DataRowVersion) también admite tipos que aceptan valores NULL.

SetField<T>(DataRow, DataColumn, T)

Establece un nuevo valor para la columna especificada en DataRow. El método SetField<T>(DataRow, DataColumn, T) también admite tipos que aceptan valores NULL.

SetField<T>(DataRow, Int32, T)

Establece un nuevo valor para la columna especificada en la DataRow donde se llama al método. El método SetField<T>(DataRow, Int32, T) también admite tipos que aceptan valores NULL.

SetField<T>(DataRow, String, T)

Establece un nuevo valor para la columna especificada en DataRow. El método SetField<T>(DataRow, String, T) también admite tipos que aceptan valores NULL.

Se aplica a

Seguridad para subprocesos

Este tipo es seguro para las operaciones de lectura multiproceso. Debe sincronizar las operaciones de escritura.

Consulte también