DataRowCollection DataRowCollection DataRowCollection DataRowCollection Class

Definición

Representa una colección de filas para un DataTable.Represents a collection of rows for a DataTable.

public ref class DataRowCollection sealed : System::Data::InternalDataCollectionBase
[System.Serializable]
public sealed class DataRowCollection : System.Data.InternalDataCollectionBase
type DataRowCollection = class
    inherit InternalDataCollectionBase
Public NotInheritable Class DataRowCollection
Inherits InternalDataCollectionBase
Herencia
Atributos

Ejemplos

El primer ejemplo de esta sección imprime el valor de la columna 1 para cada fila en un DataRowCollection.The first example in this section prints the value of column 1 for every row in a DataRowCollection. El segundo ejemplo agrega una nueva fila creada mediante el uso de la NewRow método a la DataRowCollection.The second example adds a new row created by using the NewRow method to the DataRowCollection.

private void ShowRows(DataTable table)
{
    // Print the number of rows in the collection.
    Console.WriteLine(table.Rows.Count);
    // Print the value of columns 1 in each row
    foreach(DataRow row in table.Rows)
    {
        Console.WriteLine(row[1]);
    }
}

private void AddRow(DataTable table)
{
    DataRowCollection rowCollection = table.Rows;
    // Instantiate a new row using the NewRow method.

    DataRow newRow = table.NewRow();
    // Insert code to fill the row with values.

    // Add the row to the DataRowCollection.
    table.Rows.Add(newRow);
}
Private Sub ShowRows(Byval table As DataTable)
    ' Print the number of rows in the collection.
    Console.WriteLine(table.Rows.Count)

    Dim row  As DataRow
    ' Print the value of columns 1 in each row
    For Each row In table.Rows
        Console.WriteLine(row(1))
    Next
End Sub
 
Private Sub AddRow(ByVal table As DataTable)
    ' Instantiate a new row using the NewRow method.
    Dim newRow As DataRow = table.NewRow()
    ' Insert code to fill the row with values.

    ' Add the row to the DataRowCollection.
    table.Rows.Add(newRow)
End Sub

Comentarios

El DataRowCollection es un componente importante de la DataTable.The DataRowCollection is a major component of the DataTable. Mientras el DataColumnCollection define el esquema de la tabla, el DataRowCollection contiene los datos reales para la tabla, donde cada DataRow en el DataRowCollection representa una sola fila.While the DataColumnCollection defines the schema of the table, the DataRowCollection contains the actual data for the table, where each DataRow in the DataRowCollection represents a single row.

Puede llamar a la Add y Remove métodos para insertar y eliminar DataRow objetos desde el DataRowCollection.You can call the Add and Remove methods to insert and delete DataRow objects from the DataRowCollection. También puede llamar a la Find método para buscar DataRow objetos que contienen valores específicos en columnas de clave principal y el Contains para buscar datos basados en caracteres para palabras o frases.You can also call the Find method to search for DataRow objects that contain specific values in primary key columns, and the Contains method to search character-based data for single words or phrases.

Para otras operaciones, como la ordenación o filtrado el DataRowCollection, usar métodos en el DataRowCollectionasociada del DataTable.For other operations, such as sorting or filtering the DataRowCollection, use methods on the DataRowCollection's associated DataTable.

Propiedades

Count Count Count Count

Obtiene el número total de objetos DataRow de esta colección.Gets the total number of DataRow objects in this collection.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Obtiene un valor que indica si InternalDataCollectionBase es de solo lectura.Gets a value that indicates whether the InternalDataCollectionBase is read-only.

(Inherited from InternalDataCollectionBase)
IsSynchronized IsSynchronized IsSynchronized IsSynchronized

Obtiene un valor que indica si el objeto InternalDataCollectionBase está sincronizado.Gets a value that indicates whether the InternalDataCollectionBase is synchronized.

(Inherited from InternalDataCollectionBase)
Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Obtiene la fila en el índice especificado.Gets the row at the specified index.

List List List List

Obtiene los elementos de una colección en forma de lista.Gets the items of the collection as a list.

(Inherited from InternalDataCollectionBase)
SyncRoot SyncRoot SyncRoot SyncRoot

Obtiene un objeto que se puede utilizar para sincronizar la colección.Gets an object that can be used to synchronize the collection.

(Inherited from InternalDataCollectionBase)

Métodos

Add(DataRow) Add(DataRow) Add(DataRow) Add(DataRow)

Agrega el DataRow especificado al objeto DataRowCollection.Adds the specified DataRow to the DataRowCollection object.

Add(Object[]) Add(Object[]) Add(Object[]) Add(Object[])

Crea una fila mediante los valores especificados y la agrega a DataRowCollection.Creates a row using specified values and adds it to the DataRowCollection.

Clear() Clear() Clear() Clear()

Borra todas las filas de la colección.Clears the collection of all rows.

Contains(Object) Contains(Object) Contains(Object) Contains(Object)

Obtiene un valor que indica si la clave principal de cualquier fila de la colección contiene el valor especificado.Gets a value that indicates whether the primary key of any row in the collection contains the specified value.

Contains(Object[]) Contains(Object[]) Contains(Object[]) Contains(Object[])

Obtiene un valor que indica si las columnas de clave principal de cualquier fila de la colección contienen los valores especificados en la matriz de objetos.Gets a value that indicates whether the primary key columns of any row in the collection contain the values specified in the object array.

CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32)

Copia todos los objetos DataRow de esta colección en la matriz especificada, a partir del índice indicado de la matriz de destino.Copies all the DataRow objects from the collection into the given array, starting at the given destination array index.

CopyTo(DataRow[], Int32) CopyTo(DataRow[], Int32) CopyTo(DataRow[], Int32) CopyTo(DataRow[], Int32)

Copia todos los objetos DataRow de esta colección en la matriz especificada, a partir del índice indicado de la matriz de destino.Copies all the DataRow objects from the collection into the given array, starting at the given destination array index.

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

Obtiene la fila especificada por el valor de clave principal.Gets the row specified by the primary key value.

Find(Object[]) Find(Object[]) Find(Object[]) Find(Object[])

Obtiene la fila que contiene los valores de clave principal especificados.Gets the row that contains the specified primary key values.

GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Obtiene una interfaz IEnumerator para esta colección.Gets an IEnumerator for this collection.

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

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

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
IndexOf(DataRow) IndexOf(DataRow) IndexOf(DataRow) IndexOf(DataRow)

Obtiene el índice del objeto DataRow especificado.Gets the index of the specified DataRow object.

InsertAt(DataRow, Int32) InsertAt(DataRow, Int32) InsertAt(DataRow, Int32) InsertAt(DataRow, Int32)

Inserta una nueva fila en la colección en la ubicación especificada.Inserts a new row into the collection at the specified location.

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

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

(Inherited from Object)
Remove(DataRow) Remove(DataRow) Remove(DataRow) Remove(DataRow)

Quita el objeto DataRow especificado de la colección.Removes the specified DataRow from the collection.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

Quita la fila de la colección en el índice especificado.Removes the row at the specified index from the collection.

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

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

(Inherited from Object)

Métodos de extensión

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Convierte los elementos de IEnumerable en el tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtra los elementos de IEnumerable en función de un tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Habilita la paralelización de una consulta.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Convierte una interfaz IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

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: