Compartilhar via


ItemsControl.ItemsSource Propriedade

Definição

Obtém ou define uma coleção usada para gerar o conteúdo do ItemsControl.

public:
 property System::Collections::IEnumerable ^ ItemsSource { System::Collections::IEnumerable ^ get(); void set(System::Collections::IEnumerable ^ value); };
[System.ComponentModel.Bindable(true)]
public System.Collections.IEnumerable ItemsSource { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.ItemsSource : System.Collections.IEnumerable with get, set
Public Property ItemsSource As IEnumerable

Valor da propriedade

Uma coleção que é usada para gerar o conteúdo do ItemsControl. O padrão é null.

Atributos

Comentários

Modelo de conteúdo: Essa propriedade pode ser usada para adicionar itens a um ItemsControl.

Um cenário comum é usar um ItemsControl como , ListBoxListViewou TreeView para exibir uma coleção de dados ou associar um ItemsControl a um objeto de coleção. Para associar um ItemsControl a um objeto de coleção, use a ItemsSource propriedade . Observe que a propriedade dá suporte OneWay à ItemsSource associação por padrão.

Quando a ItemsSource propriedade é definida, a Items coleção é feita somente leitura e tamanho fixo.

Quando ItemsSource está em uso, definir a propriedade como null remove a coleção e restaura o uso para Items, que será um vazio ItemCollection. Quando ItemsSource não está em uso, o valor dessa propriedade é nulle defini-la null como não tem efeito.

Observação

Na maioria dos casos, você não precisa implementar suas próprias coleções. Em vez disso, considere usar ObservableCollection<T> ou outras coleções existentes. Para obter mais informações, confira "Objetos de coleção usados como origem da associação" em Visão geral de fontes de associação.

Uso do Atributo XAML

<object ItemsSource="bindingDeclaration"/>

Valores XAML

bindingDeclaration Uma Binding declaração. Confira Extensão de Marcação de Associação para obter mais informações.

Informações da propriedade de dependência

Campo Identificador ItemsSourceProperty
Propriedades de metadados definidas como true Nenhum

Aplica-se a