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 de Propriedade

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

Atributos

Observações

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

Um cenário comum é usar um ItemsControl como um ListBox, ListView, ou TreeView exibir uma coleção de dados, ou associar um ItemsControl a um objeto de coleção. Para associar an ItemsControl a um objeto de coleção, use a ItemsSource propriedade. Note que a ItemsSource propriedade suporta OneWay ligação por defeito.

Quando a ItemsSource propriedade é definida, a Items coleção torna-se apenas de leitura e de tamanho fixo.

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

Note

Na maioria dos casos, não precisa de implementar as suas próprias coleções. Em vez disso, considere usar ObservableCollection<T> outras coleções existentes. Para mais informações, consulte o artigo "Objetos de Coleção Usados como Fonte de Ligação" em Visão Geral de Fontes de Ligação.

Uso de atributos XAML

<object ItemsSource="bindingDeclaration"/>

Valores XAML

vinculaçãoDeclaração Uma Binding declaração. Consulte Extensão de Marcação de Vinculação para mais informações.

Informação de Propriedade de Dependência

Item Value
Campo identificador ItemsSourceProperty
Propriedades dos metadados definidas como true None

Aplica-se a