GridTableStylesCollection Classe

Definizione

Rappresenta una raccolta di oggetti DataGridTableStyle nel controllo DataGrid .

public ref class GridTableStylesCollection : System::Windows::Forms::BaseCollection, System::Collections::IList
[System.ComponentModel.ListBindable(false)]
public class GridTableStylesCollection : System.Windows.Forms.BaseCollection, System.Collections.IList
[<System.ComponentModel.ListBindable(false)>]
type GridTableStylesCollection = class
    inherit BaseCollection
    interface IList
    interface ICollection
    interface IEnumerable
Public Class GridTableStylesCollection
Inherits BaseCollection
Implements IList
Ereditarietà
GridTableStylesCollection
Attributi
Implementazioni

Esempio

L'esempio di codice seguente crea due DataGridTableStyle oggetti e aggiunge ognuno all'oggetto GridTableStylesCollectionTableStyles restituito dalla proprietà di un DataGrid controllo.

void AddCustomDataTableStyle()
{
   DataGridTableStyle^ ts1 = gcnew DataGridTableStyle;
   ts1->MappingName = "Customers";
   
   // Set other properties.
   ts1->AlternatingBackColor = Color::LightGray;
   
   /* 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";
   
   // Set other properties.
   ts2->AlternatingBackColor = Color::LightBlue;
   
   // Create new ColumnStyle objects.
   DataGridColumnStyle^ cOrderDate = gcnew DataGridTextBoxColumn;
   cOrderDate->MappingName = "OrderDate";
   cOrderDate->HeaderText = "Order Date";
   cOrderDate->Width = 100;
   ts2->GridColumnStyles->Add( cOrderDate );
   
   /*Use a PropertyDescriptor to create a formatted
     column. First get the PropertyDescriptorCollection
     for the data source and data member. */
   System::ComponentModel::PropertyDescriptorCollection^ pcol = this->
       BindingContext[myDataSet, "Customers::custToOrders"]->
       GetItemProperties();
   
   /* Create a formatted column using a PropertyDescriptor.
     The formatting character S"c" specifies a currency format. */
   DataGridColumnStyle^ csOrderAmount =
      gcnew DataGridTextBoxColumn( pcol[ "OrderAmount" ],"c",true );
   csOrderAmount->MappingName = "OrderAmount";
   csOrderAmount->HeaderText = "Total";
   csOrderAmount->Width = 100;
   ts2->GridColumnStyles->Add( csOrderAmount );
   
   /* Add the DataGridTableStyle instances to
     the GridTableStylesCollection. */
   myDataGrid->TableStyles->Add( ts1 );
   myDataGrid->TableStyles->Add( ts2 );
}
private void AddCustomDataTableStyle(){
   DataGridTableStyle ts1 = new DataGridTableStyle();
   ts1.MappingName = "Customers";
   // Set other properties.
   ts1.AlternatingBackColor = Color.LightGray;

   /* 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";

   // Set other properties.
   ts2.AlternatingBackColor = Color.LightBlue;
   
   // Create new ColumnStyle objects.
   DataGridColumnStyle cOrderDate = 
   new DataGridTextBoxColumn();
   cOrderDate.MappingName = "OrderDate";
   cOrderDate.HeaderText = "Order Date";
   cOrderDate.Width = 100;
   ts2.GridColumnStyles.Add(cOrderDate);

   /*Use a PropertyDescriptor to create a formatted
   column. First get the PropertyDescriptorCollection
   for the data source and data member. */
   System.ComponentModel.PropertyDescriptorCollection pcol = 
      this.BindingContext[myDataSet, "Customers.custToOrders"]
      .GetItemProperties();
 
   /* Create a formatted column using a PropertyDescriptor.
   The formatting character "c" specifies a currency format. */     
   DataGridColumnStyle csOrderAmount = 
   new DataGridTextBoxColumn(pcol["OrderAmount"], "c", true);
   csOrderAmount.MappingName = "OrderAmount";
   csOrderAmount.HeaderText = "Total";
   csOrderAmount.Width = 100;
   ts2.GridColumnStyles.Add(csOrderAmount);

   /* Add the DataGridTableStyle instances to 
   the GridTableStylesCollection. */
   myDataGrid.TableStyles.Add(ts1);
   myDataGrid.TableStyles.Add(ts2);
}
Private Sub AddCustomDataTableStyle()
   Dim ts1 As New DataGridTableStyle()
   ts1.MappingName = "Customers"
   ' Set other properties.
   ts1.AlternatingBackColor = Color.LightGray
   ' 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"
     
   ' Set other properties.
   ts2.AlternatingBackColor = Color.LightBlue
     
   ' Create new ColumnStyle objects.
   Dim cOrderDate As New DataGridTextBoxColumn()
   cOrderDate.MappingName = "OrderDate"
   cOrderDate.HeaderText = "Order Date"
   cOrderDate.Width = 100
   ts2.GridColumnStyles.Add(cOrderDate)

   ' Use a PropertyDescriptor to create a formatted
   ' column. First get the PropertyDescriptorCollection
   ' for the data source and data member. 
   Dim pcol As System.ComponentModel.PropertyDescriptorCollection = _
   Me.BindingContext(myDataSet, "Customers.custToOrders"). _
   GetItemProperties()

   ' Create a formatted column using a PropertyDescriptor.
   ' The formatting character "c" specifies a currency format. */     
     
   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 instances to 
   ' the GridTableStylesCollection. 
   myDataGrid.TableStyles.Add(ts1)
   myDataGrid.TableStyles.Add(ts2)
End Sub

Commenti

Contiene GridTableStylesCollectionDataGridTableStyle oggetti che consentono al DataGrid controllo di visualizzare uno stile di griglia personalizzato per ognuno DataTable in un DataSetoggetto .

DataGrid Nel controllo la TableStyles proprietà restituisce .GridTableStylesCollection

Per impostazione predefinita, l'oggetto GridTableStylesCollection non contiene DataGridTableStyle oggetti. Visualizza invece DataGrid ogni tabella usando le impostazioni predefinite per colore, larghezza e formattazione. Vengono visualizzate tutte le colonne di ogni tabella. Quando un oggetto DataGridTableStyle viene aggiunto all'insieme, usa l'oggetto DataGridMappingName per determinare quali oggetti forniscono i dati per la griglia. Ad esempio, se l'origine dati è un oggetto DataSet contenente tre DataTable oggetti, deve MappingName corrispondere a TableName uno degli oggetti. Se non MappingName corrisponde a nessuno dei TableName valori, le impostazioni predefinite verranno usate per visualizzare i dati per ogni tabella e le DataGridTableStyle impostazioni verranno ignorate.

Attenzione

Creare DataGridColumnStyle sempre oggetti e aggiungerli all'oggetto GridColumnStylesCollection prima di aggiungere DataGridTableStyle oggetti all'oggetto GridTableStylesCollection. Quando si aggiunge un valore vuoto con un valore valido DataGridTableStyleMappingName all'insieme, DataGridColumnStyle gli oggetti vengono generati automaticamente. Di conseguenza, verrà generata un'eccezione se si tenta di aggiungere nuovi DataGridColumnStyle oggetti con valori duplicati MappingName all'oggetto GridColumnStylesCollection. In alternativa, deselezionare l'uso GridColumnStylesCollection del Clear metodo .

Proprietà

Count

Ottiene il numero totale di elementi nella raccolta.

(Ereditato da BaseCollection)
IsReadOnly

Ottiene un valore che indica se la raccolta è di sola lettura.

(Ereditato da BaseCollection)
IsSynchronized

Ottiene un valore che indica se l'accesso all'interfaccia ICollection è sincronizzato.

(Ereditato da BaseCollection)
Item[Int32]

Ottiene l'oggetto DataGridTableStyle specificato dall'indice.

Item[String]

Ottiene DataGridTableStyle con il nome specificato.

List

Ottiene l'elenco sottostante.

SyncRoot

Ottiene un oggetto che può essere usato per sincronizzare l'accesso a BaseCollection.

(Ereditato da BaseCollection)

Metodi

Add(DataGridTableStyle)

Aggiunge DataGridTableStyle a questa raccolta.

AddRange(DataGridTableStyle[])

Aggiunge alla raccolta una matrice di stili di tabella.

Clear()

Cancella la raccolta.

Contains(DataGridTableStyle)

Ottiene un valore che indica se l'insieme GridTableStylesCollection contiene l'oggetto DataGridTableStyle specificato.

Contains(String)

Ottiene un valore che indica se l'insieme GridTableStylesCollection contiene l'oggetto DataGridTableStyle di cui è stato specificato il nome.

CopyTo(Array, Int32)

Copia tutti gli elementi dell'oggetto Array unidimensionale corrente nell'oggetto Array unidimensionale specificato a partire dall'indice Array di destinazione indicato.

(Ereditato da BaseCollection)
CreateObjRef(Type)

Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto.

(Ereditato da MarshalByRefObject)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetEnumerator()

Ottiene l'oggetto che consente di scorrere i membri dell'insieme.

(Ereditato da BaseCollection)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetLifetimeService()
Obsoleti.

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.

(Ereditato da MarshalByRefObject)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
InitializeLifetimeService()
Obsoleti.

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.

(Ereditato da MarshalByRefObject)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.

(Ereditato da MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)

Genera l'evento CollectionChanged.

Remove(DataGridTableStyle)

Rimuove l'oggetto DataGridTableStyle specificato.

RemoveAt(Int32)

Rimuove un oggetto DataGridTableStyle in corrispondenza dell'indice specificato.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Eventi

CollectionChanged

Si verifica in seguito alla modifica della raccolta.

Implementazioni dell'interfaccia esplicita

ICollection.CopyTo(Array, Int32)

Copia l'insieme in un oggetto Array compatibile unidimensionale, a partire dall'indice specificato della matrice di destinazione.

ICollection.Count

Ottiene il numero di elementi nella raccolta.

ICollection.IsSynchronized

Ottiene un valore che indica se l'accesso a GridTableStylesCollection è sincronizzato (thread-safe).

ICollection.SyncRoot

Ottiene un oggetto che può essere usato per sincronizzare l'accesso alla raccolta.

IEnumerable.GetEnumerator()

Restituisce un enumeratore per la raccolta.

IList.Add(Object)

Aggiunge DataGridTableStyle a questa raccolta.

IList.Clear()

Cancella la raccolta.

IList.Contains(Object)

Determina se un elemento è incluso nella raccolta.

IList.IndexOf(Object)

Restituisce un indice in base zero per la prima occorrenza dell'oggetto specificato nella raccolta.

IList.Insert(Int32, Object)

Implementa il metodo Insert(Int32, Object). Genera sempre NotSupportedException.

IList.IsFixedSize

Ottiene un valore che indica se la dimensione della raccolta è fissa.

IList.IsReadOnly

Ottiene un valore che indica se la raccolta è di sola lettura.

IList.Item[Int32]

Ottiene o imposta l'elemento in corrispondenza dell'indice specificato.

IList.Remove(Object)

Rimuove l'oggetto DataGridTableStyle specificato.

IList.RemoveAt(Int32)

Rimuove dall'insieme l'oggetto DataGridColumnStyle con l'indice specificato.

Metodi di estensione

Cast<TResult>(IEnumerable)

Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.

OfType<TResult>(IEnumerable)

Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.

AsParallel(IEnumerable)

Consente la parallelizzazione di una query.

AsQueryable(IEnumerable)

Converte un oggetto IEnumerable in un oggetto IQueryable.

Si applica a

Vedi anche