diff options
Diffstat (limited to 'docs/Xamarin.Forms.Core/Xamarin.Forms/ListViewCachingStrategy.xml')
-rw-r--r-- | docs/Xamarin.Forms.Core/Xamarin.Forms/ListViewCachingStrategy.xml | 5 |
1 files changed, 4 insertions, 1 deletions
diff --git a/docs/Xamarin.Forms.Core/Xamarin.Forms/ListViewCachingStrategy.xml b/docs/Xamarin.Forms.Core/Xamarin.Forms/ListViewCachingStrategy.xml index f783b452..4aca0cf0 100644 --- a/docs/Xamarin.Forms.Core/Xamarin.Forms/ListViewCachingStrategy.xml +++ b/docs/Xamarin.Forms.Core/Xamarin.Forms/ListViewCachingStrategy.xml @@ -25,7 +25,10 @@ </ListView.ItemTemplate> </ListView>]]></code> <para> - <block type="note">When devolopers specify <see cref="F:Xamarin.Forms.ListViewCachingStrategy.RecycleElement" />, <c>OnElementChanged</c> events are not raised when cells are recycled. Instead, the cell is retained and its property values change when the binding context is updated to that of an available cell, <c>OnElementPropertyChanged</c> events are raised. Application developers should remember to listen for the correct events, and should note that their renderers will need to be updated if the default behavior changes to <see cref="F:Xamarin.Forms.ListViewCachingStrategy.RecycleElement" /> in a future release. </block> + <block type="note">When devolopers specify <see cref="F:Xamarin.Forms.ListViewCachingStrategy.RecycleElement" />, <c>OnElementChanged</c> events are not raised when cells are recycled. Instead, the cell is retained and its property values change when the binding context is updated to that of an available cell, <c>OnElementPropertyChanged</c> events are raised. Application developers should remember to listen for the correct events, and should note that their renderers will need to be updated if the default behavior changes to <see cref="F:Xamarin.Forms.ListViewCachingStrategy.RecycleElement" /> in a future release.</block> + </para> + <para> + <block type="note">The UWP platform ignores <see cref="F:Xamarin.Forms.ListViewCachingStrategy.RetainElement" />, because it always uses caching to improve performance. Therefore, if the developer has opted not to use data bindings, they must use <see cref="M:Xamarin.Forms.ListView.OnBindingContextChanged" /> to update cell data on UWP, because it always behaves as if <see cref="F:Xamarin.Forms.ListViewCachingStrategy.RecycleElement" /> was specified.</block> </para> </remarks> </Docs> |