Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe GridTableStylesCollection

 

Representa uma coleção de DataGridTableStyle objetos no DataGrid controle.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (em System.Windows.Forms.dll)

System.Object
  System.MarshalByRefObject
    System.Windows.Forms.BaseCollection
      System.Windows.Forms.GridTableStylesCollection

[ListBindableAttribute(false)]
public class GridTableStylesCollection : BaseCollection, IList, 
	ICollection, IEnumerable

NomeDescrição
System_CAPS_pubpropertyCount

Obtém o número total de elementos na coleção.(Herdado de BaseCollection.)

System_CAPS_pubpropertyIsReadOnly

Obtém um valor que indica se a coleção é somente leitura.(Herdado de BaseCollection.)

System_CAPS_pubpropertyIsSynchronized

Obtém um valor que indica se o acesso para o ICollection é sincronizado.(Herdado de BaseCollection.)

System_CAPS_pubpropertyItem[Int32]

Obtém o DataGridTableStyle especificado pelo índice.

System_CAPS_pubpropertyItem[String]

Obtém o DataGridTableStyle com o nome especificado.

System_CAPS_protpropertyList

Obtém a lista subjacente.(Substitui o BaseCollection.List.)

System_CAPS_pubpropertySyncRoot

Obtém um objeto que pode ser usado para sincronizar o acesso a BaseCollection.(Herdado de BaseCollection.)

NomeDescrição
System_CAPS_pubmethodAdd(DataGridTableStyle)

Adiciona um DataGridTableStyle a esta coleção.

System_CAPS_pubmethodAddRange(DataGridTableStyle[])

Adiciona uma matriz de estilos de tabela à coleção.

System_CAPS_pubmethodClear()

Limpa a coleção.

System_CAPS_pubmethodContains(DataGridTableStyle)

Obtém um valor que indica se o GridTableStylesCollection contém especificada DataGridTableStyle.

System_CAPS_pubmethodContains(String)

Obtém um valor que indica se o GridTableStylesCollection contém o DataGridTableStyle especificado pelo nome.

System_CAPS_pubmethodCopyTo(Array, Int32)

Copia todos os elementos do atual unidimensional Array especificado unidimensional Array iniciando no destino especificado Array índice.(Herdado de BaseCollection.)

System_CAPS_pubmethodCreateObjRef(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.)

System_CAPS_pubmethodEquals(Object)

Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)

System_CAPS_protmethodFinalize()

Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)

System_CAPS_pubmethodGetEnumerator()

Obtém o objeto que permite a iteração através dos membros da coleção.(Herdado de BaseCollection.)

System_CAPS_pubmethodGetHashCode()

Serve como a função de hash padrão.(Herdado de Object.)

System_CAPS_pubmethodGetLifetimeService()

Recupera o objeto atual de serviço de vida útil que controla a diretiva de vida útil para esta instância. (Herdado de MarshalByRefObject.)

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_pubmethodInitializeLifetimeService()

Obtém um objeto de serviço de tempo de vida para controlar a diretiva de vida útil para esta instância. (Herdado de MarshalByRefObject.)

System_CAPS_protmethodMemberwiseClone()

Cria uma cópia superficial do Object atual.(Herdado de Object.)

System_CAPS_protmethodMemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.(Herdado de MarshalByRefObject.)

System_CAPS_protmethodOnCollectionChanged(CollectionChangeEventArgs)

Gera o CollectionChanged evento.

System_CAPS_pubmethodRemove(DataGridTableStyle)
System_CAPS_pubmethodRemoveAt(Int32)

Remove um DataGridTableStyle no índice especificado.

System_CAPS_pubmethodToString()

Retorna uma string que representa o objeto atual.(Herdado de Object.)

NomeDescrição
System_CAPS_pubeventCollectionChanged

Ocorre quando a coleção foi alterada.

NomeDescrição
System_CAPS_pubinterfaceSystem_CAPS_privmethodICollection.CopyTo(Array, Int32)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Copia a coleção para uma compatível unidimensional Array, iniciando no índice especificado na matriz de destino.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIEnumerable.GetEnumerator()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Retorna um enumerador para a coleção.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Add(Object)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Adiciona um DataGridTableStyle a esta coleção.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Clear()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Limpa a coleção.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Contains(Object)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Determina se um elemento está na coleção.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.IndexOf(Object)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Retorna o índice baseado em zero da primeira ocorrência do objeto especificado na coleção.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Insert(Int32, Object)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Implementa o Insert método. Sempre lança NotSupportedException.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Remove(Object)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Remove o DataGridTableStyle.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.RemoveAt(Int32)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Remove o DataGridColumnStyle com o índice especificado da coleção.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection.Count

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Obtém o número de itens na coleção.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection.IsSynchronized

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Obtém um valor que indica se o acesso para o GridTableStylesCollection é sincronizado (thread-safe).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection.SyncRoot

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Obtém um objeto que pode ser usado para sincronizar o acesso à coleção.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList.IsFixedSize

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Obtém um valor que indica se a coleção tem um tamanho fixo.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList.IsReadOnly

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Obtém um valor que indica se a coleção é somente leitura.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList.Item[Int32]

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Obtém ou define o elemento no índice especificado.

NomeDescrição
System_CAPS_pubmethodAsParallel()

Sobrecarregado. Permite a paralelização de uma consulta. (Definido pelo ParallelEnumerable.)

System_CAPS_pubmethodAsQueryable()

Sobrecarregado. Converte um IEnumerable em um IQueryable.(Definido pelo Queryable.)

System_CAPS_pubmethodCast<TResult>()

Converte os elementos de um IEnumerable para o tipo especificado.(Definido pelo Enumerable.)

System_CAPS_pubmethodOfType<TResult>()

Filtra os elementos de um IEnumerable com base em um tipo especificado.(Definido pelo Enumerable.)

A GridTableStylesCollection contém DataGridTableStyle objetos que permite a DataGrid controle para exibir um estilo de grade personalizados para cada DataTable em um DataSet.

Sobre o DataGrid controle, o TableStyles propriedade retorna o GridTableStylesCollection.

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

System_CAPS_cautionCuidado

Sempre crie DataGridColumnStyle objetos e adicioná-los para o GridColumnStylesCollection antes de adicionar DataGridTableStyle objetos para o GridTableStylesCollection. Quando você adiciona um vazio DataGridTableStyle com uma validade MappingName valor à coleção, DataGridColumnStyle objetos são gerados automaticamente para você. Conseqüentemente, uma exceção será gerada se você tentar adicionar novos DataGridColumnStyle objetos com duplicata MappingName valores para o GridColumnStylesCollection. Como alternativa, desmarque o GridColumnStylesCollection usando o Clear método.

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

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);
}

.NET Framework
Disponível desde 1.1

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao início
Mostrar: