Cette documentation est archivée et n’est pas conservée.

ItemsControl.Items, propriété

Gets the collection used to generate the content of this ItemsControl.

Espace de noms: System.Windows.Controls
Assembly : PresentationFramework (dans presentationframework.dll)
Espace de noms XML :  http://schemas.microsoft.com/winfx/2006/xaml/presentation

public ItemCollection Items { get; }
/** @property */
public ItemCollection get_Items ()

public function get Items () : ItemCollection

 oneOrMoreElements  One or more UIElement objects. 

Valeur de la propriété

The collection that is used to generate the content of this ItemsControl. The default is an empty collection.

Content Model: This property may be used to add items to an ItemsControl. Adding a child to an ItemsControl object implicitly adds it to the ItemCollection for the ItemsControl object. For more information on the content model for ItemsControl, see Items Control Content Model.

RemarqueRemarque :

This property can only be set in Extensible Application Markup Language (XAML) via the collection syntax shown, or by accessing the collection object and using its various methods such as Add. The property to access the collection object itself is read-only, the collection itself is read-write.

Note that you use either the Items or the ItemsSource property to specify the collection that should be used to generate the content of your ItemsControl. When the ItemsSource property is set, the Items collection will be made read-only and fixed-size.

When ItemsSource is in use, setting the ItemsSource property to référence Null (Nothing en Visual Basic) removes the collection and restores usage to Items, which will be an empty ItemCollection.

The Items property can contain items such as strings, objects or other elements. The following example shows how to use the Items property to add content to a Menu control.

Menu myMenu = new Menu();

TextBlock myTextBlock = new TextBlock();
myTextBlock.Text = "My Text";

Button myButton = new Button();
myButton.Content = "My Button";

Note that the ItemCollection is a view, and therefore, you can use the view-related functionalities such as sorting, filtering, and grouping.

For example, if you have an instance of a ListBox myListBox, you can do the following to sort the content of the ListBox. In this example, Content is the name of the property to sort by.

    new SortDescription("Content", ListSortDirection.Descending));

Note that when you do this, the view may or may not be the default view, depending on how the data is set up on your ItemsControl. For example, when the ItemsSource property is bound to a CollectionViewSource, the view that you obtain using the Items property is not the default view.

If your ItemsControl is bound (you are using the ItemsSource property), then you can do the following to get the default view:

        CollectionView myView;

            myView = (CollectionView)CollectionViewSource.GetDefaultView(myItemsControl.ItemsSource);

Alternately, you can specify filtering, sorting, and grouping criteria in XAML using CollectionViewSource.

Microsoft .NET Framework 3.0 est pris en charge sur Windows Vista, Microsoft Windows XP SP2 et Windows Server 2003 SP1.

.NET Framework

Prise en charge dans : 3.0