GridTableStylesCollection Classe

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Representa uma coleção de objetos DataGridTableStyle no controle 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

Herança

Object

MarshalByRefObject

BaseCollection

GridTableStylesCollection

Atributos

ListBindableAttribute

Implementações

ICollection IEnumerable IList

Exemplos

O exemplo de código a TableStyles seguir cria dois DataGridTableStyle objetos e adiciona cada um ao GridTableStylesCollection retornado pela propriedade de um DataGrid controle.

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

Comentários

O GridTableStylesCollection contém DataGridTableStyle objetos que permitem que o DataGrid controle exiba um estilo de grade personalizado para cada DataTable um em um DataSet.

DataGrid No controle , a TableStyles propriedade retorna o GridTableStylesCollection.

Por padrão, o GridTableStylesCollection não contém nenhum DataGridTableStyle objeto. Em vez disso, o DataGrid exibe cada tabela usando configurações padrão para cor, largura e formatação. Todas as colunas de cada tabela são exibidas. Quando um DataGridTableStyle é adicionado à coleção, o usa o DataGridMappingName para determinar qual objeto fornece os dados para a grade. Por exemplo, se a fonte de dados for um DataSet que contém três DataTable objetos, o MappingName deverá corresponder ao TableName de um dos objetos. Se o MappingName não corresponder a TableName nenhum dos valores, as configurações padrão serão usadas para exibir dados para cada tabela e as DataGridTableStyle configurações serão ignoradas.

Cuidado

Sempre crie DataGridColumnStyle objetos e adicione-os GridColumnStylesCollection ao antes de adicionar DataGridTableStyle objetos ao GridTableStylesCollection. Quando você adiciona um vazio DataGridTableStyle com um valor válido MappingName à coleção, DataGridColumnStyle os objetos são gerados automaticamente para você. Consequentemente, uma exceção será gerada se você tentar adicionar novos DataGridColumnStyle objetos com valores duplicados MappingName ao GridColumnStylesCollection. Como alternativa, desmarque o GridColumnStylesCollection usando o Clear método .

Propriedades

Count	Obtém o número total de elementos na coleção. (Herdado de BaseCollection)
IsReadOnly	Obtém um valor que indica se a coleção é somente leitura. (Herdado de BaseCollection)
IsSynchronized	Obtém um valor que indica se o acesso à ICollection é sincronizado. (Herdado de BaseCollection)
Item[Int32]	Obtém o DataGridTableStyle especificado pelo índice.
Item[String]	Obtém o DataGridTableStyle com o nome especificado.
List	Obtém a lista subjacente.
SyncRoot	Obtém um objeto que pode ser usado para sincronizar o acesso ao BaseCollection. (Herdado de BaseCollection)

Métodos

Add(DataGridTableStyle)	Adiciona um DataGridTableStyle a esta coleção.
AddRange(DataGridTableStyle[])	Adiciona uma matriz de estilos de tabela à coleção.
Clear()	Limpa a coleção.
Contains(DataGridTableStyle)	Obtém um valor que indica se a GridTableStylesCollection contém o DataGridTableStyle especificado.
Contains(String)	Obtém um valor que indica se a GridTableStylesCollection contém o DataGridTableStyle especificado pelo nome.
CopyTo(Array, Int32)	Copia todos os elementos do Array unidimensional atual para o Array unidimensional especificado, começando no índice Array de destino especificado. (Herdado de BaseCollection)
CreateObjRef(Type)	Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetEnumerator()	Obtém o objeto que permite a iteração através dos membros da coleção. (Herdado de BaseCollection)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLifetimeService()	Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InitializeLifetimeService()	Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)	Aciona o evento CollectionChanged.
Remove(DataGridTableStyle)	Remove o DataGridTableStyle especificado.
RemoveAt(Int32)	Remove um DataGridTableStyle no índice especificado.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Eventos

CollectionChanged

Ocorre quando a coleção foi alterada.

Implantações explícitas de interface

ICollection.CopyTo(Array, Int32)	Copia a coleção para um Array unidimensional compatível, começando no índice especificado da matriz de destino.
ICollection.Count	Obtém o número de itens na coleção.
ICollection.IsSynchronized	Obtém um valor que indica se o acesso à GridTableStylesCollection é sincronizado (thread-safe).
ICollection.SyncRoot	Obtém um objeto que pode ser usado para sincronizar o acesso à coleção.
IEnumerable.GetEnumerator()	Retorna um enumerador para a coleção.
IList.Add(Object)	Adiciona um DataGridTableStyle a esta coleção.
IList.Clear()	Limpa a coleção.
IList.Contains(Object)	Determina se um elemento está na coleção.
IList.IndexOf(Object)	Retorna o índice baseado em zero da primeira ocorrência do objeto especificado na coleção.
IList.Insert(Int32, Object)	Implementa o método Insert(Int32, Object). Sempre gera NotSupportedException.
IList.IsFixedSize	Obtém um valor que indica se a coleção tem um tamanho fixo.
IList.IsReadOnly	Obtém um valor que indica se a coleção é somente leitura.
IList.Item[Int32]	Obtém ou define o elemento no índice especificado.
IList.Remove(Object)	Remove o DataGridTableStyle especificado.
IList.RemoveAt(Int32)	Remove o DataGridColumnStyle com o índice especificado da coleção.

Métodos de Extensão

Cast<TResult>(IEnumerable)	Converte os elementos de um IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)	Filtra os elementos de um IEnumerable com base em um tipo especificado.
AsParallel(IEnumerable)	Habilita a paralelização de uma consulta.
AsQueryable(IEnumerable)	Converte um IEnumerable em um IQueryable.

Confira também

• DataGrid
• GridColumnStyles