Gestione di DataView (ADO.NET)

È possibile utilizzare un tipo DataViewManager per gestire le impostazioni di visualizzazione per tutte le tabelle di un tipo DataView. Per associare un controllo a più tabelle, ad esempio una griglia per la navigazione tra le relazioni, DataViewManager rappresenta la soluzione ideale.

DataViewManager presenta una raccolta di oggetti DataViewSetting utilizzati per definire le impostazioni di visualizzazione delle tabelle nel tipo DataSet. Il tipo DataViewSettingCollection contiene un oggetto DataViewSetting per ogni tabella di un DataSet. È possibile impostare le proprietà predefinite ApplyDefaultSort, Sort, RowFilter e RowStateFilter della tabella di riferimento utilizzando DataViewSetting. È possibile fare riferimento a DataViewSetting per una particolare tabella mediante il nome o il riferimento ordinale, oppure passando un riferimento all'oggetto tabella specifico. È possibile accedere alla raccolta di oggetti DataViewSetting in DataViewManager utilizzando la proprietà DataViewSettings.

Nell'esempio di codice seguente un DataSet viene compilato con le tabelle Customers, Orders e Order Details del database Northwind di SQL Server, vengono create le relazioni tra le tabelle, viene utilizzato DataViewManager per definire le impostazioni predefinite di DataView e un controllo DataGrid viene associato a DataViewManager. Nell'esempio seguente vengono specificate le impostazioni predefinite di DataView per tutte le tabelle nel DataSet affinché l'ordinamento sia basato sulla chiave primaria della tabella (ApplyDefaultSort = true) e viene quindi modificato l'ordinamento della tabella Customers affinché venga basato su CompanyName.

' Assumes connection is a valid SqlConnection to Northwind.
' Create a Connection, DataAdapters, and a DataSet.
Dim custDA As SqlDataAdapter = New SqlDataAdapter( _
  "SELECT CustomerID, CompanyName FROM Customers", connection)
Dim orderDA As SqlDataAdapter = New SqlDataAdapter( _
  "SELECT OrderID, CustomerID FROM Orders", connection)
Dim ordDetDA As SqlDataAdapter = New SqlDataAdapter( _
  "SELECT OrderID, ProductID, Quantity FROM [Order Details]", connection)

Dim custDS As DataSet = New DataSet()

' Open the Connection.
connection.Open()

    ' Fill the DataSet with schema information and data.
    custDA.MissingSchemaAction = MissingSchemaAction.AddWithKey
    orderDA.MissingSchemaAction = MissingSchemaAction.AddWithKey
    ordDetDA.MissingSchemaAction = MissingSchemaAction.AddWithKey

    custDA.Fill(custDS, "Customers")
    orderDA.Fill(custDS, "Orders")
    ordDetDA.Fill(custDS, "OrderDetails")

    ' Close the Connection.
    connection.Close()

    ' Create relationships.
    custDS.Relations.Add("CustomerOrders", _
          custDS.Tables("Customers").Columns("CustomerID"), _
          custDS.Tables("Orders").Columns("CustomerID"))

    custDS.Relations.Add("OrderDetails", _
          custDS.Tables("Orders").Columns("OrderID"), _
          custDS.Tables("OrderDetails").Columns("OrderID"))

' Create default DataView settings.
Dim viewManager As DataViewManager = New DataViewManager(custDS)

Dim viewSetting As DataViewSetting
For Each viewSetting In viewManager.DataViewSettings
  viewSetting.ApplyDefaultSort = True
Next

viewManager.DataViewSettings("Customers").Sort = "CompanyName"

' Bind to a DataGrid.
Dim grid As System.Windows.Forms.DataGrid = New System.Windows.Forms.DataGrid()
grid.SetDataBinding(viewManager, "Customers")

// Assumes connection is a valid SqlConnection to Northwind.
// Create a Connection, DataAdapters, and a DataSet.
SqlDataAdapter custDA = new SqlDataAdapter(
  "SELECT CustomerID, CompanyName FROM Customers", connection);
SqlDataAdapter orderDA = new SqlDataAdapter(
  "SELECT OrderID, CustomerID FROM Orders", connection);
SqlDataAdapter ordDetDA = new SqlDataAdapter(
  "SELECT OrderID, ProductID, Quantity FROM [Order Details]", connection);

DataSet custDS = new DataSet();

// Open the Connection.
connection.Open();

    // Fill the DataSet with schema information and data.
    custDA.MissingSchemaAction = MissingSchemaAction.AddWithKey;
    orderDA.MissingSchemaAction = MissingSchemaAction.AddWithKey;
    ordDetDA.MissingSchemaAction = MissingSchemaAction.AddWithKey;

    custDA.Fill(custDS, "Customers");
    orderDA.Fill(custDS, "Orders");
    ordDetDA.Fill(custDS, "OrderDetails");

    // Close the Connection.
    connection.Close();

    // Create relationships.
    custDS.Relations.Add("CustomerOrders",
          custDS.Tables["Customers"].Columns["CustomerID"],
          custDS.Tables["Orders"].Columns["CustomerID"]);

    custDS.Relations.Add("OrderDetails",
          custDS.Tables["Orders"].Columns["OrderID"],
          custDS.Tables["OrderDetails"].Columns["OrderID"]);

// Create default DataView settings.
DataViewManager viewManager = new DataViewManager(custDS);

foreach (DataViewSetting viewSetting in viewManager.DataViewSettings)
  viewSetting.ApplyDefaultSort = true;

viewManager.DataViewSettings["Customers"].Sort = "CompanyName";

// Bind to a DataGrid.
System.Windows.Forms.DataGrid grid = new System.Windows.Forms.DataGrid();
grid.SetDataBinding(viewManager, "Customers");

Vedere anche

Riferimenti

DataSet

DataViewManager

DataViewSetting

DataViewSettingCollection

Altre risorse

DataView (ADO.NET)