ItemsControl.ItemsSource Property

Definition

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; }
member this.ItemsSource : System.Collections.IEnumerable with get, set
Public Property ItemsSource As IEnumerable

Property Value

IEnumerable

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

Attributes

Remarks

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

일반적인 시나리오는 ListBox, ListView또는 TreeView과 같은 ItemsControl를 사용 하 여 데이터 컬렉션을 표시 하거나 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.

Note

대부분의 경우 사용자 지정 컬렉션을 구현할 필요가 없습니다.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 없음None

Applies to