ItemsControl.ItemsSource 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
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
속성 값
ItemsControl의 콘텐츠를 생성하는 데 사용되는 컬렉션입니다. 기본값은 null
입니다.
- 특성
설명
콘텐츠 모델: 이 속성은 항목을 ItemsControl추가하는 데 사용할 수 있습니다.
일반적인 시나리오는 예를 ListBoxListView사용 ItemsControl 하거나 데이터 컬렉션을 표시하거나 TreeView 컬렉션 개체에 ItemsControl 바인딩하는 것입니다. 컬렉션 개체에 ItemsControl 바인딩하려면 속성을 사용합니다 ItemsSource . 이 속성은 ItemsSource 기본적으로 바인딩을 지원합니다 OneWay .
속성이 ItemsSource 설정되면 컬렉션이 Items 읽기 전용이고 고정 크기로 설정됩니다.
사용 중인 경우 ItemsSource 컬렉션을 제거하도록 null
속성을 설정하면 사용량이 비어 ItemCollection있는 상태로 Items복원됩니다. 사용 중이 아닌 경우 ItemsSource 이 속성의 값은 해당 값이며 null
, 이 속성을 설정해 null
도 아무런 효과가 없습니다.
참고
대부분의 경우 사용자 고유의 컬렉션을 구현할 필요가 없습니다. 대신, 사용하거나 다른 기존 컬렉션을 사용하는 ObservableCollection<T> 것이 좋습니다. 자세한 내용은 바인딩 소스 개요의 "바인딩 소스로 사용되는 컬렉션 개체"를 참조하세요.
XAML 특성 사용
<object ItemsSource="bindingDeclaration"/>
XAML 값
bindingDeclaration
선언입니다 Binding . 자세한 내용은 바인딩 태그 확장을 참조하세요.
종속성 속성 정보
식별자 필드 | ItemsSourceProperty |
메타 데이터 속성 설정 true |
없음 |