Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Classe DataView

 

Data di pubblicazione: ottobre 2016

Rappresenta una visualizzazione personalizzata e disponibile per il data binding di un oggetto DataTable per l'ordinamento, il filtraggio, la ricerca, la modifica e l'esplorazione. L'oggetto DataView non memorizza dati ma rappresenta una visualizzazione connessa dell'oggetto DataTable corrispondente. Le modifiche ai dati dell'oggetto DataView influiscono sull'oggetto DataTable. Le modifiche ai dati dell'oggetto DataTable influiscono su tutti gli oggetti DataView associati ad esso.

Spazio dei nomi:   System.Data
Assembly:  System.Data (in System.Data.dll)


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

NomeDescrizione
System_CAPS_pubmethodDataView()

Inizializza una nuova istanza della classe DataView.

System_CAPS_pubmethodDataView(DataTable)

Inizializza una nuova istanza della classe DataView con l'oggetto DataTable specificato.

System_CAPS_pubmethodDataView(DataTable, String, String, DataViewRowState)

Inizializza una nuova istanza della classe DataView con gli oggetti DataTable, RowFilter, Sort e DataViewRowState specificati.

NomeDescrizione
System_CAPS_pubpropertyAllowDelete

Ottiene o imposta un valore che indica se sono consentite le eliminazioni.

System_CAPS_pubpropertyAllowEdit

Ottiene o imposta un valore che indica se sono consentite le modifiche.

System_CAPS_pubpropertyAllowNew

Ottiene o imposta un valore che indica se le nuove righe possono essere aggiunte con il metodo AddNew.

System_CAPS_pubpropertyApplyDefaultSort

Ottiene o imposta un valore che indica se usare l'ordinamento predefinito. L'ordinamento predefinito è (ascendente) in base a tutte le chiavi primarie come specificato da PrimaryKey.

System_CAPS_pubpropertyContainer

Ottiene il contenitore per il componente.(Ereditato da MarshalByValueComponent.)

System_CAPS_pubpropertyCount

Ottiene il numero di record nell'oggetto DataView dopo l'applicazione di RowFilter e RowStateFilter.

System_CAPS_pubpropertyDataViewManager

Ottiene l'oggetto DataViewManager associato a questa visualizzazione.

System_CAPS_pubpropertyDesignMode

Ottiene un valore che indica se il componente è attualmente in modalità progettazione.(Ereditato da MarshalByValueComponent.)

System_CAPS_protpropertyEvents

Ottiene l'elenco di gestori eventi associati a questo componente.(Ereditato da MarshalByValueComponent.)

System_CAPS_pubpropertyIsInitialized

Ottiene un valore che indica se il componente è stato inizializzato.

System_CAPS_protpropertyIsOpen

Ottiene un valore che indica se l'origine dati è attualmente aperta e proietta visualizzazioni dei dati in DataTable.

System_CAPS_pubpropertyItem[Int32]

Ottiene una riga di dati da una tabella specificata.

System_CAPS_pubpropertyRowFilter

Ottiene o imposta l'espressione usata per filtrare le righe da visualizzare nell'oggetto DataView.

System_CAPS_pubpropertyRowStateFilter

Ottiene o imposta il filtro di stato della riga usato nell'oggetto DataView.

System_CAPS_pubpropertySite

Ottiene o imposta il sito del componente.(Ereditato da MarshalByValueComponent.)

System_CAPS_pubpropertySort

Ottiene o imposta la colonna o le colonne e l'ordinamento per l'oggetto DataView.

System_CAPS_pubpropertyTable

Ottiene o imposta l'origine DataTable.

NomeDescrizione
System_CAPS_pubmethodAddNew()

Aggiunge una nuova riga all'oggetto DataView.

System_CAPS_pubmethodBeginInit()

Avvia l'inizializzazione di un oggetto DataView usato su un form o da un altro componente. L'inizializzazione avviene in fase di esecuzione.

System_CAPS_protmethodClose()

Chiude l'oggetto DataView.

System_CAPS_protmethodColumnCollectionChanged(Object, CollectionChangeEventArgs)

Si verifica dopo la modifica di un oggetto DataColumnCollection.

System_CAPS_pubmethodCopyTo(Array, Int32)

Copia gli elementi in una matrice. Solo per le interfacce di Web Form.

System_CAPS_pubmethodDelete(Int32)

Elimina una riga in corrispondenza dell'indice specificato.

System_CAPS_pubmethodDispose()

Rilascia tutte le risorse usate da MarshalByValueComponent.(Ereditato da MarshalByValueComponent.)

System_CAPS_protmethodDispose(Boolean)

Elimina le risorse usate dall'oggetto DataView, tranne la memoria.(Esegue l'override di MarshalByValueComponent.Dispose(Boolean).)

System_CAPS_pubmethodEndInit()

Termina l'inizializzazione di una classe DataView usata su un form o da un altro componente. L'inizializzazione avviene in fase di esecuzione.

System_CAPS_pubmethodEquals(DataView)

Determina se le istanze di DataView specificate sono considerate uguali.

System_CAPS_pubmethodEquals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.(Ereditato da Object.)

System_CAPS_protmethodFinalize()

Consente a un oggetto di effettuare un tentativo di liberare risorse ed eseguire altre operazioni di pulizia prima che venga recuperato da Garbage Collection.(Ereditato da MarshalByValueComponent.)

System_CAPS_pubmethodFind(Object)

Trova una riga in DataView in base al valore di chiave di ordinamento specificato.

System_CAPS_pubmethodFind(Object[])

Trova una riga nell'oggetto DataView in base ai valori delle chiavi di ordinamento specificati.

System_CAPS_pubmethodFindRows(Object)

Restituisce una matrice di oggetti DataRowView le cui colonne corrispondono al valore della chiave di ordinamento specificato.

System_CAPS_pubmethodFindRows(Object[])

Restituisce una matrice di oggetti DataRowView le cui colonne corrispondono al valore della chiave di ordinamento specificato.

System_CAPS_pubmethodGetEnumerator()

Ottiene un enumeratore per questo oggetto DataView.

System_CAPS_pubmethodGetHashCode()

Funge da funzione hash predefinita.(Ereditato da Object.)

System_CAPS_pubmethodGetService(Type)

Ottiene l'implementatore di IServiceProvider.(Ereditato da MarshalByValueComponent.)

System_CAPS_pubmethodGetType()

Ottiene l'oggetto Type dell'istanza corrente.(Ereditato da Object.)

System_CAPS_protmethodIndexListChanged(Object, ListChangedEventArgs)

Si verifica dopo la modifica di un oggetto DataView.

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.(Ereditato da Object.)

System_CAPS_protmethodOnListChanged(ListChangedEventArgs)

Genera l'evento ListChanged.

System_CAPS_protmethodOpen()

Apre un oggetto DataView.

System_CAPS_protmethodReset()

Riservato esclusivamente per uso interno.

System_CAPS_pubmethodToString()

Restituisce un String contenente il nome del Component, se presente. Questo metodo non deve essere sottoposto a override.(Ereditato da MarshalByValueComponent.)

System_CAPS_pubmethodToTable()

Crea e restituisce un nuovo oggetto DataTable in base alle righe in un oggetto DataView esistente.

System_CAPS_pubmethodToTable(Boolean, String[])

Crea e restituisce un nuovo oggetto DataTable in base alle righe in un oggetto DataView esistente.

System_CAPS_pubmethodToTable(String)

Crea e restituisce un nuovo oggetto DataTable in base alle righe in un oggetto DataView esistente.

System_CAPS_pubmethodToTable(String, Boolean, String[])

Crea e restituisce un nuovo oggetto DataTable in base alle righe in un oggetto DataView esistente.

System_CAPS_protmethodUpdateIndex()

Riservato esclusivamente per uso interno.

System_CAPS_protmethodUpdateIndex(Boolean)

Riservato esclusivamente per uso interno.

NomeDescrizione
System_CAPS_pubeventDisposed

Aggiunge un gestore eventi per restare in attesa di Disposed eventi del componente.(Ereditato da MarshalByValueComponent.)

System_CAPS_pubeventInitialized

Si verifica quando l'inizializzazione dell'oggetto DataView viene completata.

System_CAPS_pubeventListChanged

Si verifica quando l'elenco gestito dall'oggetto DataView cambia.

NomeDescrizione
System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Add(Object)

Per una descrizione di questo membro, vedere IList.Add.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Clear()

Per una descrizione di questo membro, vedere IList.Clear.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Contains(Object)

Per una descrizione di questo membro, vedere IList.Contains.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.IndexOf(Object)

Per una descrizione di questo membro, vedere IList.IndexOf.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Insert(Int32, Object)

Per una descrizione di questo membro, vedere IList.Insert.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Remove(Object)

Per una descrizione di questo membro, vedere IList.Remove.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.RemoveAt(Int32)

Per una descrizione di questo membro, vedere IList.RemoveAt.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIBindingList.AddIndex(PropertyDescriptor)

Per una descrizione di questo membro, vedere IBindingList.AddIndex.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIBindingList.AddNew()

Per una descrizione di questo membro, vedere IBindingList.AddNew.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIBindingList.ApplySort(PropertyDescriptor, ListSortDirection)

Per una descrizione di questo membro, vedere IBindingList.ApplySort.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIBindingList.Find(PropertyDescriptor, Object)

Per una descrizione di questo membro, vedere IBindingList.Find.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIBindingList.RemoveIndex(PropertyDescriptor)

Per una descrizione di questo membro, vedere IBindingList.RemoveIndex.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIBindingList.RemoveSort()

Per una descrizione di questo membro, vedere IBindingList.RemoveSort.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIBindingListView.ApplySort(ListSortDescriptionCollection)

Per una descrizione di questo membro, vedere IBindingListView.ApplySort.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIBindingListView.RemoveFilter()

Per una descrizione di questo membro, vedere IBindingListView.RemoveFilter.

System_CAPS_pubinterfaceSystem_CAPS_privmethodITypedList.GetItemProperties(PropertyDescriptor[])

Per una descrizione di questo membro, vedere ITypedList.GetItemProperties.

System_CAPS_pubinterfaceSystem_CAPS_privmethodITypedList.GetListName(PropertyDescriptor[])

Per una descrizione di questo membro, vedere ITypedList.GetListName.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection.IsSynchronized

Per una descrizione di questo membro, vedere ICollection.IsSynchronized.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection.SyncRoot

Per una descrizione di questo membro, vedere ICollection.SyncRoot.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList.IsFixedSize

Per una descrizione di questo membro, vedere IList.IsFixedSize.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList.IsReadOnly

Per una descrizione di questo membro, vedere IList.IsReadOnly.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList.Item[Int32]

Per una descrizione di questo membro, vedere IList.Item.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingList.AllowEdit

Per una descrizione di questo membro, vedere IBindingList.AllowEdit.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingList.AllowNew

Per una descrizione di questo membro, vedere IBindingList.AllowNew.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingList.AllowRemove

Per una descrizione di questo membro, vedere IBindingList.AllowRemove.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingList.IsSorted

Per una descrizione di questo membro, vedere IBindingList.IsSorted.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingList.SortDirection

Per una descrizione di questo membro, vedere IBindingList.SortDirection.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingList.SortProperty

Per una descrizione di questo membro, vedere IBindingList.SortProperty.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingList.SupportsChangeNotification

Per una descrizione di questo membro, vedere IBindingList.SupportsChangeNotification.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingList.SupportsSearching

Per una descrizione di questo membro, vedere IBindingList.SupportsSearching.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingList.SupportsSorting

Per una descrizione di questo membro, vedere IBindingList.SupportsSorting.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingListView.Filter

Per una descrizione di questo membro, vedere IBindingListView.Filter.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingListView.SortDescriptions

Per una descrizione di questo membro, vedere IBindingListView.SortDescriptions.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingListView.SupportsAdvancedSorting

Per una descrizione di questo membro, vedere IBindingListView.SupportsAdvancedSorting.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingListView.SupportsFiltering

Per una descrizione di questo membro, vedere IBindingListView.SupportsFiltering.

NomeDescrizione
System_CAPS_pubmethodAsParallel()

Sottoposto a overload. Consente la parallelizzazione di una query.(Definito da ParallelEnumerable.)

System_CAPS_pubmethodAsQueryable()

Sottoposto a overload. Converte un IEnumerable a un IQueryable.(Definito da Queryable.)

System_CAPS_pubmethodCast<TResult>()

Esegue il cast di elementi di un IEnumerable nel tipo specificato.(Definito da Enumerable.)

System_CAPS_pubmethodOfType<TResult>()

Filtra gli elementi di un IEnumerable in base a un tipo specificato.(Definito da 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 Associazione dati e 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
Disponibile da 1.1

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

Torna all'inizio
Mostra: