DataView Класс

Определение

Пространство имен:

System.Data

Сборка:

System.Data.Common.dll

Исходный код:

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

В следующем примере создается DataView онлайн-заказов, упорядоченных по общему объему из запроса 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

Комментарии

Основная функция DataView заключается в том, чтобы обеспечить привязку данных как в Windows Forms, так и в Web Forms.

Кроме того, можно настроить DataView, чтобы представить подмножество данных из DataTable. Эта возможность позволяет иметь два элемента управления, привязанные к одной и той же DataTable, но которые показывают разные версии данных. Например, один элемент управления может быть привязан к DataView, в котором отображаются все строки таблицы, а вторая может быть настроена для отображения только строк, удаленных из DataTable. DataTable также имеет свойство DefaultView. Возвращается DataView по умолчанию для таблицы. Например, если вы хотите создать пользовательское представление в таблице, задайте RowFilter на DataView, возвращаемой DefaultView.

Чтобы создать отфильтрованное и отсортированный представление данных, задайте свойства RowFilter и Sort. Затем используйте свойство Item[] для возврата одного DataRowView.

Вы также можете добавить и удалить из набора строк с помощью методов AddNew и Delete. При использовании этих методов свойство RowStateFilter может задать, чтобы указать, что DataViewбудут отображаться только удаленные строки или новые строки.

Заметка

Если явно не указывать критерии сортировки для DataView, то объекты DataRowView в DataView сортируются на основе индекса соответствующих DataRow DataView в DataTable.RowsDataRowCollection.

LINQ to DataSet позволяет разработчикам создавать сложные, мощные запросы по DataSet с помощью LINQ. Запрос LINQ to DataSet возвращает перечисление объектов DataRow, однако это не легко используется в сценарии привязки. DataView можно создать из запроса LINQ to DataSet и принять характеристики фильтрации и сортировки этого запроса. LINQ to DataSet расширяет функциональные возможности DataView путем фильтрации и сортировки на основе выражений LINQ, что позволяет выполнять гораздо более сложные и мощные операции фильтрации и сортировки, чем фильтрация на основе строк. Дополнительные сведения см. в привязке данных и LINQ to DataSet.

Конструкторы

DataView()	Инициализирует новый экземпляр класса DataView.
DataView(DataTable)	Инициализирует новый экземпляр класса DataView с указанным DataTable.
DataView(DataTable, String, String, DataViewRowState)	Инициализирует новый экземпляр класса DataView с указанным DataTable, RowFilter, Sortи DataViewRowState.

Свойства

AllowDelete	Возвращает или задает значение, указывающее, разрешены ли удаления.
AllowEdit	Возвращает или задает значение, указывающее, разрешены ли изменения.
AllowNew	Возвращает или задает значение, указывающее, можно ли добавлять новые строки с помощью метода AddNew().
ApplyDefaultSort	Возвращает или задает значение, указывающее, следует ли использовать сортировку по умолчанию. Сортировка по умолчанию (возрастает) по всем первичным ключам, как указано в PrimaryKey.
Container	Возвращает контейнер для компонента. (Унаследовано от MarshalByValueComponent)
Count	Возвращает количество записей в DataView после применения RowFilter и RowStateFilter.
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)	Копирует элементы в массив. Только для интерфейсов веб-форм.
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()	Создает и возвращает новую DataTable на основе строк в существующей DataView.
ToTable(Boolean, String[])	Создает и возвращает новую DataTable на основе строк в существующей DataView.
ToTable(String)	Создает и возвращает новую DataTable на основе строк в существующей DataView.
ToTable(String, Boolean, String[])	Создает и возвращает новую DataTable на основе строк в существующей DataView.
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)	Возвращает службу типа T из IServiceProvider.
GetKeyedServices(IServiceProvider, Type, Object)	Возвращает перечисление служб типа serviceType из IServiceProvider.
GetKeyedServices<T>(IServiceProvider, Object)	Возвращает перечисление служб типа T из IServiceProvider.
GetRequiredKeyedService(IServiceProvider, Type, Object)	Возвращает службу типа serviceType из IServiceProvider.
GetRequiredKeyedService<T>(IServiceProvider, Object)	Возвращает службу типа T из IServiceProvider.
CreateAsyncScope(IServiceProvider)	Создает новый AsyncServiceScope, который можно использовать для разрешения служб с областью действия.
CreateScope(IServiceProvider)	Создает новый IServiceScope, который можно использовать для разрешения служб с областью действия.
GetRequiredService(IServiceProvider, Type)	Получение службы типа serviceType из IServiceProvider.
GetRequiredService<T>(IServiceProvider)	Получение службы типа T из IServiceProvider.
GetService<T>(IServiceProvider)	Получение службы типа T из IServiceProvider.
GetServices(IServiceProvider, Type)	Получение перечисления служб типа serviceType из IServiceProvider.
GetServices<T>(IServiceProvider)	Получение перечисления служб типа T из IServiceProvider.
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)