2,726,008

Downloads

316

Downloads of v 2.1.0.6500-pre1

2,429

Average downloads per day

2016-01-20

Last published

Share on Social Networks

This is a prerelease version of Xamarin.Forms.

Xamarin.Forms

2.1.0.6500-pre1

Build native UIs for iOS, Android, and Windows Phone from a single, shared C# codebase

To install Xamarin.Forms, run the following command in the Package Manager Console

Install-Package Xamarin.Forms -Version 2.1.0.6500-pre1 -Pre

Release Notes

## New Features ##

### ControlTemplates ###

ControlTemplates have been introduced into the 2.1.0 branch, and have been included on the following types:

- [`ContentPage`](https://developer.xamarin.com/api/type/Xamarin.Forms.ContentPage/)
- [`ContentView`](https://developer.xamarin.com/api/type/Xamarin.Forms.ContentView/)
- `TemplatedPage`
- `TemplatedView`

`TemplatedPage` and `TemplatedView` now serve as the base class for `ContentPage` and `ContentView`. ControlTemplates can be used to define the visual appearance of a Control or [`Page`](http://developer.xamarin.com/api/type/Xamarin.Forms.Page/) while providing a clean separation from the visual hierarchy and the Content itself. ControlTemplates can be applied via Style to greatly expand themeability in Xamarin.Forms.

Along with ControlTemplates the concept of TemplateBindings has been introduced. TemplateBindings work identically to normal Bindings however their Source is automatically set to the parent of the target view which owns the ControlTemplate. Usage of a TemplateBinding outside of a ControlTemplate is not supported.

For more details on how to use ControlTemplates see here: http://xfcomplete.net/general/2016/01/20/control-templates/

### DataTemplateSelector ###

IDataTempalteSelectors allow the selection of a DataTemplate at runtime per item in a ListView.ItemsSource.

Usage:

```csharp
class MyDataTemplateSelector : DataTemplateSelector
{
public MyDataTemplateSelector ()
{
// Retain instances!
this.templateOne = new DataTemplate (typeof (ViewA));
this.templateTwo = new DataTemplate (typeof (ViewB));
}

protected override DataTemplate OnSelectTemplate (object item, BindableObject container)
{
if (item is double)
return this.templateOne;
return this.templateTwo;
}

private readonly DataTemplate templateOne;
private readonly DataTemplate templateTwo;
}
```

```xml
<ListView DataTemplate=local:MyDataTemplateSelector />
```

DataTemplateSelectors have the following limitations:

- No more than 20 templates per ListView on Android
- The DataTemplateSelector subclass MUST always return the same template for the same data if queried multiple times
- The DataTemplateSelector must not return another DataTemplateSelector
- The DataTemplateSelector must not return new instances of a DataTemplate on each call, instead the same instance must be returned. Failure to do so will effectively disable virtualization and lead to an enormous memory leak. Don't do this.

### Effects ###

Effects provide an easy way to customize the native look and feel of controls without having to resort to a complete Custom Renderer.  You can use these to customize the native controls, for example, the following Effect shows how to create a Border effect on iOS that will set a 2 pixel purple outline on the control:

```csharp
// located inside iOS specific codebase
public class BorderEffect : PlatformEffect
{
protected override void OnAttached ()
{
Control.Layer.BorderColor = UIColor.Purple.CGColor;
Control.Layer.BorderWidth = 2;
}

protected override void OnDetached ()
{
Control.Layer.BorderWidth = 0;
}
}
```

To apply this effect, all you have to do is attached it via the `IList<Effect> Effects` collection on Element.  This is a much simpler way of fine tuning your user interface with native touches.

### Other Improvements ###

- HasUnevenRows dynamic sizing support;
- ListView Virtualization is now supported on Windows ;
- Generic versions of Create () BindableProperty are no longer supported and deprecated;
- The Entry/Editor updates on WP8 and WinRT are now consistent with other platforms;

## Bug Fixes ##

- [Bug 21780](https://bugzilla.xamarin.com/show_bug.cgi?id=21780) - Windows Phone Editor control has black background with black text, background turns to white when editing.
- [Bug 24769](https://bugzilla.xamarin.com/show_bug.cgi?id=24769) - [Win Phone/winrt] Progress Bar in listview item not working
- [Bug 26868](https://bugzilla.xamarin.com/show_bug.cgi?id=26868) - GroupHeaders do not extend on Windows Phone and WINRT
- [Bug 30370](https://bugzilla.xamarin.com/show_bug.cgi?id=30370) - Background Color on an Entry Control is Applied to the Padding
- [Bug 32615](https://bugzilla.xamarin.com/show_bug.cgi?id=32615) - [Android] OnAppearing is not called on previous page when modal page is popped
- [Bug 32847](https://bugzilla.xamarin.com/show_bug.cgi?id=32847) - Picker text is cleared after selecting an item, whether Picker, DatePicker, or TimePicker
- [Bug 33268](https://bugzilla.xamarin.com/show_bug.cgi?id=33268) - Picker is broken on Windows 8.1
- [Bug 33870](https://bugzilla.xamarin.com/show_bug.cgi?id=33870) - crash when the listview selection is disabled on Windows Phone 8.1 RT
- [Bug 35490](https://bugzilla.xamarin.com/show_bug.cgi?id=35490) - Label Text Misaligned in Windows Phone 8.1 and WinRT (Xamarin Nuget Version 1.5.1.6471)
- [Bug 35811](https://bugzilla.xamarin.com/show_bug.cgi?id=35811) - Navigation.PushAsync from TabbedPage then hit back button causes crash
- [Bug 36171](https://bugzilla.xamarin.com/show_bug.cgi?id= 36171) - WinRT Entry UI not updating on TextChanged
- [Bug 36174](https://bugzilla.xamarin.com/show_bug.cgi?id= 36174) - Android Search Bar vertical text alignment in Forms 2.0
- [Bug 36251](https://bugzilla.xamarin.com/show_bug.cgi?id=36251) - Issues when switching between pages of a TabbedPage on iOS
- [Bug 36422](https://bugzilla.xamarin.com/show_bug.cgi?id=36422) - XamlC Fails When using X:Array in Xaml. Throws NullReferenceExceptio
- [Bug 36559](https://bugzilla.xamarin.com/show_bug.cgi?id=36559) - [WP] Navigating to a ContentPage with a Grid inside a TableView affects Entry heights
- [Bug 36649](https://bugzilla.xamarin.com/show_bug.cgi?id=36649) - LineBreakMode.NoWrap is handled incorrectly on Windows Phone 8.1 RT
- [Bug 36687](https://bugzilla.xamarin.com/show_bug.cgi?id=36687) - On WinPhone 8.1 RT, the background color used in Entry fields is not as expected
- [Bug 36730](https://bugzilla.xamarin.com/show_bug.cgi?id=36730) - OnStart / OnResume are not called on WP8.1 and UWP
- [Bug 36778](https://bugzilla.xamarin.com/show_bug.cgi?id=36778) - ListView on UWP doesn't display Detail line with TextCell
- [Bug 37306](https://bugzilla.xamarin.com/show_bug.cgi?id=37306) - XamlC doesn´t support adding x:String in resource dictionary
- [Bug 37675](https://bugzilla.xamarin.com/show_bug.cgi?id=37675) - Style PropertyChanged called before the Style is applied
- [Bug 37779](https://bugzilla.xamarin.com/show_bug.cgi?id=37779) - TabbedPageRenderer throws exceptions on Android 4.0.4 when using Material Design theme
- Fixes to OnAppearing/OnDisappearing;
- Fixes to PanGestureRecognizer on android;
- Fixes to animation safety;
- UWP fix headerzoom;
- Fixes an issue where images sometimes didn't load on WP8;


## Known Issues ##

- WinRT reloads toolbar items on navigation even when they haven't changed

Owners

Authors

Xamarin Inc.

Copyright

Copyright 2013-2015

Dependencies

Version History

Version Downloads Last updated
Xamarin.Forms 2.3.5.239-pre3 10,239 Thursday, May 11, 2017
Xamarin.Forms 2.3.5.235-pre2 4,788 Wednesday, April 26, 2017
Xamarin.Forms 2.3.5.233-pre1 3,209 Thursday, April 13, 2017
Xamarin.Forms 2.3.4.247 76,099 Tuesday, May 16, 2017
Xamarin.Forms 2.3.4.231 91,531 Wednesday, April 12, 2017
Xamarin.Forms 2.3.4.224 95,412 Wednesday, March 29, 2017
Xamarin.Forms 2.3.4.221-pre6 3,875 Monday, March 27, 2017
Xamarin.Forms 2.3.4.214-pre5 6,314 Tuesday, March 14, 2017
Xamarin.Forms 2.3.4.212-pre4 2,722 Friday, March 10, 2017
Xamarin.Forms 2.3.4.211-pre3 893 Thursday, March 9, 2017
Xamarin.Forms 2.3.4.192-pre2 12,876 Friday, February 3, 2017
Xamarin.Forms 2.3.4.184-pre1 6,303 Friday, January 13, 2017
Xamarin.Forms 2.3.3.193 131,495 Wednesday, February 1, 2017
Xamarin.Forms 2.3.3.180 141,852 Thursday, January 5, 2017
Xamarin.Forms 2.3.3.175 93,812 Tuesday, December 6, 2016
Xamarin.Forms 2.3.3.168 51,128 Wednesday, November 23, 2016
Xamarin.Forms 2.3.3.166-pre4 5,498 Thursday, November 3, 2016
Xamarin.Forms 2.3.3.163-pre3 5,025 Monday, October 17, 2016
Xamarin.Forms 2.3.3.152-pre2 11,041 Thursday, September 15, 2016
Xamarin.Forms 2.3.2.127 190,950 Wednesday, September 14, 2016
Xamarin.Forms 2.3.2.118-pre1 5,686 Wednesday, August 3, 2016
Xamarin.Forms 2.3.1.114 125,371 Wednesday, August 3, 2016
Xamarin.Forms 2.3.1.113-pre3 2,548 Tuesday, July 19, 2016
Xamarin.Forms 2.3.1.111-pre2 3,772 Monday, July 4, 2016
Xamarin.Forms 2.3.1.110-pre1 1,412 Wednesday, June 29, 2016
Xamarin.Forms 2.3.0.107 138,463 Wednesday, June 29, 2016
Xamarin.Forms 2.3.0.49 55,238 Thursday, June 16, 2016
Xamarin.Forms 2.3.0.46-pre3 10,485 Monday, May 30, 2016
Xamarin.Forms 2.3.0.38-pre2 10,444 Wednesday, April 27, 2016
Xamarin.Forms 2.3.0.34-pre1 6,661 Wednesday, April 27, 2016
Xamarin.Forms 2.2.0.45 82,177 Monday, May 30, 2016
Xamarin.Forms 2.2.0.31 105,704 Wednesday, April 27, 2016
Xamarin.Forms 2.2.0.23-pre4 2,104 Wednesday, April 20, 2016
Xamarin.Forms 2.2.0.18-pre3 1,219 Wednesday, April 20, 2016
Xamarin.Forms 2.2.0.5-pre2 14,933 Friday, April 8, 2016
Xamarin.Forms 2.2.0.4-pre1 17,456 Tuesday, April 5, 2016
Xamarin.Forms 2.1.0.6529 79,862 Sunday, March 13, 2016
Xamarin.Forms 2.1.0.6526 14,517 Wednesday, March 9, 2016
Xamarin.Forms 2.1.0.6524 23,843 Wednesday, March 2, 2016
Xamarin.Forms 2.1.0.6521 7,644 Tuesday, March 1, 2016
Xamarin.Forms 2.1.0.6517-pre5 1,078 Thursday, February 18, 2016
Xamarin.Forms 2.1.0.6513-pre4 1,020 Tuesday, February 9, 2016
Xamarin.Forms 2.1.0.6508-pre3 1,307 Thursday, January 28, 2016
Xamarin.Forms 2.1.0.6503-pre2 5,854 Friday, January 22, 2016
Xamarin.Forms 2.1.0.6501-pre1 473 Thursday, January 21, 2016
Xamarin.Forms 2.1.0.6500-pre1 (this version) 316 Wednesday, January 20, 2016
Xamarin.Forms 2.0.1.6505 77,743 Thursday, January 28, 2016
Xamarin.Forms 2.0.1.6495 61,214 Wednesday, January 20, 2016
Xamarin.Forms 2.0.1.6492-pre1 2,783 Thursday, December 3, 2015
Xamarin.Forms 2.0.0.6490 76,833 Tuesday, December 1, 2015
Xamarin.Forms 2.0.0.6484 15,768 Saturday, November 21, 2015
Xamarin.Forms 2.0.0.6482 190,285 Tuesday, November 17, 2015
Xamarin.Forms 1.5.2.6478-pre3 284 Tuesday, November 17, 2015
Xamarin.Forms 1.5.2.6477-pre2 2,382 Tuesday, November 10, 2015
Xamarin.Forms 1.5.2.6469-pre1 1,038 Tuesday, October 20, 2015
Xamarin.Forms 1.5.1.6471 64,944 Tuesday, October 20, 2015
Xamarin.Forms 1.5.1.6468 2,603 Tuesday, October 20, 2015
Xamarin.Forms 1.5.1.6460-pre2 533 Tuesday, October 13, 2015
Xamarin.Forms 1.5.1.6455-pre1 1,447 Friday, October 2, 2015
Xamarin.Forms 1.5.0.6447 38,067 Friday, September 25, 2015
Xamarin.Forms 1.5.0.6446 17,537 Wednesday, September 16, 2015
Xamarin.Forms 1.5.0.6404-pre3 2,125 Tuesday, August 25, 2015
Xamarin.Forms 1.5.0.6401-pre2 368 Friday, August 21, 2015
Xamarin.Forms 1.5.0.6396-pre1 938 Wednesday, August 5, 2015
Xamarin.Forms 1.4.4.6449 1,339 Friday, September 25, 2015
Xamarin.Forms 1.4.4.6443 552 Wednesday, September 16, 2015
Xamarin.Forms 1.4.4.6392 46,648 Wednesday, July 29, 2015
Xamarin.Forms 1.4.4.6391 992 Tuesday, July 28, 2015
Xamarin.Forms 1.4.4.6387 1,908 Monday, July 27, 2015
Xamarin.Forms 1.4.4.6379-pre3 538 Monday, July 20, 2015
Xamarin.Forms 1.4.4.6378-pre2 378 Thursday, July 16, 2015
Xamarin.Forms 1.4.4.6377-pre1 338 Tuesday, July 14, 2015
Xamarin.Forms 1.4.3.6376 27,529 Thursday, July 9, 2015
Xamarin.Forms 1.4.3.6374 13,320 Wednesday, July 1, 2015
Xamarin.Forms 1.4.3.6372 1,035 Tuesday, June 30, 2015
Xamarin.Forms 1.4.3.6364-pre3 1,247 Tuesday, June 16, 2015
Xamarin.Forms 1.4.3.6358-pre2 4,259 Friday, April 24, 2015
Xamarin.Forms 1.4.3.6356-pre1 422 Tuesday, April 21, 2015
Xamarin.Forms 1.4.2.6359 44,403 Thursday, April 30, 2015
Xamarin.Forms 1.4.2.6355 10,741 Tuesday, April 21, 2015
Xamarin.Forms 1.4.2.6353-pre2 1,419 Tuesday, March 31, 2015
Xamarin.Forms 1.4.2.6350-pre1 465 Monday, March 30, 2015
Xamarin.Forms 1.4.1.6349 29,595 Monday, March 30, 2015
Xamarin.Forms 1.4.1.6347-pre2 2,232 Thursday, March 19, 2015
Xamarin.Forms 1.4.1.6342-pre1 702 Tuesday, March 10, 2015
Xamarin.Forms 1.4.0.6341 24,659 Monday, March 9, 2015
Xamarin.Forms 1.4.0.6340-pre2 1,058 Friday, March 6, 2015
Xamarin.Forms 1.4.0.6336-pre1 586 Tuesday, March 3, 2015
Xamarin.Forms 1.3.5.6337 3,930 Thursday, March 5, 2015
Xamarin.Forms 1.3.5.6335 15,037 Monday, March 2, 2015
Xamarin.Forms 1.3.5.6333-pre1 956 Tuesday, February 17, 2015
Xamarin.Forms 1.3.4.6332 14,030 Tuesday, February 17, 2015
Xamarin.Forms 1.3.4.6331-pre4 521 Friday, February 13, 2015
Xamarin.Forms 1.3.4.6329-pre3 309 Thursday, February 12, 2015
Xamarin.Forms 1.3.4.6328-pre2 346 Wednesday, February 11, 2015
Xamarin.Forms 1.3.4.6325-pre1 318 Monday, February 9, 2015
Xamarin.Forms 1.3.3.6323 39,028 Monday, February 9, 2015
Xamarin.Forms 1.3.3.6322-pre3 281 Friday, February 6, 2015
Xamarin.Forms 1.3.3.6321-pre2 437 Wednesday, February 4, 2015
Xamarin.Forms 1.3.3.6318-pre1 403 Monday, February 2, 2015
Xamarin.Forms 1.3.2.6316 5,878 Tuesday, February 3, 2015
Xamarin.Forms 1.3.2.6313-pre3 379 Friday, January 30, 2015
Xamarin.Forms 1.3.2.6309-pre2 431 Wednesday, January 28, 2015
Xamarin.Forms 1.3.2.6299-pre1 1,132 Tuesday, January 20, 2015
Xamarin.Forms 1.3.1.6296 40,333 Sunday, January 4, 2015
Xamarin.Forms 1.3.1.6294-pre1 3,080 Wednesday, December 24, 2014
Xamarin.Forms 1.3.0.6292 7,821 Wednesday, December 24, 2014
Xamarin.Forms 1.3.0.6286-pre4 1,162 Friday, December 19, 2014
Xamarin.Forms 1.3.0.6284-pre3 710 Friday, December 12, 2014
Xamarin.Forms 1.3.0.6280-pre2 620 Tuesday, December 9, 2014
Xamarin.Forms 1.3.0.6275-pre1 6,794 Wednesday, November 12, 2014
Xamarin.Forms 1.2.3.6257 32,568 Thursday, October 2, 2014
Xamarin.Forms 1.2.3.6256-pre4 1,295 Friday, September 26, 2014
Xamarin.Forms 1.2.3.6255-pre3 1,601 Saturday, September 20, 2014
Xamarin.Forms 1.2.3.6249-pre2 906 Tuesday, September 9, 2014
Xamarin.Forms 1.2.3.6246-pre1 3,109 Friday, August 15, 2014
Xamarin.Forms 1.2.2.6243 23,481 Wednesday, July 30, 2014
Xamarin.Forms 1.2.2.6241-pre3 1,750 Monday, July 28, 2014
Xamarin.Forms 1.2.2.6240-pre2 3,419 Tuesday, July 22, 2014
Xamarin.Forms 1.2.2.6238-pre1 2,500 Thursday, July 17, 2014
Xamarin.Forms 1.2.1.6229 6,568 Monday, July 14, 2014
Xamarin.Forms 1.1.1.6206 12,997 Thursday, June 19, 2014
Xamarin.Forms 1.1.0.6201 10,325 Thursday, June 12, 2014
Xamarin.Forms 1.0.6197 2,885 Wednesday, June 4, 2014
Xamarin.Forms 1.0.6188 9,706 Wednesday, May 28, 2014