DataView Clase

Definición

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 en los datos de DataView afectan a DataTable. Los cambios en los datos de DataTable afectan a todos los elementos DataView asociados a él.

public ref class DataView : System::ComponentModel::MarshalByValueComponent, System::Collections::IList, System::ComponentModel::IBindingListView, System::ComponentModel::ISupportInitialize, System::ComponentModel::ISupportInitializeNotification, System::ComponentModel::ITypedList
public ref class DataView : System::ComponentModel::MarshalByValueComponent, System::Collections::IList, System::ComponentModel::IBindingList, System::ComponentModel::ISupportInitialize, System::ComponentModel::ITypedList
public ref class DataView : System::ComponentModel::MarshalByValueComponent, System::Collections::IList, System::ComponentModel::IBindingListView, System::ComponentModel::ISupportInitializeNotification, System::ComponentModel::ITypedList
public ref class DataView : System::ComponentModel::MarshalByValueComponent, System::ComponentModel::IBindingListView, System::ComponentModel::ISupportInitializeNotification, System::ComponentModel::ITypedList
public class DataView : System.ComponentModel.MarshalByValueComponent, System.Collections.IList, System.ComponentModel.IBindingListView, System.ComponentModel.ISupportInitialize, System.ComponentModel.ISupportInitializeNotification, System.ComponentModel.ITypedList
public class DataView : System.ComponentModel.MarshalByValueComponent, System.Collections.IList, System.ComponentModel.IBindingList, System.ComponentModel.ISupportInitialize, System.ComponentModel.ITypedList
public class DataView : System.ComponentModel.MarshalByValueComponent, System.Collections.IList, System.ComponentModel.IBindingListView, System.ComponentModel.ISupportInitializeNotification, System.ComponentModel.ITypedList
public class DataView : System.ComponentModel.MarshalByValueComponent, System.ComponentModel.IBindingListView, System.ComponentModel.ISupportInitializeNotification, System.ComponentModel.ITypedList
type DataView = class
    inherit MarshalByValueComponent
    interface ICollection
    interface IEnumerable
    interface IList
    interface IBindingList
    interface IBindingListView
    interface ISupportInitialize
    interface ISupportInitializeNotification
    interface ITypedList
type DataView = class
    inherit MarshalByValueComponent
    interface IBindingList
    interface IList
    interface ICollection
    interface IEnumerable
    interface ITypedList
    interface ISupportInitialize
type DataView = class
    inherit MarshalByValueComponent
    interface IBindingListView
    interface IBindingList
    interface IList
    interface ICollection
    interface IEnumerable
    interface ITypedList
    interface ISupportInitializeNotification
    interface ISupportInitialize
Public Class DataView
Inherits MarshalByValueComponent
Implements IBindingListView, IList, ISupportInitialize, ISupportInitializeNotification, ITypedList
Public Class DataView
Inherits MarshalByValueComponent
Implements IBindingList, IList, ISupportInitialize, ITypedList
Public Class DataView
Inherits MarshalByValueComponent
Implements IBindingListView, IList, ISupportInitializeNotification, ITypedList
Public Class DataView
Inherits MarshalByValueComponent
Implements IBindingListView, ISupportInitializeNotification, ITypedList
Herencia
Implementaciones

Ejemplos

En el ejemplo siguiente se crea un único DataTable con una columna y cinco filas. Se crean dos DataView objetos y RowStateFilter se establece en cada uno para mostrar vistas diferentes de los datos de la tabla. A continuación, se imprimen los valores.

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.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(view[i]["item"]);
        }
        Console.WriteLine();
    }
}
Private Sub DemonstrateDataView()
    ' Create one DataTable with one column.
    Dim table As New DataTable("table")
    Dim colItem As New DataColumn("item", _
        Type.GetType("System.String"))
    table.Columns.Add(colItem)

    ' Add five items.
    Dim NewRow As DataRow
    Dim i As Integer
    For i = 0 To 4
    
    NewRow = table.NewRow()
    NewRow("item") = "Item " & i
    table.Rows.Add(NewRow)
    Next
    table.AcceptChanges()

    ' Create two DataView objects with the same table.
    Dim firstView As New DataView(table)
    Dim secondView As New DataView(table)
    
    ' Change the values in the table.
    table.Rows(0)("item") = "cat"
    table.Rows(1)("item") = "dog"
    
    ' 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.
    Dim rowView As DataRowView
    rowView = secondView.AddNew()
    rowView("item") = "fish"
    ' Set second DataView to show modified versions of 
    ' current rows, or New rows.
    secondView.RowStateFilter = DataViewRowState.ModifiedCurrent _
        Or DataViewRowState.Added
    ' Print modified and Added rows.
    PrintTableOrView(secondView, _
        "Second DataView: ModifiedCurrent or Added")
End Sub
    
Overloads Private Sub PrintTableOrView( _
    ByVal view As DataView, ByVal label As String)
    Console.WriteLine(label)
    Dim i As Integer
    For i = 0 To view.count - 1
    
    Console.WriteLine(view(i)("item"))
    Next
    Console.WriteLine()
End Sub
    
Overloads Private Sub PrintTableOrView( _
    ByVal table As DataTable, ByVal label As String)
    Console.WriteLine(label)
    Dim i As Integer
    For i = 0 To table.Rows.Count - 1
    Console.WriteLine(table.Rows(i)("item"))
    Next
    Console.WriteLine()
End Sub

En el ejemplo siguiente se crea un DataView de pedidos en línea ordenados por total a partir de una consulta de LINQ to DataSet:

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;
Dim orders As DataTable = dataSet.Tables("SalesOrderHeader")

Dim query = _
    From order In orders.AsEnumerable() _
    Where order.Field(Of Boolean)("OnlineOrderFlag") = True _
    Order By order.Field(Of Decimal)("TotalDue") _
    Select order

Dim view As DataView = query.AsDataView()
bindingSource1.DataSource = view

Comentarios

Una función principal de es permitir el enlace de DataView datos en Windows Forms y Web Forms.

Además, DataView se puede personalizar para presentar un subconjunto de datos de .DataTable Esta funcionalidad le permite tener dos controles enlazados a la misma DataTable, pero que muestran versiones diferentes de los datos. Por ejemplo, un control podría estar enlazado a un DataView objeto que muestra todas las filas de la tabla y un segundo podría configurarse para mostrar solo las filas que se han eliminado de DataTable. DataTable También tiene una DefaultView propiedad . Esto devuelve el valor predeterminado DataView de la tabla. Por ejemplo, si desea crear una vista personalizada en la tabla, establezca en RowFilter el DataView devuelto por .DefaultView

Para crear una vista filtrada y ordenada de datos, establezca las RowFilter propiedades y Sort . A continuación, use la Item[] propiedad para devolver un único DataRowView.

También puede agregar y eliminar del conjunto de filas mediante los AddNew métodos y Delete . Cuando se usan esos métodos, la RowStateFilter propiedad puede establecer para especificar que solo las filas eliminadas o las filas nuevas se muestren mediante DataView.

Nota:

Si no especifica explícitamente criterios de ordenación para DataView, los DataRowView objetos de DataView se ordenan en función del índice de la correspondiente DataRow instancia de DataView en .DataTable.RowsDataRowCollection

LINQ to DataSet permite a los desarrolladores crear consultas complejas y eficaces a través de mediante DataSet LINQ. Sin embargo, una consulta LINQ to DataSet devuelve una enumeración de DataRow objetos, que no se usa fácilmente en un escenario de enlace. DataViewse puede crear a partir de una consulta de LINQ to DataSet y tomar las características de filtrado y ordenación de esa consulta. LINQ to DataSet amplía la funcionalidad del objeto DataView al proporcionar filtrado y ordenación basados en expresiones LINQ, lo que permite operaciones de filtrado y ordenación mucho más complejas y eficaces que las basadas en cadenas. Consulte Enlace de datos y LINQ to DataSet para obtener más información.

Constructores

DataView()

Inicializa una nueva instancia de la clase DataView.

DataView(DataTable)

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

DataView(DataTable, String, String, DataViewRowState)

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

Propiedades

AllowDelete

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

AllowEdit

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

AllowNew

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

ApplyDefaultSort

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.

Container

Obtiene el contenedor del componente.

(Heredado de MarshalByValueComponent)
Count

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

DataViewManager

Obtiene el objeto DataViewManager asociado a esta vista.

DesignMode

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

(Heredado de MarshalByValueComponent)
Events

Obtiene la lista de controladores de eventos asociados a este componente.

(Heredado de MarshalByValueComponent)
IsInitialized

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

IsOpen

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

Item[Int32]

Obtiene una fila de datos de una tabla especificada.

RowFilter

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

RowStateFilter

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

Site

Obtiene o establece el sitio del componente.

(Heredado de MarshalByValueComponent)
Sort

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

Table

Obtiene o establece el DataTable de origen.

Métodos

AddNew()

Agrega una nueva fila a DataView.

BeginInit()

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.

Close()

Cierra el objeto DataView.

ColumnCollectionChanged(Object, CollectionChangeEventArgs)

Ocurre después de modificar correctamente una DataColumnCollection.

CopyTo(Array, Int32)

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

Delete(Int32)

Elimina una fila en el índice especificado.

Dispose()

Libera todos los recursos que usa MarshalByValueComponent.

(Heredado de MarshalByValueComponent)
Dispose(Boolean)

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

EndInit()

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.

Equals(DataView)

Determina si las instancias de DataView especificadas se consideran iguales.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
Find(Object)

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

Find(Object[])

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

FindRows(Object)

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

FindRows(Object[])

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

GetEnumerator()

Obtiene un enumerador para este elemento DataView.

GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetService(Type)

Obtiene el implementador de IServiceProvider.

(Heredado de MarshalByValueComponent)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
IndexListChanged(Object, ListChangedEventArgs)

Ocurre después de modificar correctamente una DataView.

MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
OnListChanged(ListChangedEventArgs)

Genera el evento ListChanged.

Open()

Abre un DataView.

Reset()

Reservado para uso interno.

ToString()

Devuelve una String que contiene el nombre del Component, si existe. Este método no se debe invalidar.

(Heredado de MarshalByValueComponent)
ToTable()

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

ToTable(Boolean, String[])

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

ToTable(String)

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

ToTable(String, Boolean, String[])

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

UpdateIndex()

Reservado para uso interno.

UpdateIndex(Boolean)

Reservado para uso interno.

Eventos

Disposed

Agrega un controlador de eventos para escuchar el evento Disposed sobre el componente.

(Heredado de MarshalByValueComponent)
Initialized

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

ListChanged

Se produce cuando la lista administrada por el DataView cambia.

Implementaciones de interfaz explícitas

IBindingList.AddIndex(PropertyDescriptor)

Para obtener una descripción de este miembro, vea AddIndex(PropertyDescriptor).

IBindingList.AddNew()

Para obtener una descripción de este miembro, vea AddNew().

IBindingList.AllowEdit

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

IBindingList.AllowNew

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

IBindingList.AllowRemove

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

IBindingList.ApplySort(PropertyDescriptor, ListSortDirection)

Para obtener una descripción de este miembro, vea ApplySort(PropertyDescriptor, ListSortDirection).

IBindingList.Find(PropertyDescriptor, Object)

Para obtener una descripción de este miembro, vea Find(PropertyDescriptor, Object).

IBindingList.IsSorted

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

IBindingList.RemoveIndex(PropertyDescriptor)

Para obtener una descripción de este miembro, vea RemoveIndex(PropertyDescriptor).

IBindingList.RemoveSort()

Para obtener una descripción de este miembro, vea RemoveSort().

IBindingList.SortDirection

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

IBindingList.SortProperty

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

IBindingList.SupportsChangeNotification

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

IBindingList.SupportsSearching

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

IBindingList.SupportsSorting

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

IBindingListView.ApplySort(ListSortDescriptionCollection)

Para obtener una descripción de este miembro, vea ApplySort(ListSortDescriptionCollection).

IBindingListView.Filter

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

IBindingListView.RemoveFilter()

Para obtener una descripción de este miembro, vea RemoveFilter().

IBindingListView.SortDescriptions

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

IBindingListView.SupportsAdvancedSorting

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

IBindingListView.SupportsFiltering

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

ICollection.IsSynchronized

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

ICollection.SyncRoot

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

IList.Add(Object)

Para obtener una descripción de este miembro, vea Add(Object).

IList.Clear()

Para obtener una descripción de este miembro, vea Clear().

IList.Contains(Object)

Para obtener una descripción de este miembro, vea Contains(Object).

IList.IndexOf(Object)

Para obtener una descripción de este miembro, vea IndexOf(Object).

IList.Insert(Int32, Object)

Para obtener una descripción de este miembro, vea Insert(Int32, Object).

IList.IsFixedSize

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

IList.IsReadOnly

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

IList.Item[Int32]

Para obtener una descripción de este miembro, vea Item[Int32].

IList.Remove(Object)

Para obtener una descripción de este miembro, vea Remove(Object).

IList.RemoveAt(Int32)

Para obtener una descripción de este miembro, vea RemoveAt(Int32).

ITypedList.GetItemProperties(PropertyDescriptor[])

Para obtener una descripción de este miembro, vea GetItemProperties(PropertyDescriptor[]).

ITypedList.GetListName(PropertyDescriptor[])

Para obtener una descripción de este miembro, vea GetListName(PropertyDescriptor[]).

Métodos de extensión

Cast<TResult>(IEnumerable)

Convierte los elementos de IEnumerable en el tipo especificado.

OfType<TResult>(IEnumerable)

Filtra los elementos de IEnumerable en función de un tipo especificado.

AsParallel(IEnumerable)

Habilita la paralelización de una consulta.

AsQueryable(IEnumerable)

Convierte una interfaz IEnumerable en IQueryable.

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