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
Esta documentação foi arquivada e não está sendo atualizada.

Classe PropertyGroupDescription

Descreve o agrupamento de itens usando um nome de propriedade como o critério.

System.Object
  System.ComponentModel.GroupDescription
    System.Windows.Data.PropertyGroupDescription

Namespace:  System.Windows.Data
Assembly:  PresentationFramework (em PresentationFramework.dll)
XMLNS para XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

public class PropertyGroupDescription : GroupDescription
<PropertyGroupDescription .../>

O tipo PropertyGroupDescription expõe os membros a seguir.

  NomeDescrição
Método públicoPropertyGroupDescription()Initializes a new instance of the PropertyGroupDescription class.
Método públicoPropertyGroupDescription(String)Inicializa uma nova instância de PropertyGroupDescription classe com o nome da propriedade especificada.
Método públicoPropertyGroupDescription(String, IValueConverter)Inicializa uma nova instância de PropertyGroupDescription a classe com o nome da propriedade especificada e o conversor.
Método públicoPropertyGroupDescription(String, IValueConverter, StringComparison)Inicializa uma nova instância de PropertyGroupDescription classe com parâmetros especificados.
Início

  NomeDescrição
Propriedade públicaConverterObtém ou define um conversor para aplicar o valor da propriedade ou o item para produzir o valor final que é usado para determinar quais grupos um item pertence.
Propriedade públicaGroupNamesObtém a coleção de nomes que são usados para inicializar um grupo com um conjunto de subgrupos com os nomes de dado. (Herdado de GroupDescription.)
Propriedade públicaPropertyNameObtém ou define o nome da propriedade que é usada para determinar quais grupos um item pertence.
Propriedade públicaStringComparisonObtém ou define um StringComparison valor que especifica a comparação entre o valor de um item (conforme determinado por PropertyName e Converter) e o nome do grupo.
Início

  NomeDescrição
Método públicoEquals(Object)Determina se o especificado Object é igual a atual Object. (Herdado de Object.)
Método protegidoFinalizePermite que um objeto tentar liberar recursos e executar outras operações de limpeza antes que ele é recuperado pela coleta de lixo. (Herdado de Object.)
Método públicoGetHashCodeServes as a hash function for a particular type. (Herdado de Object.)
Método públicoGetTypeObtém o Type da instância atual. (Herdado de Object.)
Método públicoGroupNameFromItemRetorna o nome de grupo (s) para determinado item. (Substitui GroupDescription.GroupNameFromItem(Object, Int32, CultureInfo).)
Método protegidoMemberwiseCloneCria uma cópia superficial do atual Object. (Herdado de Object.)
Método públicoNamesMatchRetorna um valor que indica se o nome do grupo e o nome do item atender de forma que o item pertence ao grupo. (Substitui GroupDescription.NamesMatch(Object, Object).)
Método protegidoOnPropertyChangedRaises the PropertyChanged event. (Herdado de GroupDescription.)
Método públicoShouldSerializeGroupNamesRetorna se processos de serialização devem serializar o valor efetivo de GroupNames propriedade em instâncias dessa classe. (Herdado de GroupDescription.)
Método públicoToStringRetorna um string que representa o objeto atual. (Herdado de Object.)
Início

  NomeDescrição
Evento protegidoPropertyChangedOcorre quando um valor de propriedade alterado. (Herdado de GroupDescription.)
Início

  NomeDescrição
Implementação explícita da interfaceEvento particularINotifyPropertyChanged.PropertyChangedOcorre quando um valor de propriedade alterado. (Herdado de GroupDescription.)
Início

Views support the functionality of grouping, which allows the user to partition the collection in the collection view into logical groups. The groups can be explicit, where the user supplies a list of groups, or implicit, where the groups are generated dynamically depending on the data.

PropertyGroupDescription permite que você crie grupos implícitos com base em um PropertyName. Se você simplesmente deseja agrupar por uma propriedade que você pode definir o PropertyName propriedade. Se você quiser alterar o valor que é usado eventualmente para grupo, você pode usar o Converter propriedade para fornecer um conversor de valor. Por exemplo, convém agrupar itens com base na primeira letra de um nome. Se o PropertyName não for definida, o item propriamente dito é passado para o conversor de valor. O conversor pode retornar uma coleção, que indica que os itens podem aparecer em mais de um grupo.

Você também pode definir como a comparação de seqüência de caracteres deve levar a lugar usando o StringComparison propriedade.

This example shows how to create a view of a data collection in Extensible Application Markup Language (XAML). Views allow for the functionalities of grouping, sorting, filtering, and the notion of a current item.

In the following example, the static resource named places is defined as a collection of Place objects, in which each Place object is consisted of a city name and the state. The prefix src is mapped to the namespace where the data source Places is defined. The prefix scm maps to "clr-namespace:System.ComponentModel;assembly=WindowsBase" and dat maps to "clr-namespace:System.Windows.Data;assembly=PresentationFramework".

The following example creates a view of the data collection that is sorted by the city name and grouped by the state.


  <Window.Resources>

    <src:Places x:Key="places"/>

    <CollectionViewSource Source="{StaticResource places}" x:Key="cvs">
      <CollectionViewSource.SortDescriptions>
        <scm:SortDescription PropertyName="CityName"/>
      </CollectionViewSource.SortDescriptions>
      <CollectionViewSource.GroupDescriptions>
        <dat:PropertyGroupDescription PropertyName="State"/>
      </CollectionViewSource.GroupDescriptions>
    </CollectionViewSource>



The view can then be a binding source, as in the following example:


<ListBox ItemsSource="{Binding Source={StaticResource cvs}}"
         DisplayMemberPath="CityName" Name="lb">
  <ListBox.GroupStyle>
    <x:Static Member="GroupStyle.Default"/>
  </ListBox.GroupStyle>
</ListBox>


For bindings to XML data defined in an XmlDataProvider resource, precede the XML name with an @ symbol.


<XmlDataProvider x:Key="myTasks" XPath="Tasks/Task">
    <x:XData>
        <Tasks xmlns="">
            <Task Name="Groceries" Priority="2" Type="Home">



<CollectionViewSource x:Key="mySortedTasks"
                      Source="{StaticResource myTasks}">
    <CollectionViewSource.SortDescriptions>
        <scm:SortDescription PropertyName="@Priority" />
    </CollectionViewSource.SortDescriptions>
    <CollectionViewSource.GroupDescriptions>
        <dat:PropertyGroupDescription PropertyName="@Priority" />
    </CollectionViewSource.GroupDescriptions>
</CollectionViewSource>


.NET Framework

Com suporte em: 4, 3.5, 3.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 7, Windows Vista SP1 ou posterior, Windows XP SP3, Windows Server 2008 (Server Core não compatível), Windows Server 2008 R2 (Server Core não compatível com SP1 ou posterior), Windows Server 2003 SP2

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos de sistema do .NET Framework.

Quaisquer membros static (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.
Mostrar: