ItemsControl.ItemsSource 속성


ItemsControl의 내용을 생성하는 데 사용된 컬렉션을 가져오거나 설정합니다.Gets or sets a collection used to generate the content of the ItemsControl.

 property System::Collections::IEnumerable ^ ItemsSource { System::Collections::IEnumerable ^ get(); void set(System::Collections::IEnumerable ^ value); };
public System.Collections.IEnumerable ItemsSource { get; set; }
member this.ItemsSource : System.Collections.IEnumerable with get, set
Public Property ItemsSource As IEnumerable

속성 값

ItemsControl의 내용을 생성하는 데 사용된 컬렉션입니다.A collection that is used to generate the content of the ItemsControl. 기본값은 null입니다.The default is null.



콘텐츠 모델: 항목을 추가 하려면이 속성을 사용할 수는 ItemsControl합니다.Content Model: This property may be used to add items to an ItemsControl.

일반적인 시나리오를 사용 하는 것을 ItemsControl 와 같은 ListBox, ListView, 또는 TreeView 데이터 컬렉션을 표시 하거나 바인딩할는 ItemsControl 컬렉션 개체에 합니다.A common scenario is to use an ItemsControl such as a ListBox, ListView, or TreeView to display a data collection, or to bind an ItemsControl to a collection object. 바인딩하는 ItemsControl 컬렉션 개체를 사용 합니다 ItemsSource 속성입니다.To bind an ItemsControl to a collection object, use the ItemsSource property. 유의 합니다 ItemsSource 속성은 지원 OneWay 기본적으로 바인딩.Note that the ItemsSource property supports OneWay binding by default.

경우는 ItemsSource 속성을 설정 합니다 Items 컬렉션은 읽기 전용 및 고정 크기 생성 됩니다.When the ItemsSource property is set, the Items collection is made read-only and fixed-size.

ItemsSource 속성을 설정 하는 사용 중인 null 컬렉션을 제거 하 고 사용량을 복원 Items, 되 고 빈 ItemCollection합니다.When ItemsSource is in use, setting the property to null removes the collection and restores usage to Items, which will be an empty ItemCollection. ItemsSource 는이 속성의 값은 사용에 없는 null로 설정 하 고 null 영향을 주지 않습니다.When ItemsSource is not in use, the value of this property is null, and setting it to null has no effect.


대부분의 경우 사용자 지정 컬렉션을 구현할 필요가 없습니다.In most cases you do not need to implement your own collections. 대신 사용 하는 것이 좋습니다 ObservableCollection<T> 또는 다른 기존 컬렉션입니다.Instead, consider using ObservableCollection<T> or other existing collections. 자세한 내용은는 "컬렉션 개체 소스로 사용 되는 바인딩"를 참조 하세요 바인딩 소스 개요합니다.For more information, see the "Collection Objects Used as Binding Source" in Binding Sources Overview.

XAML 특성 사용XAML Attribute Usage

<object ItemsSource="bindingDeclaration"/>  


Binding 선언 합니다.A Binding declaration. 참조 Binding 태그 확장 자세한 내용은 합니다.See Binding Markup Extension for more information.

종속성 속성 정보Dependency Property Information

식별자 필드Identifier field ItemsSourceProperty
메타 데이터 속성 설정 trueMetadata properties set to true 없음None

적용 대상