GridTableStylesCollection Třída

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Představuje kolekci DataGridTableStyle objektů v ovládacím DataGrid prvku.

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

Dědičnost: Object

MarshalByRefObject

BaseCollection
GridTableStylesCollection

Atributy: ListBindableAttribute

Implementuje: ICollection IEnumerable IList

Příklady

Následující příklad kódu vytvoří dva DataGridTableStyle objekty a každý přidá do GridTableStylesCollection vrácené TableStyles vlastností ovládacího prvku DataGrid .

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

Poznámky

Objekt GridTableStylesCollection obsahuje DataGridTableStyle objekty, které ovládacímu prvku umožňují DataGrid zobrazit vlastní styl mřížky pro každý z nich DataTable v objektu DataSet.

DataGrid U ovládacího prvku TableStyles vrátí GridTableStylesCollectionvlastnost .

Ve výchozím nastavení neobsahuje GridTableStylesCollection žádné DataGridTableStyle objekty. Místo toho DataGrid zobrazí každou tabulku pomocí výchozího nastavení pro barvu, šířku a formátování. Zobrazí se všechny sloupce každé tabulky. DataGridTableStyle Při přidání objektu do kolekce použije MappingName objekt k určení objektuDataGrid, který poskytuje data pro mřížku. Pokud je DataSet například zdrojem dat objekt, který obsahuje tři DataTable objekty, MappingName musí se shodovat TableName s jedním z objektů. Pokud se MappingName neshoduje s žádnou z TableName hodnot, použije se k zobrazení dat pro každou tabulku výchozí nastavení a DataGridTableStyle nastavení se bude ignorovat.

Upozornění

Před přidáním DataGridTableStyle objektů do vždy vytvořte DataGridColumnStyle objekty a přidejte je do GridColumnStylesCollection objektu GridTableStylesCollection. Když do kolekce přidáte prázdnou DataGridTableStyle hodnotu s platnou MappingName hodnotou, DataGridColumnStyle objekty se automaticky vygenerují za vás. V důsledku toho dojde k výjimce, pokud se do objektu GridColumnStylesCollectionpokusíte přidat nové DataGridColumnStyle objekty s duplicitními MappingName hodnotami. Případně zrušte zaškrtnutí políčka GridColumnStylesCollection pomocí Clear metody .

Vlastnosti

Count	Získá celkový počet prvků v kolekci. (Zděděno od BaseCollection)
IsReadOnly	Získá hodnotu, která udává, zda je kolekce určena jen pro čtení. (Zděděno od BaseCollection)
IsSynchronized	Získá hodnotu označující, zda je přístup k je ICollection synchronizován. (Zděděno od BaseCollection)
Item[Int32]	DataGridTableStyle Získá hodnotu určenou indexem.
Item[String]	Získá se DataGridTableStyle zadaným názvem.
List	Získá podkladový seznam.
SyncRoot	Získá objekt, který lze použít k synchronizaci přístupu k .BaseCollection (Zděděno od BaseCollection)

Metody

Add(DataGridTableStyle)	Přidá do této kolekce .DataGridTableStyle
AddRange(DataGridTableStyle[])	Přidá do kolekce pole stylů tabulky.
Clear()	Vymaže kolekci.
Contains(DataGridTableStyle)	Získá hodnotu označující, zda GridTableStylesCollection obsahuje zadaný DataGridTableStyle.
Contains(String)	Získá hodnotu označující, zda GridTableStylesCollection obsahuje DataGridTableStyle zadaný podle názvu.
CopyTo(Array, Int32)	Zkopíruje všechny prvky aktuální jednorozměrné Array do zadané jednorozměrné Array počínaje zadaným cílovým Array indexem. (Zděděno od BaseCollection)
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy sloužící ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetEnumerator()	Získá objekt, který umožňuje iterování prostřednictvím členů kolekce. (Zděděno od BaseCollection)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetLifetimeService()	Zastaralé. Načte aktuální životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Zastaralé. Získá životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)	CollectionChanged Vyvolá událost.
Remove(DataGridTableStyle)	Odebere zadanou DataGridTableStylehodnotu .
RemoveAt(Int32)	Odebere objekt v DataGridTableStyle zadaném indexu.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Událost

CollectionChanged

Vyvolá se při změně kolekce.

Explicitní implementace rozhraní

ICollection.CopyTo(Array, Int32)	Zkopíruje kolekci do kompatibilního jednorozměrného Arrayobjektu počínaje zadaným indexem cílového pole.
ICollection.Count	Získá počet prvků v kolekci.
ICollection.IsSynchronized	Získá hodnotu označující, zda přístup k objektu GridTableStylesCollection je synchronizován (bezpečný pro přístup z více vláken).
ICollection.SyncRoot	Získá objekt, který lze použít k synchronizaci přístupu ke kolekci.
IEnumerable.GetEnumerator()	Vrátí enumerátor pro kolekci.
IList.Add(Object)	Přidá do této kolekce .DataGridTableStyle
IList.Clear()	Vymaže kolekci.
IList.Contains(Object)	Určuje, zda je prvek v kolekci.
IList.IndexOf(Object)	Vrátí index od nuly prvního výskytu zadaného objektu v kolekci.
IList.Insert(Int32, Object)	Implementuje metodu Insert(Int32, Object) . Vždy vyhodí NotSupportedException.
IList.IsFixedSize	Získá hodnotu označující, zda kolekce má pevnou velikost.
IList.IsReadOnly	Získá hodnotu, která udává, zda je kolekce určena jen pro čtení.
IList.Item[Int32]	Získá nebo nastaví prvek u zadaného indexu.
IList.Remove(Object)	Odebere zadanou DataGridTableStylehodnotu .
IList.RemoveAt(Int32)	Odebere z DataGridColumnStyle kolekce objekt se zadaným indexem.

Metody rozšíření

Cast<TResult>(IEnumerable)	Přetypuje prvky objektu na IEnumerable zadaný typ.
OfType<TResult>(IEnumerable)	Filtruje prvky objektu IEnumerable na základě zadaného typu.
AsParallel(IEnumerable)	Umožňuje paralelizaci dotazu.
AsQueryable(IEnumerable)	Převede objekt na IEnumerable IQueryable.

Platí pro

Sdílet prostřednictvím