ItemsControl.ItemsSource 속성

정의

ItemsControl의 콘텐츠를 생성하는 데 사용되는 컬렉션을 가져오거나 설정합니다.Gets or sets a collection used to generate the content of the 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의 콘텐츠를 생성하는 데 사용되는 컬렉션입니다.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 , 또는와 같은을 사용 하 ListBoxListView 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"/>  

XAML 값XAML Values

bindingDeclarationbindingDeclaration
Binding선언입니다.A Binding declaration. 자세한 내용은 바인딩 태그 확장 을 참조 하세요.See Binding Markup Extension for more information.

종속성 속성 정보Dependency Property Information

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

적용 대상