ItemsControl.ItemsSource 속성

참조

정의

네임스페이스:: System.Windows.Controls

어셈블리:: PresentationFramework.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. 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

속성 값

IEnumerable

ItemsControl의 콘텐츠를 생성하는 데 사용되는 컬렉션입니다. 기본값은 null입니다.

특성: BindableAttribute

설명

콘텐츠 모델: 이 속성은 항목을 ItemsControl추가하는 데 사용할 수 있습니다.

일반적인 시나리오는 예를 ListBox ListView사용 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`	없음

적용 대상