DataRow Clase

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
DataRow
Atributos

Ejemplos

En DataRow elejemplosiguienteseDataTable crea un nuevo llamando al métododelobjeto.NewRowThe 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 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 DataColumn yDataTableson componentes principales de.The DataRow and DataColumn objects are primary components of a DataTable. Use el DataRow objeto y sus propiedades y métodos para recuperar y evaluar; e insertar, eliminar y actualizar los valores DataTablede.Use the DataRow object and its properties and methods to retrieve and evaluate; and insert, delete, and update the values in the DataTable. DataRow RepresentalosDataTableobjetos realesDataColumnCollection de y contiene DataTablelos objetosquedescribenelesquemadeDataColumn. DataRowCollectionThe DataRowCollection represents the actual DataRow objects in the DataTable, and the DataColumnCollection contains the DataColumn objects that describe the schema of the DataTable. Use la Item[String, DataRowVersion] propiedad sobrecargada 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 las HasVersion propiedades IsNull y para determinar el estado de un valor de fila determinado y la RowState propiedad para determinar el estado de la fila con respecto a su DataTableelemento primario.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 del DataTable objeto.To create a new DataRow, use the NewRow method of the DataTable object. Después de crear un DataRownuevo, utilice Add el método para DataRowCollectionagregar el DataRow nuevo a.After creating a new DataRow, use the Add method to add the new DataRow to the DataRowCollection. Por último, llame AcceptChanges al método DataTable del 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 sobre cómo agregar datos DataTablea un, vea Agregar datos a un objeto DataTable.For more information about adding data to a DataTable, see Adding Data to a DataTable.

Puede DataRow eliminar un DataRow objeto DataRowCollection de llamando Remove al método de DataRowCollectiono llamando al Delete método del 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. Por el contrario Delete , marca DataRow para la eliminación.In contrast, Delete marks the DataRow for removal. La eliminación real se produce cuando se AcceptChanges llama al método.The actual removal occurs when you call AcceptChanges method. Mediante una Deletellamada a, puede comprobar mediante programación qué filas se marcan para su eliminación antes de eliminarlas realmente.By calling Delete, you can programmatically check which rows are marked for removal before actually deleting them. Para obtener más información, vea eliminación de DataRow.For more information, see DataRow Deletion.

Constructores

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

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

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]

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

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]

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]

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]

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.

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.

RowError

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

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

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

Métodos

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()

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

CancelEdit()

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

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()

Elimina DataRow.Deletes the DataRow.

EndEdit()

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

Equals(Object)

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

(Heredado de Object)
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)

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)

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)

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)

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

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)

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

GetColumnsInError()

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

GetHashCode()

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

(Heredado de Object)
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)

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)

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)

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)

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

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)

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)

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()

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

(Heredado de Object)
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)

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)

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)

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)

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()

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

(Heredado de Object)
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()

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

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)

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)

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

SetModified()

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

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)

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)

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()

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

(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.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)

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)

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)

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)

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)

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)

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)

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)

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 cualquier operación de escritura.You must synchronize any write operations.

Consulte también: