DataView Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 debido a 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 al mismo DataTable, pero que muestran versiones diferentes de los datos. Por ejemplo, un control podría estar enlazado a un DataView que muestre 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 dataView correspondiente DataRow
en .DataTable.Rows
DataRowCollection
LINQ to DataSet permite a los desarrolladores crear consultas complejas y eficaces sobre un DataSet mediante 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
GetKeyedService<T>(IServiceProvider, Object) |
Obtiene un servicio de tipo |
GetKeyedServices(IServiceProvider, Type, Object) |
Obtiene una enumeración de servicios de tipo |
GetKeyedServices<T>(IServiceProvider, Object) |
Obtiene una enumeración de servicios de tipo |
GetRequiredKeyedService(IServiceProvider, Type, Object) |
Obtiene un servicio de tipo |
GetRequiredKeyedService<T>(IServiceProvider, Object) |
Obtiene un servicio de tipo |
CreateAsyncScope(IServiceProvider) |
Crea una instancia de AsyncServiceScope que se puede usar para resolver los servicios con ámbito. |
CreateScope(IServiceProvider) |
Crea una instancia de IServiceScope que se puede usar para resolver los servicios con ámbito. |
GetRequiredService(IServiceProvider, Type) |
Obtiene el servicio de tipo |
GetRequiredService<T>(IServiceProvider) |
Obtiene el servicio de tipo |
GetService<T>(IServiceProvider) |
Obtiene el servicio de tipo |
GetServices(IServiceProvider, Type) |
Obtiene una enumeración de los servicios de tipo |
GetServices<T>(IServiceProvider) |
Obtiene una enumeración de los servicios de tipo |
GetFakeLogCollector(IServiceProvider) |
Obtiene el objeto que recopila los registros enviados al registrador falso. |
GetFakeRedactionCollector(IServiceProvider) |
Obtiene la instancia del recopilador de redactores falso del contenedor de inserción de dependencias. |
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
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente las Cuestiones de GitHub como mecanismo de retroalimentación para el contenido y lo sustituiremos por un nuevo sistema de retroalimentación. Para más información, consulta:Enviar y ver comentarios de