Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase DataView

 

Publicado: octubre de 2016

Representa una vista personalizada enlazables de datos de un objeto DataTable para ordenación, filtrado, búsqueda, edición y navegación. DataView no almacena datos, pero en su lugar representa una vista conectada de su DataTable correspondiente. Los cambios a los datos de DataView afectarán a DataTable. Los cambios a los datos de DataTable afectarán a todos los objetos DataViewasociados a él.

Espacio de nombres:   System.Data
Ensamblado:  System.Data (en System.Data.dll)


public class DataView : MarshalByValueComponent, IBindingListView, 
	IBindingList, IList, ICollection, IEnumerable, ITypedList, ISupportInitializeNotification, 
	ISupportInitialize

NombreDescripción
System_CAPS_pubmethodDataView()

Inicializa una nueva instancia de la clase DataView.

System_CAPS_pubmethodDataView(DataTable)

Inicializa una nueva instancia de la clase DataView con el objeto DataTable especificado.

System_CAPS_pubmethodDataView(DataTable, String, String, DataViewRowState)

Inicializa una nueva instancia de la clase DataView con los elementos DataTable, RowFilter, Sort y DataViewRowState especificados.

NombreDescripción
System_CAPS_pubpropertyAllowDelete

Establece u obtiene un valor que indica si se permiten las eliminaciones.

System_CAPS_pubpropertyAllowEdit

Obtiene o establece un valor que indica si se permiten las ediciones.

System_CAPS_pubpropertyAllowNew

Obtiene o establece un valor que indica si las nuevas filas se pueden agregar con el método AddNew.

System_CAPS_pubpropertyApplyDefaultSort

Obtiene o establece un valor que indica si se usará el orden predeterminado. El orden predeterminado (ascendente) por todas las claves principales según se especifica por PrimaryKey.

System_CAPS_pubpropertyContainer

Obtiene el contenedor del componente.(Heredado de MarshalByValueComponent).

System_CAPS_pubpropertyCount

Obtiene el número de registros de la DataView después de aplicarse RowFilter y RowStateFilter.

System_CAPS_pubpropertyDataViewManager

Obtiene el objeto DataViewManager asociado a esta vista.

System_CAPS_pubpropertyDesignMode

Obtiene un valor que indica si el componente está actualmente en modo de diseño.(Heredado de MarshalByValueComponent).

System_CAPS_protpropertyEvents

Obtiene la lista de controladores de eventos que están asociados a este componente.(Heredado de MarshalByValueComponent).

System_CAPS_pubpropertyIsInitialized

Obtiene un valor que indica si se ha inicializado el componente.

System_CAPS_protpropertyIsOpen

Obtiene un valor que indica si el origen de datos está abierto actualmente y proyecta vistas de datos en la DataTable.

System_CAPS_pubpropertyItem[Int32]

Obtiene una fila de datos de una tabla especificada.

System_CAPS_pubpropertyRowFilter

Obtiene o establece la expresión usada para filtrar las filas que se deben mostrar en DataView.

System_CAPS_pubpropertyRowStateFilter

Obtiene o establece el filtro de estado de la fila que se usa en la DataView.

System_CAPS_pubpropertySite

Obtiene o establece el sitio del componente.(Heredado de MarshalByValueComponent).

System_CAPS_pubpropertySort

Obtiene o establece el criterio de ordenación de columnas y el criterio de ordenación para el DataView.

System_CAPS_pubpropertyTable

Obtiene o establece el DataTable de origen.

NombreDescripción
System_CAPS_pubmethodAddNew()

Agrega una nueva fila a DataView.

System_CAPS_pubmethodBeginInit()

Activa la inicialización de un objeto DataView que se emplea en un formulario o que usa otro componente. La inicialización se produce en tiempo de ejecución.

System_CAPS_protmethodClose()

Cierra el objeto DataView.

System_CAPS_protmethodColumnCollectionChanged(Object, CollectionChangeEventArgs)

Ocurre después de modificar correctamente una DataColumnCollection.

System_CAPS_pubmethodCopyTo(Array, Int32)

Copia los elementos en una matriz. Solo para interfaces de Web Forms.

System_CAPS_pubmethodDelete(Int32)

Elimina una fila en el índice especificado.

System_CAPS_pubmethodDispose()

Libera todos los recursos que usa MarshalByValueComponent.(Heredado de MarshalByValueComponent).

System_CAPS_protmethodDispose(Boolean)

Se deshace de los recursos (distintos de la memoria) usados por el objeto DataView.(Invalida MarshalByValueComponent.Dispose(Boolean)).

System_CAPS_pubmethodEndInit()

Finaliza la inicialización de un objeto DataView que se emplea en un formulario o que utiliza otro componente. La inicialización se produce en tiempo de ejecución.

System_CAPS_pubmethodEquals(DataView)

Determina si las instancias de DataView especificadas se consideran iguales.

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de MarshalByValueComponent).

System_CAPS_pubmethodFind(Object)

Encuentra una fila en la DataView por el valor de clave de ordenación especificado.

System_CAPS_pubmethodFind(Object[])

Encuentra una fila en la DataView por los valores de clave de ordenación especificados.

System_CAPS_pubmethodFindRows(Object)

Devuelve una matriz de DataRowView objetos cuyas columnas coinciden con el valor de criterio de ordenación especificado.

System_CAPS_pubmethodFindRows(Object[])

Devuelve una matriz de DataRowView objetos cuyas columnas coinciden con el valor de criterio de ordenación especificado.

System_CAPS_pubmethodGetEnumerator()

Obtiene un enumerador para este elemento DataView.

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetService(Type)

Obtiene el implementador de la IServiceProvider.(Heredado de MarshalByValueComponent).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_protmethodIndexListChanged(Object, ListChangedEventArgs)

Ocurre después de modificar correctamente una DataView.

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_protmethodOnListChanged(ListChangedEventArgs)

Genera el evento ListChanged.

System_CAPS_protmethodOpen()

Abre un DataView.

System_CAPS_protmethodReset()

Reservado para uso interno.

System_CAPS_pubmethodToString()

Devuelve un String que contiene el nombre de la Component, si existe. Este método no se debe invalidar.(Heredado de MarshalByValueComponent).

System_CAPS_pubmethodToTable()

Crea y devuelve una nueva DataTable basándose en las filas de una DataView existente.

System_CAPS_pubmethodToTable(Boolean, String[])

Crea y devuelve una nueva DataTable basándose en las filas de una DataView existente.

System_CAPS_pubmethodToTable(String)

Crea y devuelve una nueva DataTable basándose en las filas de una DataView existente.

System_CAPS_pubmethodToTable(String, Boolean, String[])

Crea y devuelve una nueva DataTable basándose en las filas de una DataView existente.

System_CAPS_protmethodUpdateIndex()

Reservado para uso interno.

System_CAPS_protmethodUpdateIndex(Boolean)

Reservado para uso interno.

NombreDescripción
System_CAPS_pubeventDisposed

Agrega un controlador de eventos para escuchar el Disposed evento en el componente.(Heredado de MarshalByValueComponent).

System_CAPS_pubeventInitialized

Se produce cuando se completa la inicialización de DataView.

System_CAPS_pubeventListChanged

Se produce cuando la lista administrada por el DataView cambia.

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Add(Object)

Para una descripción de este miembro, vea IList.Add.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Clear()

Para una descripción de este miembro, vea IList.Clear.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Contains(Object)

Para una descripción de este miembro, vea IList.Contains.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.IndexOf(Object)

Para una descripción de este miembro, vea IList.IndexOf.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Insert(Int32, Object)

Para una descripción de este miembro, vea IList.Insert.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Remove(Object)

Para una descripción de este miembro, vea IList.Remove.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.RemoveAt(Int32)

Para una descripción de este miembro, vea IList.RemoveAt.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIBindingList.AddIndex(PropertyDescriptor)

Para una descripción de este miembro, vea IBindingList.AddIndex.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIBindingList.AddNew()

Para una descripción de este miembro, vea IBindingList.AddNew.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIBindingList.ApplySort(PropertyDescriptor, ListSortDirection)

Para una descripción de este miembro, vea IBindingList.ApplySort.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIBindingList.Find(PropertyDescriptor, Object)

Para una descripción de este miembro, vea IBindingList.Find.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIBindingList.RemoveIndex(PropertyDescriptor)

Para una descripción de este miembro, vea IBindingList.RemoveIndex.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIBindingList.RemoveSort()

Para una descripción de este miembro, vea IBindingList.RemoveSort.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIBindingListView.ApplySort(ListSortDescriptionCollection)

Para una descripción de este miembro, vea IBindingListView.ApplySort.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIBindingListView.RemoveFilter()

Para una descripción de este miembro, vea IBindingListView.RemoveFilter.

System_CAPS_pubinterfaceSystem_CAPS_privmethodITypedList.GetItemProperties(PropertyDescriptor[])

Para una descripción de este miembro, vea ITypedList.GetItemProperties.

System_CAPS_pubinterfaceSystem_CAPS_privmethodITypedList.GetListName(PropertyDescriptor[])

Para una descripción de este miembro, vea ITypedList.GetListName.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection.IsSynchronized

Para una descripción de este miembro, vea ICollection.IsSynchronized.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection.SyncRoot

Para una descripción de este miembro, vea ICollection.SyncRoot.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList.IsFixedSize

Para una descripción de este miembro, vea IList.IsFixedSize.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList.IsReadOnly

Para una descripción de este miembro, vea IList.IsReadOnly.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList.Item[Int32]

Para una descripción de este miembro, vea IList.Item.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingList.AllowEdit

Para una descripción de este miembro, vea IBindingList.AllowEdit.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingList.AllowNew

Para una descripción de este miembro, vea IBindingList.AllowNew.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingList.AllowRemove

Para una descripción de este miembro, vea IBindingList.AllowRemove.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingList.IsSorted

Para una descripción de este miembro, vea IBindingList.IsSorted.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingList.SortDirection

Para una descripción de este miembro, vea IBindingList.SortDirection.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingList.SortProperty

Para una descripción de este miembro, vea IBindingList.SortProperty.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingList.SupportsChangeNotification

Para una descripción de este miembro, vea IBindingList.SupportsChangeNotification.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingList.SupportsSearching

Para una descripción de este miembro, vea IBindingList.SupportsSearching.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingList.SupportsSorting

Para una descripción de este miembro, vea IBindingList.SupportsSorting.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingListView.Filter

Para una descripción de este miembro, vea IBindingListView.Filter.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingListView.SortDescriptions

Para una descripción de este miembro, vea IBindingListView.SortDescriptions.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingListView.SupportsAdvancedSorting

Para una descripción de este miembro, vea IBindingListView.SupportsAdvancedSorting.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingListView.SupportsFiltering

Para una descripción de este miembro, vea IBindingListView.SupportsFiltering.

NombreDescripción
System_CAPS_pubmethodAsParallel()

Sobrecargado. Habilita la paralelización de una consulta.(Definido por ParallelEnumerable).

System_CAPS_pubmethodAsQueryable()

Sobrecargado. Convierte un IEnumerable para un IQueryable.(Definido por Queryable).

System_CAPS_pubmethodCast<TResult>()

Convierte los elementos de un IEnumerable al tipo especificado.(Definido por Enumerable).

System_CAPS_pubmethodOfType<TResult>()

Filtra los elementos de un IEnumerable basado en un tipo especificado.(Definido por Enumerable).

A major function of the T:System.Data.DataView is to allow for data binding on both Windows Forms and Web Forms.

Additionally, a T:System.Data.DataView can be customized to present a subset of data from the T:System.Data.DataTable. This capability lets you have two controls bound to the same T:System.Data.DataTable, but that show different versions of the data. For example, one control might be bound to a T:System.Data.DataView that shows all the rows in the table, and a second might be configured to display only the rows that have been deleted from the T:System.Data.DataTable. The T:System.Data.DataTable also has a P:System.Data.DataTable.DefaultView property. This returns the default T:System.Data.DataView for the table. For example, if you want to create a custom view on the table, set the P:System.Data.DataView.RowFilter on the T:System.Data.DataView returned by the P:System.Data.DataTable.DefaultView.

To create a filtered and sorted view of data, set the P:System.Data.DataView.RowFilter and P:System.Data.DataView.Sort properties. Then, use the P:System.Data.DataView.Item(System.Int32) property to return a single T:System.Data.DataRowView.

You can also add and delete from the set of rows using the M:System.Data.DataView.AddNew and M:System.Data.DataView.Delete(System.Int32) methods. When you use those methods, the P:System.Data.DataView.RowStateFilter property can set to specify that only deleted rows or new rows be displayed by the T:System.Data.DataView.

System_CAPS_noteNota

If you do not explicitly specify sort criteria for DataView, the DataRowView objects in DataView are sorted based on the index of DataView's corresponding DataRow in the DataTable.RowsDataRowCollection.

LINQ to DataSet allows developers to create complex, powerful queries over a DataSet by using LINQ. A LINQ to DataSet query returns an enumeration of DataRow objects, however, which is not easily used in a binding scenario. DataView can be created from a LINQ to DataSet query and takes on the filtering and sorting characteristics of that query. LINQ to DataSet extends the functionality of the DataView by providing LINQ expression-based filtering and sorting, which allows for much more complex and powerful filtering and sorting operations than string-based filtering and sorting. See Enlace de datos y LINQ to DataSet for more information.

The following example creates a single T:System.Data.DataTable with one column and five rows. Two T:System.Data.DataView objects are created and the P:System.Data.DataView.RowStateFilter is set on each to show different views of the table data. The values are then printed.

using System;
using System.Xml;
using System.Data;
using System.Data.Common;
using System.Windows.Forms;

public class Form1: Form
{
    protected DataSet DataSet1;
    protected DataGrid dataGrid1;



    private void DemonstrateDataView()
    {
        // Create one DataTable with one column.
        DataTable table = new DataTable("table");
        DataColumn colItem = new DataColumn("item",
            Type.GetType("System.String"));
        table.Columns.Add(colItem);

        // Add five items.
        DataRow NewRow;
        for(int i = 0; i <5; i++)
        {
            NewRow = table.NewRow();
            NewRow["item"] = "Item " + i;
            table.Rows.Add(NewRow);
        }
        // Change the values in the table.
        table.AcceptChanges();
        table.Rows[0]["item"]="cat";
        table.Rows[1]["item"] = "dog";

        // Create two DataView objects with the same table.
        DataView firstView = new DataView(table);
        DataView secondView = new DataView(table);

        // Print current table values.
        PrintTableOrView(table,"Current Values in Table");

        // Set first DataView to show only modified 
        // versions of original rows.
        firstView.RowStateFilter=DataViewRowState.ModifiedOriginal;

        // Print values.   
        PrintTableOrView(firstView,"First DataView: ModifiedOriginal");

        // Add one New row to the second view.
        DataRowView rowView;
        rowView=secondView.AddNew();
        rowView["item"] = "fish";

        // Set second DataView to show modified versions of 
        // current rows, or New rows.
        secondView.RowStateFilter=DataViewRowState.ModifiedCurrent 
            | DataViewRowState.Added;
        // Print modified and Added rows.
        PrintTableOrView(secondView, 
            "Second DataView: ModifiedCurrent | Added");
    }

    private void PrintTableOrView(DataTable table, string label)
    {
        // This function prints values in the table or DataView.
        Console.WriteLine("\n" + label);
        for(int i = 0; i<table.Rows.Count;i++)
        {
            Console.WriteLine("\table" + table.Rows[i]["item"]);
        }
        Console.WriteLine();
    }

    private void PrintTableOrView(DataView view, string label)
    {

        // This overload prints values in the table or DataView.
        Console.WriteLine("\n" + label);
        for(int i = 0; i<view.Count;i++)
        {
            Console.WriteLine("\table" + view[i]["item"]);
        }
        Console.WriteLine();
    }
}

The following example creates a T:System.Data.DataView of online orders ordered by total due from a linq_dataset query:

DataTable orders = dataSet.Tables["SalesOrderHeader"];

EnumerableRowCollection<DataRow> query =
    from order in orders.AsEnumerable()
    where order.Field<bool>("OnlineOrderFlag") == true
    orderby order.Field<decimal>("TotalDue")
    select order;

DataView view = query.AsDataView();

bindingSource1.DataSource = view;

.NET Framework
Disponible desde 1.1

This type is safe for multithreaded read operations. You must synchronize any write operations.

Volver al principio
Mostrar: