DataRow Clase

Definición

Espacio de nombres:
System.Data
Ensamblado:
System.Data.dll
Ensamblado:
netstandard.dll

Representa una fila de datos de un DataTableobjeto .

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

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 en DataTable. DataRowCollection representa los objetos reales DataRow de DataTabley DataColumnCollection contiene los DataColumn objetos que describen el esquema de DataTable. Use 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 nuevo DataRow, use el NewRow método del DataTable objeto . Después de crear un nuevo 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 Tabla de datos.

Puede eliminar un DataRow de DataRowCollection mediante una llamada al Remove método de DataRowCollectiono llamando al Delete método del DataRow objeto . El Remove método quita la fila de la colección. Por el contrario, Delete marca el para DataRow la 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

Nombre Description
DataRow(DataRowBuilder)

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

Propiedades

Nombre Description
HasErrors

Obtiene un valor que indica si hay errores en una fila.
Item[DataColumn, DataRowVersion]

Obtiene la versión especificada de los datos almacenados en el especificado DataColumn.
Item[DataColumn]

Obtiene o establece los datos almacenados en el especificado DataColumn.
Item[Int32, DataRowVersion]

Obtiene los datos almacenados en la columna, especificados por índice y versión de los datos que se van a recuperar.
Item[Int32]

Obtiene o establece los datos almacenados en la columna especificada por índice.
Item[String, DataRowVersion]

Obtiene la versión especificada de los datos almacenados en la columna con nombre.
Item[String]

Obtiene o establece los datos almacenados en la columna especificada por nombre.
ItemArray

Obtiene o establece todos los valores de esta fila a través de una matriz.
RowError

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

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

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

Métodos

Nombre Description
AcceptChanges()

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

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

Cancela la edición actual en la fila.
ClearErrors()

Borra los errores de la fila. Esto incluye los RowError errores y establecidos con SetColumnError(Int32, String).
Delete()

Elimina .DataRow
EndEdit()

Finaliza la edición que se produce en la fila.
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
GetChildRows(DataRelation, DataRowVersion)

Obtiene las filas secundarias de un DataRow objeto utilizando el especificado DataRelationy DataRowVersion.
GetChildRows(DataRelation)

Obtiene las filas secundarias de este DataRow objeto mediante el especificado DataRelation.
GetChildRows(String, DataRowVersion)

Obtiene las filas secundarias de un DataRow objeto utilizando el objeto especificado RelationName de y DataRelationDataRowVersion.
GetChildRows(String)

Obtiene las filas secundarias de un DataRow objeto utilizando el especificado RelationName de un DataRelationobjeto .
GetColumnError(DataColumn)

Obtiene la descripción del error del especificado DataColumn.
GetColumnError(Int32)

Obtiene la descripción del error de la columna especificada por índice.
GetColumnError(String)

Obtiene la descripción del error de una columna, especificada por nombre.
GetColumnsInError()

Obtiene una matriz de columnas que tienen errores.
GetHashCode()

Actúa como la función hash predeterminada.

(Heredado de Object)
GetParentRow(DataRelation, DataRowVersion)

Obtiene la fila primaria de un DataRow objeto utilizando el objeto especificado DataRelationy DataRowVersion.
GetParentRow(DataRelation)

Obtiene la fila primaria de un DataRow objeto mediante el especificado DataRelation.
GetParentRow(String, DataRowVersion)

Obtiene la fila primaria de un DataRow objeto utilizando el objeto especificado RelationName de y DataRelationDataRowVersion.
GetParentRow(String)

Obtiene la fila primaria de un DataRow objeto utilizando el especificado RelationName de un DataRelationobjeto .
GetParentRows(DataRelation, DataRowVersion)

Obtiene las filas primarias de un DataRow objeto mediante el especificado DataRelationy DataRowVersion.
GetParentRows(DataRelation)

Obtiene las filas primarias de un DataRow objeto mediante el especificado DataRelation.
GetParentRows(String, DataRowVersion)

Obtiene las filas primarias de un DataRow objeto utilizando el objeto especificado RelationName de y DataRelationDataRowVersion.
GetParentRows(String)

Obtiene las filas primarias de un DataRow objeto utilizando el especificado RelationName de un DataRelationobjeto .
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, DataRowVersion)

Obtiene un valor que indica si el especificado DataColumn y DataRowVersion contiene un valor NULL.
IsNull(DataColumn)

Obtiene un valor que indica si el especificado DataColumn contiene un valor NULL.
IsNull(Int32)

Obtiene un valor que indica si la columna del í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 Objectactual.

(Heredado de Object)
RejectChanges()

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

Cambia el RowState de a DataRowAdded.
SetColumnError(DataColumn, String)

Establece la descripción del error de una columna especificada como .DataColumn
SetColumnError(Int32, String)

Establece la descripción del error de una columna especificada por índice.
SetColumnError(String, String)

Establece la descripción del error de una columna especificada por nombre.
SetModified()

Cambia el RowState de a DataRowModified.
SetNull(DataColumn)

Establece el valor del especificado DataColumn en un valor NULL.
SetParentRow(DataRow, DataRelation)

Establece la fila primaria de un DataRow objeto con el nuevo elemento primario DataRow especificado y DataRelation.
SetParentRow(DataRow)

Establece la fila primaria de un DataRow objeto con el nuevo elemento primario DataRowespecificado.
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Métodos de extensión

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

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

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

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

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

Establece un nuevo valor para la columna especificada en .DataRow El SetField<T>(DataRow, String, T) método 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