DataGridTableStyle Classe

Definizione

public ref class DataGridTableStyle : System::ComponentModel::Component, System::Windows::Forms::IDataGridEditingService

public class DataGridTableStyle : System.ComponentModel.Component, System.Windows.Forms.IDataGridEditingService

type DataGridTableStyle = class
    inherit Component
    interface IDataGridEditingService

Public Class DataGridTableStyle
Inherits Component
Implements IDataGridEditingService

Ereditarietà

Object

MarshalByRefObject

Component

DataGridTableStyle

Implementazioni

IDataGridEditingService

Esempio

Nell'esempio di codice seguente vengono create due DataGridTableStyle istanze e viene impostato l'oggetto MappingNameTableName su un DataTable oggetto in un DataSetoggetto . L'esempio aggiunge DataGridColumnStyle quindi oggetti all'oggetto GridColumnStylesCollection di ogni DataGridTableStyleoggetto . Per un esempio eseguito, vedere l'esempio System.Windows.Forms.DataGrid .

void AddCustomDataTableStyle()
{
   
   /* Create a new DataGridTableStyle and set
         its MappingName to the TableName of a DataTable. */
   DataGridTableStyle^ ts1 = gcnew DataGridTableStyle;
   ts1->MappingName = "Customers";
   
   /* Add a GridColumnStyle and set its MappingName 
         to the name of a DataColumn in the DataTable. 
         Set the HeaderText and Width properties. */
   DataGridColumnStyle^ boolCol = gcnew DataGridBoolColumn;
   boolCol->MappingName = "Current";
   boolCol->HeaderText = "IsCurrent Customer";
   boolCol->Width = 150;
   ts1->GridColumnStyles->Add( boolCol );
   
   // Add a second column style.
   DataGridColumnStyle^ TextCol = gcnew DataGridTextBoxColumn;
   TextCol->MappingName = "custName";
   TextCol->HeaderText = "Customer Name";
   TextCol->Width = 250;
   ts1->GridColumnStyles->Add( TextCol );
   
   // Create the second table style with columns.
   DataGridTableStyle^ ts2 = gcnew DataGridTableStyle;
   ts2->MappingName = "Orders";
   
   // Change the colors.
   ts2->ForeColor = Color::Yellow;
   ts2->AlternatingBackColor = Color::Blue;
   ts2->BackColor = Color::Blue;
   
   // Create new DataGridColumnStyle objects.
   DataGridColumnStyle^ cOrderDate = gcnew DataGridTextBoxColumn;
   cOrderDate->MappingName = "OrderDate";
   cOrderDate->HeaderText = "Order Date";
   cOrderDate->Width = 100;
   ts2->GridColumnStyles->Add( cOrderDate );
   PropertyDescriptorCollection^ pcol = this->BindingContext[ myDataSet,"Customers.custToOrders" ]->GetItemProperties();
   DataGridColumnStyle^ csOrderAmount = gcnew DataGridTextBoxColumn( pcol[ "OrderAmount" ],"c",true );
   csOrderAmount->MappingName = "OrderAmount";
   csOrderAmount->HeaderText = "Total";
   csOrderAmount->Width = 100;
   ts2->GridColumnStyles->Add( csOrderAmount );
   
   // Add the DataGridTableStyle objects to the collection.
   myDataGrid->TableStyles->Add( ts1 );
   myDataGrid->TableStyles->Add( ts2 );
}

private void AddCustomDataTableStyle()
   {
      /* Create a new DataGridTableStyle and set
      its MappingName to the TableName of a DataTable. */
      DataGridTableStyle ts1 = new DataGridTableStyle();
      ts1.MappingName = "Customers";

      /* Add a GridColumnStyle and set its MappingName 
      to the name of a DataColumn in the DataTable. 
      Set the HeaderText and Width properties. */
      
      DataGridColumnStyle boolCol = new DataGridBoolColumn();
      boolCol.MappingName = "Current";
      boolCol.HeaderText = "IsCurrent Customer";
      boolCol.Width = 150;
      ts1.GridColumnStyles.Add(boolCol);
      
      // Add a second column style.
      DataGridColumnStyle TextCol = new DataGridTextBoxColumn();
      TextCol.MappingName = "custName";
      TextCol.HeaderText = "Customer Name";
      TextCol.Width = 250;
      ts1.GridColumnStyles.Add(TextCol);

      // Create the second table style with columns.
      DataGridTableStyle ts2 = new DataGridTableStyle();
      ts2.MappingName = "Orders";
      // Change the colors.
      ts2.ForeColor = Color.Yellow;
      ts2.AlternatingBackColor = Color.Blue;
      ts2.BackColor = Color.Blue;
      
      // Create new DataGridColumnStyle objects.
      DataGridColumnStyle cOrderDate = 
      new DataGridTextBoxColumn();
      cOrderDate.MappingName = "OrderDate";
      cOrderDate.HeaderText = "Order Date";
      cOrderDate.Width = 100;
      ts2.GridColumnStyles.Add(cOrderDate);

      PropertyDescriptorCollection pcol = this.BindingContext
      [myDataSet, "Customers.custToOrders"].GetItemProperties();
      
      DataGridColumnStyle csOrderAmount = 
      new DataGridTextBoxColumn(pcol["OrderAmount"], "c", true);
      csOrderAmount.MappingName = "OrderAmount";
      csOrderAmount.HeaderText = "Total";
      csOrderAmount.Width = 100;
      ts2.GridColumnStyles.Add(csOrderAmount);

      // Add the DataGridTableStyle objects to the collection.
      myDataGrid.TableStyles.Add(ts1);
      myDataGrid.TableStyles.Add(ts2);
   }

Private Sub AddCustomDataTableStyle()
    ' Create a new DataGridTableStyle and set
    ' its MappingName to the TableName of a DataTable. 
    Dim ts1 As New DataGridTableStyle()
    ts1.MappingName = "Customers"
    
    ' Add a GridColumnStyle and set its MappingName
    ' to the name of a DataColumn in the DataTable.
    ' Set the HeaderText and Width properties. 
    
    Dim boolCol As New DataGridBoolColumn()
    boolCol.MappingName = "Current"
    boolCol.HeaderText = "IsCurrent Customer"
    boolCol.Width = 150
    ts1.GridColumnStyles.Add(boolCol)
    
    ' Add a second column style.
    Dim TextCol As New DataGridTextBoxColumn()
    TextCol.MappingName = "custName"
    TextCol.HeaderText = "Customer Name"
    TextCol.Width = 250
    ts1.GridColumnStyles.Add(TextCol)

    ' Create the second table style with columns.
    Dim ts2 As New DataGridTableStyle()
    ts2.MappingName = "Orders"

    ' Change the colors.
    ts2.ForeColor = Color.Yellow
    ts2.AlternatingBackColor = Color.Blue
    ts2.BackColor = Color.Blue
    
    ' Create new DataGridColumnStyle objects.
    Dim cOrderDate As New DataGridTextBoxColumn()
    cOrderDate.MappingName = "OrderDate"
    cOrderDate.HeaderText = "Order Date"
    cOrderDate.Width = 100
    ts2.GridColumnStyles.Add(cOrderDate)
    
    Dim pcol As PropertyDescriptorCollection = Me.BindingContext(myDataSet, "Customers.custToOrders").GetItemProperties()
    
    Dim csOrderAmount As New DataGridTextBoxColumn(pcol("OrderAmount"), "c", True)
    csOrderAmount.MappingName = "OrderAmount"
    csOrderAmount.HeaderText = "Total"
    csOrderAmount.Width = 100
    ts2.GridColumnStyles.Add(csOrderAmount)

    ' Add the DataGridTableStyle objects to the collection.
    myDataGrid.TableStyles.Add(ts1)
    myDataGrid.TableStyles.Add(ts2)
End Sub

Commenti

Il System.Windows.Forms.DataGrid controllo visualizza i dati sotto forma di griglia. È DataGridTableStyle una classe che rappresenta solo la griglia disegnata. Questa griglia non deve essere confusa con la DataTable classe, che è una possibile origine di dati per la griglia. Invece, la DataGridTableStyle griglia rappresenta rigorosamente la griglia come è dipinta nel controllo. Pertanto, attraverso l'oggetto DataGridTableStyle è possibile controllare l'aspetto della griglia per ogni DataTableoggetto . Per specificare quale DataGridTableStyle viene usato durante la visualizzazione di dati da un determinato DataTable, impostare su MappingName su TableName di un DataTableoggetto .

L'oggetto GridTableStylesCollection recuperato tramite la TableStyles proprietà contiene tutti gli DataGridTableStyle oggetti usati da un System.Windows.Forms.DataGrid controllo. L'insieme può contenere tutti DataGridTableStyle gli oggetti necessari, ma è MappingName necessario che ogni insieme sia univoco. In fase di esecuzione, ciò consente di sostituire un oggetto diverso DataGridTableStyle per gli stessi dati, a seconda della preferenza dell'utente. Per eseguire questa operazione:

1. Popolare l'oggetto GridTableStylesCollection con DataGridTableStyle oggetti. Se esiste un DataGridTableStyle oggetto nel GridTableStylesCollection cui MappingName valore della proprietà è uguale alla DataTable proprietà dell'oggetto TableName , viene DataTable visualizzato con questo DataGridTableStyleoggetto . Se non DataGridTableStyle esiste con una corrispondenza MappingName, viene DataTable visualizzato con lo stile predefinito per le tabelle della griglia di dati.

2. Quando è necessario uno stile di griglia diverso, utilizzare la Item proprietà per selezionare l'oggetto appropriato DataGridTableStyle (passare alla TableNameItem[] proprietà) e impostare l'oggetto MappingName restituito su un nuovo valore.

3. Utilizzare la Item[] proprietà per selezionare l'oggetto desiderato DataGridTableStylee impostarne MappingName l'oggetto su TableName .DataTable

Per determinare quale DataGridTableStyle è attualmente visualizzato, usare le DataSource proprietà e DataMember dell'oggetto System.Windows.Forms.DataGrid per restituire un CurrencyManageroggetto . Se l'origine dati implementa l'interfaccia, è possibile usare il ITypedListGetListName metodo per restituire l'oggetto MappingName della tabella corrente. Questo codice è illustrato nel codice C# seguente:

private void PrintCurrentListName(DataGrid myDataGrid){  
 CurrencyManager myCM = (CurrencyManager)  
 BindingContext[myDataGrid.DataSource, myDataGrid.DataMember];  
 IList myList = myCM.List;  
 ITypedList thisList = (ITypedList) myList;  
 Console.WriteLine(thisList.GetListName(null));  
}  

Se l'oggetto DataSet contiene DataTable oggetti correlati tramite DataRelation oggetti e la tabella attualmente visualizzata DataTable è una tabella figlio, verrà DataMember restituita una stringa sotto forma di TableName.RelationName (nel caso più semplice). Se l'oggetto DataTable è più in basso nella gerarchia, la stringa consisterà nel nome della tabella padre seguita dai valori necessari RelationName per raggiungere il livello della tabella. Si supponga ad esempio che tre DataTable oggetti in una relazione gerarchica denominata (superiore alla parte inferiore) Regions, Customerse e due DataRelation oggetti denominati RegionsToCustomersCustomersToOrderse Orders, la DataMember proprietà restituirà "Regions.RegionsToCustomers.CustomersToOrders". Tuttavia, l'oggetto MappingName sarà "Ordini".

La raccolta di DataGridTableStyle oggetti viene restituita tramite la TableStyles proprietà di System.Windows.Forms.DataGrid.

Quando viene visualizzato un DataGridTableStyle oggetto, le impostazioni per l'oggetto eseguiranno l'override DataGridTableStyle delle impostazioni per il System.Windows.Forms.DataGrid controllo. Se un valore non è impostato per una DataGridTableStyle determinata proprietà, verrà invece usato il System.Windows.Forms.DataGrid valore del controllo. L'elenco seguente mostra le proprietà che possono essere impostate per eseguire l'override System.Windows.Forms.DataGrid delle DataGridColumnStyle proprietà del controllo:

• AllowSorting

• AlternatingBackColor

• BackColor

• ColumnHeadersVisible

• ForeColor

• GridLineColor

• GridLineStyle

• HeaderBackColor

• HeaderFont

• HeaderForeColor

• LinkColor

• PreferredColumnWidth

• PreferredRowHeight

• ReadOnly

• RowHeadersVisible

• RowHeaderWidth

• SelectionBackColor

• SelectionForeColor

Per associare l'oggetto DataGrid a una matrice fortemente tipizzata di oggetti, il tipo di oggetto deve contenere proprietà pubbliche. Per creare un oggetto DataGridTableStyle che visualizza la matrice, impostare la DataGridTableStyle.MappingName proprietà su dove typenametypename viene sostituito dal nome del tipo di oggetto. Si noti anche che la proprietà è distinzione tra maiuscole e minuscole. Il MappingName nome del tipo deve essere corrispondente esattamente. Vedere la MappingName proprietà per un esempio.

È anche possibile associare l'oggetto DataGrid a un ArrayListoggetto . Una funzionalità di ArrayList è che può contenere oggetti di più tipi, ma può DataGrid essere associato solo a tale elenco quando tutti gli elementi dell'elenco sono dello stesso tipo del primo elemento. Ciò significa che tutti gli oggetti devono essere dello stesso tipo oppure devono ereditare dalla stessa classe del primo elemento dell'elenco. Ad esempio, se il primo elemento di un elenco è un , il secondo elemento potrebbe essere un ControlTextBox oggetto (che eredita da Control). Se, invece, il primo elemento è un TextBoxoggetto , il secondo oggetto non può essere un Controloggetto . Inoltre, l'oggetto ArrayList deve avere elementi in esso associati e gli oggetti presenti nell'oggetto DataGridTableStyle devono contenere proprietà pubbliche. Un vuoto ArrayList genera una griglia vuota. Quando si associa a un ArrayListoggetto , impostare l'oggetto MappingNameDataGridTableStyle su "ArrayList" (nome del tipo).

Costruttori

Campi

Proprietà

Metodi

Eventi

Si applica a

Vedi anche

• DataGrid
• DataGridColumnStyle
• GridColumnStylesCollection
• GridTableStylesCollection