Share via


ItemsControl.ItemsSource 속성

정의

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 없음

적용 대상