Selector.IsSynchronizedWithCurrentItem Property

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Gets or sets a value that indicates whether the Selector should keep the SelectedItem synchronized with the current item in the Items property.

Namespace:  System.Windows.Controls.Primitives
Assembly:  System.Windows (in System.Windows.dll)

Syntax

'Declaration
<TypeConverterAttribute(GetType(NullableBoolConverter))> _
Public Property IsSynchronizedWithCurrentItem As Nullable(Of Boolean)
[TypeConverterAttribute(typeof(NullableBoolConverter))]
public Nullable<bool> IsSynchronizedWithCurrentItem { get; set; }
<selector IsSynchronizedWithCurrentItem="False"/>
- or -
<object IsSynchronizedWithCurrentItem="{x:Null}"/>

Property Value

Type: System.Nullable<Boolean>
true if the SelectedItem is always synchronized with the current item; false if the SelectedItem is never synchronized with the current item; nulla null reference (Nothing in Visual Basic) if the SelectedItem is synchronized with the current item only if the Selector uses a ICollectionView. The default is nulla null reference (Nothing in Visual Basic).

Exceptions

Exception Condition
ArgumentException

IsSynchronizedWithCurrentItem is set to true.

Remarks

Dependency property identifier field: IsSynchronizedWithCurrentItemProperty

Setting the IsSynchronizedWithCurrentItem property to true will cause an exception.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.