DataGridTableStyle Classe

Definizione

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

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

[System.ComponentModel.Browsable(false)]
[System.Obsolete("`DataGrid` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `DataGridView` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public class DataGridTableStyle : System.ComponentModel.Component, System.Windows.Forms.IDataGridEditingService

type DataGridTableStyle = class
    inherit Component
    interface IDataGridEditingService

[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`DataGrid` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `DataGridView` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type DataGridTableStyle = class
    inherit Component
    interface IDataGridEditingService

Public Class DataGridTableStyle
Inherits Component
Implements IDataGridEditingService

Ereditarietà

Object

MarshalByRefObject

Component

DataGridTableStyle

Attributi

BrowsableAttribute ObsoleteAttribute

Implementazioni

IDataGridEditingService

Esempio

Nell'esempio di codice seguente vengono create due DataGridTableStyle istanze e viene impostato l'oggetto MappingName di ogni oggetto su TableName di un DataTable oggetto in un oggetto DataSet. Nell'esempio vengono quindi aggiunti DataGridColumnStyle oggetti a 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. Rappresenta invece DataGridTableStyle rigorosamente la griglia come viene dipinta nel controllo . Pertanto, tramite DataGridTableStyle è possibile controllare l'aspetto della griglia per ogni DataTableoggetto . Per specificare quale DataGridTableStyle viene utilizzato per la visualizzazione di dati da un particolare DataTableoggetto , impostare su MappingNameTableName di un oggetto DataTable.

L'oggetto GridTableStylesCollection recuperato tramite la TableStyles proprietà contiene tutti gli DataGridTableStyle oggetti utilizzati da un System.Windows.Forms.DataGrid controllo . La raccolta può contenere tutti DataGridTableStyle gli oggetti necessari, ma deve MappingName essere univoco. In fase di esecuzione, ciò consente di sostituire un valore diverso DataGridTableStyle per gli stessi dati, a seconda delle preferenze dell'utente. Per fare questo:

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

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

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

Per determinare quale DataGridTableStyle è attualmente visualizzato, utilizzare le DataSource proprietà e DataMember di System.Windows.Forms.DataGrid per restituire un oggetto CurrencyManager. Se l'origine dati implementa l'interfaccia ITypedList , è possibile utilizzare il GetListName metodo per restituire l'oggetto MappingName della tabella corrente. Questo è 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));
}

DataSet Se contiene DataTable oggetti correlati tramite DataRelation oggetti e l'oggetto attualmente visualizzato DataTable è una tabella figlio, restituirà DataMember una stringa sotto forma di TableName.RelationName (nel caso più semplice). Se è DataTable più in basso nella gerarchia, la stringa sarà costituita dal nome della tabella padre seguito dai valori necessari RelationName per raggiungere il livello della tabella. Si supponga, ad esempio, che tre DataTable oggetti in una relazione gerarchica denominata (dall'alto verso il basso) Regions, Customerse DataRelationOrdersdue oggetti denominati RegionsToCustomers e CustomersToOrders, la DataMember proprietà restituirà "Regions.RegionsToCustomers.CustomersToOrders". Tuttavia, sarà MappingName quindi "Orders".

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

Quando viene visualizzato un oggetto DataGridTableStyle , le impostazioni per l'oggetto DataGridTableStyle sostituiranno le impostazioni per il System.Windows.Forms.DataGrid controllo . Se un valore non è impostato per una determinata DataGridTableStyle proprietà, verrà invece utilizzato il System.Windows.Forms.DataGrid valore del controllo. L'elenco seguente mostra le proprietà che possono essere impostate per eseguire l'override DataGridColumnStyleSystem.Windows.Forms.DataGrid delle 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 typename dove typename viene sostituito dal nome del tipo di oggetto. Si noti anche che la MappingName proprietà fa distinzione tra maiuscole e minuscole. Il nome del tipo deve corrispondere esattamente. Per un esempio, vedere la MappingName proprietà .

È anche possibile associare l'oggetto DataGrid a un oggetto ArrayList. Una funzionalità di ArrayList è che può contenere oggetti di più tipi, ma DataGrid può 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 Control, il secondo elemento potrebbe essere un TextBox oggetto (che eredita da Control). Se, invece, il primo elemento è un TextBoxoggetto , il secondo oggetto non può essere un Controloggetto . Inoltre, ArrayList deve contenere elementi quando è associato e gli oggetti in DataGridTableStyle devono contenere proprietà pubbliche. Un valore vuoto ArrayList comporterà una griglia vuota. Quando si esegue l'associazione a un ArrayListoggetto , impostare su MappingNameDataGridTableStyle "ArrayList" (il nome del tipo).

Vedi anche

• DataGrid
• DataGridColumnStyle
• GridColumnStylesCollection
• GridTableStylesCollection