ItemsControl.ItemsSource Propriedade

Definição

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

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

IEnumerable

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

Atributos

BindableAttribute

Comentários

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

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

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

Quando ItemsSource estiver em uso, a configuração da propriedade para null remover a coleção e restaurar o uso Itemsserá vazia 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, consulte "Objetos de coleção usados como origem de associação" na visão geral de fontes de associação.

Uso do Atributo XAML

<object ItemsSource="bindingDeclaration"/>  

Valores XAML

bindingDeclaration
Uma Binding declaração. Consulte a 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