ItemsControl.ItemsSource Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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 |