DataRow DataRow DataRow DataRow Class

Definición

Representa una fila de datos en un DataTable.Represents a row of data in a DataTable.

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

Ejemplos

En el ejemplo siguiente se crea un nuevo DataRow mediante una llamada a la NewRow método de la DataTable objeto.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

Comentarios

El DataRow y DataColumn objetos son los componentes principales de un DataTable.The DataRow and DataColumn objects are primary components of a DataTable. Use la DataRow objeto y sus propiedades y métodos para recuperar y evaluar; Insertar, eliminar y actualizar los valores en el DataTable.Use the DataRow object and its properties and methods to retrieve and evaluate; and insert, delete, and update the values in the DataTable. El DataRowCollection representa real DataRow objetos en el DataTabley el DataColumnCollection contiene el DataColumn objetos que describen el esquema de la 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. Usar sobrecargado Item[String, DataRowVersion] propiedad para devolver o establecer el valor de un DataColumn.Use the overloaded Item[String, DataRowVersion] property to return or set the value of a DataColumn.

Use la HasVersion y IsNull propiedades para determinar el estado del valor de una fila determinada y el RowState propiedad para determinar el estado de la fila con respecto a su elemento primario 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.

Para crear un nuevo DataRow, utilice el NewRow método de la DataTable objeto.To create a new DataRow, use the NewRow method of the DataTable object. Después de crear un nuevo DataRow, utilice el Add método para agregar el nuevo DataRow a la DataRowCollection.After creating a new DataRow, use the Add method to add the new DataRow to the DataRowCollection. Por último, llame a la AcceptChanges método de la DataTable objeto para confirmar la adición.Finally, call the AcceptChanges method of the DataTable object to confirm the addition. Para obtener más información acerca de cómo agregar datos a un DataTable, consulte agregar datos a un objeto DataTable.For more information about adding data to a DataTable, see Adding Data to a DataTable.

Puede eliminar un DataRow desde el DataRowCollection mediante una llamada a la Remove método de la DataRowCollection, o mediante una llamada a la Delete método de la DataRow objeto.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. El Remove método quita la fila de la colección.The Remove method removes the row from the collection. En cambio, Delete marcas el DataRow para su eliminación.In contrast, Delete marks the DataRow for removal. La eliminación real se produce cuando se llama a AcceptChanges método.The actual removal occurs when you call AcceptChanges method. Mediante una llamada a Delete, se puede comprobar mediante programación qué filas están marcadas para eliminación antes de eliminarlos.By calling Delete, you can programmatically check which rows are marked for removal before actually deleting them. Para obtener más información, consulte eliminación de DataRow.For more information, see DataRow Deletion.

Constructores

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

Inicializa una nueva instancia de DataRow.Initializes a new instance of the DataRow. Construye una fila desde el generador.Constructs a row from the builder. Solo para uso interno.Only for internal usage.

Propiedades

HasErrors HasErrors HasErrors HasErrors

Obtiene un valor que indica si hay errores en una fila.Gets a value that indicates whether there are errors in a row.

ItemArray ItemArray ItemArray ItemArray

Obtiene o establece todos los valores de esta fila mediante una matriz.Gets or sets all the values for this row through an array.

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

Obtiene la versión específica de datos almacenados en el DataColumn determinado.Gets the specified version of data stored in the specified DataColumn.

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

Obtiene o establece los datos almacenados en el DataColumn especificado.Gets or sets the data stored in the specified DataColumn.

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

Obtiene los datos almacenados en la columna, especificada mediante índice y versión de los datos que se van a recuperar.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]

Obtiene o establece los datos almacenados en la columna especificada mediante un índice.Gets or sets the data stored in the column specified by index.

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

Obtiene la versión específica de datos almacenados en la columna con nombre.Gets the specified version of data stored in the named column.

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

Obtiene o establece los datos almacenados en la columna especificada mediante un nombre.Gets or sets the data stored in the column specified by name.

RowError RowError RowError RowError

Obtiene o establece la descripción de error personalizada para una fila.Gets or sets the custom error description for a row.

RowState RowState RowState RowState

Obtiene el estado actual de la fila con respecto a su relación con la colección DataRowCollection.Gets the current state of the row with regard to its relationship to the DataRowCollection.

Table Table Table Table

Obtiene el DataTable para el que esta fila tiene un esquema.Gets the DataTable for which this row has a schema.

Métodos

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

Confirma todos los cambios realizados en esta fila desde la última vez que se llamó a AcceptChanges().Commits all the changes made to this row since the last time AcceptChanges() was called.

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

Inicia una operación de edición en un objeto DataRow.Starts an edit operation on a DataRow object.

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

Cancela la edición actual de la fila.Cancels the current edit on the row.

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

Borra los errores respecto de la fila.Clears the errors for the row. Incluye la propiedad RowError y los errores establecidos con SetColumnError(Int32, String).This includes the RowError and errors set with SetColumnError(Int32, String).

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

Elimina DataRow.Deletes the DataRow.

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

Finaliza la edición que se está produciendo en la fila.Ends the edit occurring on the row.

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

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

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

Obtiene las filas secundarias de este DataRow mediante el DataRelation especificado.Gets the child rows of this DataRow using the specified DataRelation.

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

Obtiene las filas secundarias de un DataRow mediante el DataRelation especificado y DataRowVersion.Gets the child rows of a DataRow using the specified DataRelation, and DataRowVersion.

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

Obtiene las filas secundarias de un DataRow mediante el RelationName especificado de un 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)

Obtiene las filas secundarias de un DataRow mediante el RelationName especificado de un DataRelation y 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)

Obtiene la descripción de error del DataColumn especificado.Gets the error description of the specified DataColumn.

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

Obtiene la descripción de error para la columna especificada mediante un índice.Gets the error description for the column specified by index.

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

Obtiene la descripción de error para una columna, especificada mediante un nombre.Gets the error description for a column, specified by name.

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

Obtiene una matriz de columnas que tienen errores.Gets an array of columns that have errors.

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

Sirve como la función hash predeterminada.Serves as the default hash function.

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

Obtiene la fila primaria de un DataRow mediante el DataRelation especificado.Gets the parent row of a DataRow using the specified DataRelation.

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

Obtiene la fila primaria de DataRow mediante el DataRelation especificado y DataRowVersion.Gets the parent row of a DataRow using the specified DataRelation, and DataRowVersion.

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

Obtiene la fila primaria de DataRow mediante el RelationName especificado de 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)

Obtiene la fila primaria de un DataRow mediante el RelationName especificado de un DataRelation y 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)

Obtiene las filas primarias de DataRow mediante el DataRelation especificado.Gets the parent rows of a DataRow using the specified DataRelation.

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

Obtiene las filas primarias de DataRow mediante el DataRelation especificado y DataRowVersion.Gets the parent rows of a DataRow using the specified DataRelation, and DataRowVersion.

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

Obtiene las filas primarias de DataRow mediante el RelationName especificado de un 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)

Obtiene las filas primarias de un DataRow mediante el RelationName especificado de un DataRelation y DataRowVersion.Gets the parent rows of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

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

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

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

Obtiene un valor que indica si existe una versión especificada.Gets a value that indicates whether a specified version exists.

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

Obtiene un valor que indica si el objeto DataColumn especificado contiene un valor 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)

Obtiene un valor que indica si el objeto DataColumn y la enumeración DataRowVersion especificados contiene un valor null.Gets a value that indicates whether the specified DataColumn and DataRowVersion contains a null value.

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

Obtiene un valor que indica si la columna en el índice especificado contiene un valor 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)

Obtiene un valor que indica si la columna con nombre contiene un valor null.Gets a value that indicates whether the named column contains a null value.

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

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

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

Rechaza todos los cambios realizados en esta fila desde la última vez que se llamó a AcceptChanges().Rejects all changes made to the row since AcceptChanges() was last called.

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

Cambia la propiedad RowState de un objeto DataRow a Added.Changes the RowState of a DataRow to Added.

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

Establece la descripción de error para una columna especificada como DataColumn.Sets the error description for a column specified as a DataColumn.

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

Establece la descripción de error para una columna especificada mediante un índice.Sets the error description for a column specified by index.

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

Establece la descripción de error para una columna especificada mediante un nombre.Sets the error description for a column specified by name.

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

Cambia la propiedad RowState de un objeto DataRow a Modified.Changes the RowState of a DataRow to Modified.

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

Establece el valor del objeto DataColumn especificado en un valor null.Sets the value of the specified DataColumn to a null value.

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

Establece la fila primaria de un DataRow con un nuevo DataRow primario especificado.Sets the parent row of a DataRow with specified new parent DataRow.

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

Establece la fila primaria de un DataRow con un nuevo DataRow primario especificado y DataRelation.Sets the parent row of a DataRow with specified new parent DataRow and DataRelation.

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

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Extension Methods

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

Proporciona acceso fuertemente tipado a cada uno de los valores de columna de la fila especificada.Provides strongly-typed access to each of the column values in the specified row. El método Field<T>(DataRow, DataColumn) también admite tipos que aceptan valores 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)

Proporciona acceso fuertemente tipado a cada uno de los valores de columna de la fila especificada.Provides strongly-typed access to each of the column values in the specified row. El método Field<T>(DataRow, DataColumn, DataRowVersion) también admite tipos que aceptan valores 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)

Proporciona acceso fuertemente tipado a cada uno de los valores de columna de la fila especificada.Provides strongly-typed access to each of the column values in the specified row. El método Field<T>(DataRow, Int32) también admite tipos que aceptan valores 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)

Proporciona acceso fuertemente tipado a cada uno de los valores de columna de la fila especificada.Provides strongly-typed access to each of the column values in the specified row. El método Field<T>(DataRow, Int32, DataRowVersion) también admite tipos que aceptan valores 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)

Proporciona acceso fuertemente tipado a cada uno de los valores de columna de la fila especificada.Provides strongly-typed access to each of the column values in the specified row. El método Field<T>(DataRow, String) también admite tipos que aceptan valores 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)

Proporciona acceso fuertemente tipado a cada uno de los valores de columna de la fila especificada.Provides strongly-typed access to each of the column values in the specified row. El método Field<T>(DataRow, String, DataRowVersion) también admite tipos que aceptan valores 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)

Establece un nuevo valor para la columna especificada en DataRow.Sets a new value for the specified column in the DataRow. El método SetField<T>(DataRow, DataColumn, T) también admite tipos que aceptan valores 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)

Establece un nuevo valor para la columna especificada en la DataRow donde se llama al método.Sets a new value for the specified column in the DataRow the method is called on. El método SetField<T>(DataRow, Int32, T) también admite tipos que aceptan valores 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)

Establece un nuevo valor para la columna especificada en DataRow.Sets a new value for the specified column in the DataRow. El método SetField<T>(DataRow, String, T) también admite tipos que aceptan valores NULL.The SetField<T>(DataRow, String, T) method also supports nullable types.

Se aplica a

Seguridad para subprocesos

Este tipo es seguro para las operaciones de lectura multiproceso.This type is safe for multithreaded read operations. Debe sincronizar operaciones de escritura.You must synchronize any write operations.

Consulte también: