DataView 类

定义

命名空间:

System.Data

程序集:

System.Data.Common.dll

Source:

DataView.cs

表示用于排序、筛选、搜索、编辑和导航的 DataTable 的数据绑定自定义视图。 DataView 不存储数据，而是表示其相应 DataTable的连接视图。 对 DataView数据的更改会影响 DataTable。 对 DataTable数据所做的更改将影响与之关联的所有 DataView。

public ref 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.IBindingListView, System.ComponentModel.ISupportInitialize, 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

Public Class DataView
Inherits MarshalByValueComponent
Implements IBindingListView, IList, ISupportInitialize, ISupportInitializeNotification, ITypedList

继承

Object

MarshalByValueComponent

DataView

实现

ICollection IEnumerable IList IBindingList IBindingListView ISupportInitialize ISupportInitializeNotification ITypedList

示例

以下示例创建一个包含一列和五行的单个 DataTable。 创建两个 DataView 对象，并在每个对象上设置 RowStateFilter 以显示表数据的不同视图。 然后打印这些值。

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

以下示例创建一个按 LINQ to DataSet 查询按总计排序的联机订单 DataView：

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

注解

DataView 的主要功能是允许在 Windows 窗体和 Web 窗体上绑定数据。

此外，还可以自定义 DataView，以显示来自 DataTable的数据子集。 此功能使你可以将两个控件绑定到同一 DataTable，但显示不同版本的数据。 例如，一个控件可能绑定到显示表中所有行的 DataView，第二个控件可能配置为仅显示从 DataTable中删除的行。 DataTable 还有一个 DefaultView 属性。 这会返回表的默认 DataView。 例如，如果要在表上创建自定义视图，请在 DefaultView返回的 DataView 上设置 RowFilter。

若要创建经过筛选和排序的数据视图，请设置 RowFilter 和 Sort 属性。 然后，使用 Item[] 属性返回单个 DataRowView。

还可以使用 AddNew 和 Delete 方法从行集中添加和删除。 使用这些方法时，RowStateFilter 属性可以设置为指定只有已删除的行或新行才会由 DataView显示。

注意

如果未显式指定 DataView的排序条件，则 DataView 中的 DataRowView 对象将根据 DataTable.RowsDataRowCollection中 DataView 的相应 DataRow 索引进行排序。

LINQ to DataSet 允许开发人员使用 LINQ 对 DataSet 创建复杂的强大查询。 但是，LINQ to DataSet 查询返回 DataRow 对象的枚举，这在绑定方案中不容易使用。 可以从 LINQ to DataSet 查询创建 DataView，并采用该查询的筛选和排序特征。 LINQ to DataSet 通过提供基于 LINQ 表达式的筛选和排序来扩展 DataView 的功能，这允许比基于字符串的筛选和排序更复杂、更强大的筛选和排序操作。 有关详细信息，请参阅 数据绑定和 LINQ to DataSet。

构造函数

DataView()	初始化 DataView 类的新实例。
DataView(DataTable)	使用指定的 DataTable初始化 DataView 类的新实例。
DataView(DataTable, String, String, DataViewRowState)	使用指定的 DataTable、RowFilter、Sort和 DataViewRowState初始化 DataView 类的新实例。

属性

AllowDelete	获取或设置一个值，该值指示是否允许删除。
AllowEdit	获取或设置一个值，该值指示是否允许编辑。
AllowNew	获取或设置一个值，该值指示是否可以使用 AddNew() 方法添加新行。
ApplyDefaultSort	获取或设置一个值，该值指示是否使用默认排序。 默认排序由 PrimaryKey指定的所有主键（升序）。
Container	获取组件的容器。 (继承自 MarshalByValueComponent)
Count	获取应用 RowFilter 和 RowStateFilter 后 DataView 中的记录数。
DataViewManager	获取与此视图关联的 DataViewManager。
DesignMode	获取一个值，该值指示组件当前是否处于设计模式。 (继承自 MarshalByValueComponent)
Events	获取附加到此组件的事件处理程序的列表。 (继承自 MarshalByValueComponent)
IsInitialized	获取一个值，该值指示是否初始化组件。
IsOpen	获取一个值，该值指示数据源当前是否处于打开状态，并投影 DataTable上的数据视图。
Item[Int32]	从指定的表获取一行数据。
RowFilter	获取或设置用于筛选在 DataView中查看的行的表达式。
RowStateFilter	获取或设置 DataView中使用的行状态筛选器。
Site	获取或设置组件的站点。 (继承自 MarshalByValueComponent)
Sort	获取或设置排序列或列，以及 DataView的排序顺序。
Table	获取或设置源 DataTable。

方法

AddNew()	向 DataView添加新行。
BeginInit()	启动在窗体上使用或由另一个组件使用的 DataView 的初始化。 初始化在运行时发生。
Close()	关闭 DataView。
ColumnCollectionChanged(Object, CollectionChangeEventArgs)	成功更改 DataColumnCollection 后发生。
CopyTo(Array, Int32)	将项复制到数组中。 仅适用于 Web 窗体接口。
Delete(Int32)	删除指定索引处的行。
Dispose()	释放 MarshalByValueComponent使用的所有资源。 (继承自 MarshalByValueComponent)
Dispose(Boolean)	释放 DataView 对象使用的资源（内存以外的资源）。
EndInit()	结束在窗体上使用或由另一个组件使用的 DataView 的初始化。 初始化在运行时发生。
Equals(DataView)	确定指定的 DataView 实例是否被视为相等。
Equals(Object)	确定指定的对象是否等于当前对象。 (继承自 Object)
Find(Object)	按指定的排序键值查找 DataView 中的行。
Find(Object[])	按指定的排序键值查找 DataView 中的行。
FindRows(Object)	返回一个 DataRowView 对象的数组，其列与指定的排序键值匹配。
FindRows(Object[])	返回一个 DataRowView 对象的数组，其列与指定的排序键值匹配。
GetEnumerator()	获取此 DataView的枚举数。
GetHashCode()	用作默认哈希函数。 (继承自 Object)
GetService(Type)	获取 IServiceProvider的实现者。 (继承自 MarshalByValueComponent)
GetType()	获取当前实例的 Type。 (继承自 Object)
IndexListChanged(Object, ListChangedEventArgs)	成功更改 DataView 后发生。
MemberwiseClone()	创建当前 Object的浅表副本。 (继承自 Object)
OnListChanged(ListChangedEventArgs)	引发 ListChanged 事件。
Open()	打开 DataView。
Reset()	仅供内部使用。
ToString()	返回一个 String，其中包含 Component的名称（如果有）。 不应重写此方法。 (继承自 MarshalByValueComponent)
ToTable()	根据现有 DataView中的行创建并返回新的 DataTable。
ToTable(Boolean, String[])	根据现有 DataView中的行创建并返回新的 DataTable。
ToTable(String)	根据现有 DataView中的行创建并返回新的 DataTable。
ToTable(String, Boolean, String[])	根据现有 DataView中的行创建并返回新的 DataTable。
UpdateIndex()	仅供内部使用。
UpdateIndex(Boolean)	仅供内部使用。

事件

Disposed	添加事件处理程序以侦听组件上的 Disposed 事件。 (继承自 MarshalByValueComponent)
Initialized	在完成 DataView 初始化时发生。
ListChanged	当由 DataView 管理的列表发生更改时发生。

显式接口实现

IBindingList.AddIndex(PropertyDescriptor)	有关此成员的说明，请参阅 AddIndex(PropertyDescriptor)。
IBindingList.AddNew()	有关此成员的说明，请参阅 AddNew()。
IBindingList.AllowEdit	有关此成员的说明，请参阅 AllowEdit。
IBindingList.AllowNew	有关此成员的说明，请参阅 AllowNew。
IBindingList.AllowRemove	有关此成员的说明，请参阅 AllowRemove。
IBindingList.ApplySort(PropertyDescriptor, ListSortDirection)	有关此成员的说明，请参阅 ApplySort(PropertyDescriptor, ListSortDirection)。
IBindingList.Find(PropertyDescriptor, Object)	有关此成员的说明，请参阅 Find(PropertyDescriptor, Object)。
IBindingList.IsSorted	有关此成员的说明，请参阅 IsSorted。
IBindingList.RemoveIndex(PropertyDescriptor)	有关此成员的说明，请参阅 RemoveIndex(PropertyDescriptor)。
IBindingList.RemoveSort()	有关此成员的说明，请参阅 RemoveSort()。
IBindingList.SortDirection	有关此成员的说明，请参阅 SortDirection。
IBindingList.SortProperty	有关此成员的说明，请参阅 SortProperty。
IBindingList.SupportsChangeNotification	有关此成员的说明，请参阅 SupportsChangeNotification。
IBindingList.SupportsSearching	有关此成员的说明，请参阅 SupportsSearching。
IBindingList.SupportsSorting	有关此成员的说明，请参阅 SupportsSorting。
IBindingListView.ApplySort(ListSortDescriptionCollection)	有关此成员的说明，请参阅 ApplySort(ListSortDescriptionCollection)。
IBindingListView.Filter	有关此成员的说明，请参阅 Filter。
IBindingListView.RemoveFilter()	有关此成员的说明，请参阅 RemoveFilter()。
IBindingListView.SortDescriptions	有关此成员的说明，请参阅 SortDescriptions。
IBindingListView.SupportsAdvancedSorting	有关此成员的说明，请参阅 SupportsAdvancedSorting。
IBindingListView.SupportsFiltering	有关此成员的说明，请参阅 SupportsFiltering。
ICollection.IsSynchronized	有关此成员的说明，请参阅 IsSynchronized。
ICollection.SyncRoot	有关此成员的说明，请参阅 SyncRoot。
IList.Add(Object)	有关此成员的说明，请参阅 Add(Object)。
IList.Clear()	有关此成员的说明，请参阅 Clear()。
IList.Contains(Object)	有关此成员的说明，请参阅 Contains(Object)。
IList.IndexOf(Object)	有关此成员的说明，请参阅 IndexOf(Object)。
IList.Insert(Int32, Object)	有关此成员的说明，请参阅 Insert(Int32, Object)。
IList.IsFixedSize	有关此成员的说明，请参阅 IsFixedSize。
IList.IsReadOnly	有关此成员的说明，请参阅 IsReadOnly。
IList.Item[Int32]	有关此成员的说明，请参阅 Item[Int32]。
IList.Remove(Object)	有关此成员的说明，请参阅 Remove(Object)。
IList.RemoveAt(Int32)	有关此成员的说明，请参阅 RemoveAt(Int32)。
ITypedList.GetItemProperties(PropertyDescriptor[])	有关此成员的说明，请参阅 GetItemProperties(PropertyDescriptor[])。
ITypedList.GetListName(PropertyDescriptor[])	有关此成员的说明，请参阅 GetListName(PropertyDescriptor[])。

扩展方法

GetKeyedService<T>(IServiceProvider, Object)	从 IServiceProvider获取类型 T 的服务。
GetKeyedServices(IServiceProvider, Type, Object)	从 IServiceProvider获取类型为 serviceType 的服务的枚举。
GetKeyedServices<T>(IServiceProvider, Object)	从 IServiceProvider获取类型为 T 的服务的枚举。
GetRequiredKeyedService(IServiceProvider, Type, Object)	从 IServiceProvider获取类型 serviceType 的服务。
GetRequiredKeyedService<T>(IServiceProvider, Object)	从 IServiceProvider获取类型 T 的服务。
CreateAsyncScope(IServiceProvider)	创建可用于解析作用域服务的新 AsyncServiceScope。
CreateScope(IServiceProvider)	创建可用于解析作用域服务的新 IServiceScope。
GetRequiredService(IServiceProvider, Type)	从 IServiceProvider获取类型 serviceType 的服务。
GetRequiredService<T>(IServiceProvider)	从 IServiceProvider获取类型 T 的服务。
GetService<T>(IServiceProvider)	从 IServiceProvider获取类型 T 的服务。
GetServices(IServiceProvider, Type)	从 IServiceProvider获取类型为 serviceType 的服务的枚举。
GetServices<T>(IServiceProvider)	从 IServiceProvider获取类型为 T 的服务的枚举。
GetFakeLogCollector(IServiceProvider)	获取收集发送到假记录器的日志记录的对象。
GetFakeRedactionCollector(IServiceProvider)	从依赖项注入容器获取虚假的重函数收集器实例。
Cast<TResult>(IEnumerable)	将 IEnumerable 的元素强制转换为指定类型。
OfType<TResult>(IEnumerable)	根据指定类型筛选 IEnumerable 的元素。
AsParallel(IEnumerable)	启用查询的并行化。
AsQueryable(IEnumerable)	将 IEnumerable 转换为 IQueryable。

线程安全性

此类型对于多线程读取操作是安全的。 必须同步任何写入操作。

另请参阅

• DataSet
• DataTable
• DataViewManager
• AsDataView
• 数据集、DataTables 和 DataViews （ADO.NET）