ApplicationBarIconButton.IconUri Property

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Gets or sets the URI of the icon to use for the button.

Namespace:  Microsoft.Phone.Shell
Assembly:  Microsoft.Phone (in Microsoft.Phone.dll)
XMLNS for XAML: Not mapped to an xmlns.


Public Property IconUri As Uri
public Uri IconUri { get; set; }
<object IconUri="Uri" .../>

Property Value

Type: System..::.Uri
The URI of the icon to use for the button.




Exception Condition

The value was set to null while the button belongs to an Application Bar.


The URI is not valid.


The URI must point to a file in the application directory. When adding an image file to a project using Windows Phone SDK, you must set the Build Action property to “Content”. Using the default value “Resource” will not allow the image to be accessed or displayed.

Version Information

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0


Windows Phone

See Also


ApplicationBarIconButton Class

Microsoft.Phone.Shell Namespace

Other Resources

App bar for Windows Phone

App bar icon buttons for Windows Phone

How to change app bar icon buttons and menu items dynamically for Windows Phone