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추가하는 데 사용할 수 있습니다.
일반적인 시나리오는 와 ListView같은 를 ItemsControlListBox사용하거나 TreeView 데이터 컬렉션을 표시하거나 를 컬렉션 개체에 바인딩 ItemsControl 하는 것입니다. 를 컬렉션 개체에 바인딩 ItemsControl 하려면 속성을 사용합니다 ItemsSource . 속성은 ItemsSource 기본적으로 바인딩을 지원합니다 OneWay .
속성이 ItemsSource 설정되면 컬렉션은 Items 읽기 전용 및 고정 크기로 설정됩니다.
가 사용 중인 경우 ItemsSource 속성을 로 null
설정하면 컬렉션이 제거되고 사용량이 Items비어 ItemCollection있는 로 복원됩니다. 가 사용되지 않는 경우 ItemsSource 이 속성의 값은 이며 null
를 로 null
설정해도 아무런 효과가 없습니다.
참고
대부분의 경우 사용자 고유의 컬렉션을 구현할 필요가 없습니다. 대신 또는 다른 기존 컬렉션을 사용하는 ObservableCollection<T> 것이 좋습니다. 자세한 내용은 바인딩 원본 개요의 "바인딩 원본으로 사용되는 컬렉션 개체"를 참조하세요.
XAML 특성 사용
<object ItemsSource="bindingDeclaration"/>
XAML 값
bindingDeclaration 선언입니다 Binding . 자세한 내용은 태그 확장 바인딩 을 참조하세요.
종속성 속성 정보
식별자 필드 | ItemsSourceProperty |
메타 데이터 속성 설정 true |
없음 |
적용 대상
.NET