Windows Phone Silverlight to UWP API mappings
This topic provides a comprehensive mapping of Windows Phone Silverlight APIs to their Universal Windows Platform (UWP) equivalents. There is generally not a one-to-one mapping of functionality, though: either platform may have more or less functionality than its counterpart in a namespace or class.
The mapping table will help you when you're working in a UWP project and you're re-using source code from a Windows Phone Silverlight project. There are differences in the names of namespaces and classes (including UI controls) between the two platforms. In many cases, it's as easy as changing a namespace name and then your code will compile. Sometimes, a class or API name has changed as well as the namespace name. Other times, the mapping takes a bit more work, and in rare cases requires a change in approach.
**How to use the table: ** First, search for the name of the class you're using. Classes are listed whenever the mapping is more complicated than simply changing the namespace name. If your class is not listed, then the mapping is just a namespace change. So, find your class's namespace name and you'll find the equivalent UWP namespace name. Your class will be in that namespace. If your namespace is not listed, then its name has not changed.
Note Windows 10 supports much more of the .NET Framework than a Windows Phone Store app does. For example, Windows 10 has several System.ServiceModel.* namespaces as well as System.Net, System.Net.NetworkInformation, and System.Net.Sockets. Also, in a Windows 10 app, you will benefit from .NET Native, which an ahead-of-time compilation technology that converts MSIL into natively-runnable machine code. .NET Native apps start faster, use less memory, and use less battery than their MSIL counterparts.
| Windows Phone Silverlight | Windows Runtime |
|---|---|
| Advertising | |
| Microsoft.Advertising.Mobile.UI.AdControl class | AdControl class |
| Alarms, reminders, and background agents | |
| Microsoft.Phone.BackgroundAgent class | BackgroundTaskBuilder class |
| Microsoft.Phone.Scheduler namespace | Windows.ApplicationModel.Background namespace |
| Microsoft.Phone.Scheduler.Alarm class | BackgroundTaskBuilder and ToastNotificationManager classes |
| Microsoft.Phone.Scheduler.PeriodicTask, ScheduledAction, ScheduledActionService, ScheduledTask , ScheduledTaskAgent classes | BackgroundTaskBuilder class |
| Microsoft.Phone.Scheduler.Reminder class | BackgroundTaskBuilder and ToastNotificationManager classes |
| Microsoft.Phone.PictureDecoder class | BitmapDecoder class |
| Microsoft.Phone.BackgroundAudio namespace | Windows.Media.Playback namespace |
| Microsoft.Phone.BackgroundTransfer namespace | Windows.Networking.BackgroundTransfer namespace |
| App model and environment | |
| System.AppDomain class | No direct equivalent. See Application, CoreApplication, classes |
| System.Environment class | No direct equivalent |
| System.ComponentModel.Annotations class | No direct equivalent |
| System.ComponentModel.BackgroundWorker class | ThreadPool class |
| System.ComponentModel.DesignerProperties class | DesignMode class |
| System.Threading.Thread, System.Threading.ThreadPool classes | ThreadPool class |
| (ST = System.Threading) ST.Thread.MemoryBarrier method |
(ST = System.Threading) ST.Interlocked.MemoryBarrier method |
| (ST = System.Threading) ST.Thread.ManagedThreadId property |
(S = System) S.Environment.ManagedThreadId property |
| System.Threading.Timer class | ThreadPoolTimer class |
| (SWT = System.Windows.Threading) SWT.Dispatcher class |
CoreDispatcher class |
| (SWT = System.Windows.Threading) SWT.DispatcherTimer class |
DispatcherTimer class |
| Blend for Visual Studio | |
| (MEDC = Microsoft.Expression.Drawing.Core) MEDC.GeometryHelper class |
No direct equivalent |
| Microsoft.Expression.Interactivity namespace | Microsoft.Xaml.Interactivity namespace |
| Microsoft.Expression.Interactivity.Core namespace | Microsoft.Xaml.Interactions.Core namespace |
| (MEIC = Microsoft.Expression.Interactivity.Core) MEIC.ExtendedVisualStateManager class |
No direct equivalent |
| Microsoft.Expression.Interactivity.Input namespace | No direct equivalent |
| Microsoft.Expression.Interactivity.Media namespace | Microsoft.Xaml.Interactions.Media namespace |
| Microsoft.Expression.Shapes namespace | No direct equivalent |
| (MI = Microsoft.Internal) MI.IManagedFrameworkInternalHelper interface |
No direct equivalent |
| Contact and calendar data | |
| Microsoft.Phone.UserData namespace | Windows.ApplicationModel.Contacts, Windows.ApplicationModel.Appointments namespaces |
| (MPU = Microsoft.Phone.UserData) MPU.Account, ContactAddress, ContactCompanyInformation, ContactEmailAddress, ContactPhoneNumber classes |
Contact class |
| (MPU = Microsoft.Phone.UserData) MPU.Appointments class |
AppointmentCalendar class |
| (MPU = Microsoft.Phone.UserData) MPU.Contacts class |
ContactStore class |
| Controls and UI infrastructure | |
| ControlTiltEffect.TiltEffect class | Animations from the Windows Runtime animation library are built into the default Styles of the common controls. See Animation. |
| Microsoft.Phone.Controls namespace | Windows.UI.Xaml.Controls namespace |
| (MPC = Microsoft.Phone.Controls) MPC.ContextMenu class |
PopupMenu class |
| (MPC = Microsoft.Phone.Controls) MPC.DatePickerPage class |
DatePickerFlyout class |
| (MPC = Microsoft.Phone.Controls) MPC.GestureListener class |
GestureRecognizer class |
| (MPC = Microsoft.Phone.Controls) MPC.LongListSelector class |
SemanticZoom class |
| (MPC = Microsoft.Phone.Controls) MPC.ObscuredEventArgs class |
SystemProtection, WindowActivatedEventArgs classes |
| (MPC = Microsoft.Phone.Controls) MPC.Panorama class |
Hub class |
| (MPC = Microsoft.Phone.Controls) MPC.PhoneApplicationFrame, (SWN = System.Windows.Navigation) SWN.NavigationService classes |
Frame class |
| (MPC = Microsoft.Phone.Controls) MPC.PhoneApplicationPage class |
Page class |
| (MPC = Microsoft.Phone.Controls) MPC.TiltEffect class |
PointerDownThemeAnimation class |
| (MPC = Microsoft.Phone.Controls) MPC.TimePickerPage class |
TimePickerFlyout class |
| (MPC = Microsoft.Phone.Controls) MPC.WebBrowser class |
WebView class |
| (MPC = Microsoft.Phone.Controls) MPC.WebBrowserExtensions class |
No direct equivalent |
| (MPC = Microsoft.Phone.Controls) MPC.WrapPanel class |
No direct equivalent for general layout purposes. ItemsWrapGrid and WrapGrid can be used in the items panel template of an items control. |
| (MPD = Microsoft.Phone.Data) MPD.Linq namespace |
No direct equivalent |
| (MPD = Microsoft.Phone.Data) MPD.Linq.Mapping namespace |
No direct equivalent |
| Microsoft.Phone.Globalization namespace | No direct equivalent |
| (MPI = Microsoft.Phone.Info) MPI.DeviceExtendedProperties, DeviceStatus classes |
EasClientDeviceInformation, MemoryManager classes. For more details, see Device status. |
| (MPI = Microsoft.Phone.Info) MPI.MediaCapabilities class |
No direct equivalent |
| (MPI = Microsoft.Phone.Info) MPI.UserExtendedProperties class |
AdvertisingManager class |
| System.Windows namespace | Windows.UI.Xaml namespace |
| System.Windows.Automation namespace | Windows.UI.Xaml.Automation namespace |
| System.Windows.Controls, System.Windows.Input namespaces | Windows.UI.Core, Windows.UI.Input, Windows.UI.Xaml.Controls namespaces |
| System.Windows.Controls.DrawingSurface, DrawingSurfaceBackgroundGrid classes | SwapChainPanel class |
| System.Windows.Controls.RichTextBox class | RichEditBox class |
| System.Windows.Controls.WrapPanel class | No direct equivalent for general layout purposes. ItemsWrapGrid and WrapGrid can be used in the items panel template of an items control. |
| System.Windows.Controls.Primitives namespace | Windows.UI.Xaml.Controls.Primitives namespace |
| System.Windows.Controls.Shapes namespace | Windows.UI.Xaml.Controls.Shapes namespace |
| System.Windows.Data namespace | Windows.UI.Xaml.Data namespace |
| System.Windows.Documents namespace | Windows.UI.Xaml.Documents namespace |
| System.Windows.Ink namespace | No direct equivalent |
| System.Windows.Markup namespace | Windows.UI.Xaml.Markup namespace |
| System.Windows.Navigation namespace | Windows.UI.Xaml.Navigation namespace |
| System.Windows.UIElement.Tap event, EventHandler<GestureEventArgs> delegate | Tapped event, TappedEventHandler delegate |
| Data and services | |
| System.Data.Linq.DataContext class | No direct equivalent |
| System.Data.Linq.Mapping.ColumnAttribute class | No direct equivalent |
| System.Data.Linq.SqlClient.SqlHelpers class | No direct equivalent |
| Devices | |
| Microsoft.Devices, Microsoft.Devices.Sensors namespaces | Windows.Devices.Enumeration, Windows.Devices.Enumeration.Pnp, Windows.Devices.Input, Windows.Devices.Sensors namespaces |
| Microsoft.Devices.Camera, Microsoft.Devices.PhotoCamera classes | MediaCapture class. Also, CameraCaptureUI class (Windows only). |
| Microsoft.Devices.CameraButtons class | HardwareButtons class |
| Microsoft.Devices.CameraVideoBrushExtensions class | CaptureElement class |
| Microsoft.Devices.Environment class | No direct equivalent. As a workaround, use conditional compilation and define a custom symbol. Or you may be able to engineer a workaround using the IsAttached property. |
| Microsoft.Devices.MediaHistory class | No direct equivalent |
| Microsoft.Devices.VibrateController class | VibrationDevice class |
| Microsoft.Devices.Radio.FMRadio class | No direct equivalent |
| Microsoft.Devices.Sensors.Accelerometer, Compass classes | In the Windows.Devices.Sensors namespace |
| Microsoft.Devices.Sensors.Gyroscope class | Gyrometer class |
| Microsoft.Devices.Sensors.Motion class | Inclinometer class |
| Globalization | |
| System.Globalization namespace | Windows.Globalization namespace |
| (ST = System.Threading) ST.Thread.CurrentCulture property |
(SG = System.Globalization) S.CultureInfo.CurrentCulture property |
| (ST = System.Threading) ST.Thread.CurrentUICulture property |
(SG = System.Globalization) S.CultureInfo.CurrentUICulture property |
| Graphics and animation | |
| Microsoft.Xna.Framework.* namespaces, XNA Framework Class Library, Content Pipeline Class Library | No direct equivalent. In general, use Microsoft DirectX with C++. See Developing games and DirectX and XAML interop. |
| Microsoft.Xna.Framework.Audio.Microphone class | MediaCapture class |
| Microsoft.Xna.Framework.Audio.SoundEffect class | MediaElement class |
| Microsoft.Xna.Framework.GamerServices namespace | (WPS = Windows.Phone.System) WPS.UserProfile.GameServices.Core namespace |
| Microsoft.Xna.Framework.GamerServices.Guide class | No direct equivalent |
| Microsoft.Xna.Framework.Input.GamePad class | HardwareButtons class |
| Microsoft.Xna.Framework.Input.Touch.TouchPanel class | GestureRecognizer class |
| (MXFM = Microsoft.Xna.Framework.Media) MXFM.MediaLibrary, MXFM.PhoneExtensions.MediaLibraryExtensions classes |
KnownFolders class |
| Microsoft.Xna.Framework.Media.MediaQueue class | SystemMediaTransportControls class |
| Microsoft.Xna.Framework.Media.Playlist class | BackgroundMediaPlayer class |
| System.Windows.Media namespace | Windows.UI.Xaml.Media namespace |
| System.Windows.Media.RadialGradientBrush class | No direct equivalent. See Media and graphics. |
| System.Windows.Media.Animation namespace | Windows.UI.Xaml.Media.Animation namespace |
| System.Windows.Media.Effects namespace | No direct equivalent |
| System.Windows.Media.Imaging namespace | Windows.UI.Xaml.Media.Imaging namespace |
| System.Windows.Media.Media3D namespace | Windows.UI.Xaml.Media.Media3D namespace |
| System.Windows.Shapes namespace | Windows.UI.Xaml.Shapes namespace |
| Launchers and Choosers | |
| Microsoft.Phone.Tasks.AddressChooserTask, EmailAddressChooserTask, PhoneNumberChooserTask classes | ContactPicker class |
| Microsoft.Phone.Tasks.AddWalletItemTask, AddWalletItemResult classes | Windows.ApplicationModel.Wallet namespace |
| Microsoft.Phone.Tasks.BingMapsDirectionsTask, BingMapsTask classes | No direct equivalent |
| Microsoft.Phone.Tasks.CameraCaptureTask class | MediaCapture class. Also, CameraCaptureUI class (Windows only). |
| Microsoft.Phone.Tasks.MarketplaceDetailTask | CurrentApp class (RequestAppPurchaseAsync method) |
| Microsoft.Phone.Tasks.ConnectionSettingsTask, MarketplaceHubTask, MarketplaceReviewTask, MarketplaceSearchTask, MediaPlayerLauncher, SearchTask, SmsComposeTask, WebBrowserTask classes | Launcher class |
| Microsoft.Phone.Tasks.EmailComposeTask class | EmailMessage class |
| Microsoft.Phone.Tasks.GameInviteTask class | No direct equivalent |
| Microsoft.Phone.Tasks.MapDownloaderTask, MapsDirectionsTask, MapsTask, MapUpdaterTask classes | No direct equivalent |
| Microsoft.Phone.Tasks.PhoneCallTask class | PhoneCallManager class |
| Microsoft.Phone.Tasks.PhotoChooserTask class | FileOpenPicker class |
| Microsoft.Phone.Tasks.SaveAppointmentTask class | AppointmentManager class |
| Microsoft.Phone.Tasks.SaveContactTask, SaveEmailAddressTask, SavePhoneNumberTask classes | StoredContact class (Windows Phone only) |
| Microsoft.Phone.Tasks.SaveRingtoneTask class | No direct equivalent |
| Microsoft.Phone.Tasks.ShareLinkTask, ShareMediaTask, ShareStatusTask classes | DataPackage class |
| Location | |
| System.Device.Location namespace | Windows.Devices.Geolocation namespace |
| System.Device.GeoCoordinateWatcher class | Geolocator class |
| Maps | |
| Microsoft.Phone.Maps namespaces | Windows.Services.Maps namespace |
| Microsoft.Phone.Maps.Controls namespace | Windows.UI.Xaml.Controls.Maps namespace |
| Microsoft.Phone.Maps.Controls.Map class | MapControl class |
| Microsoft.Phone.Maps.Services namespace | Windows.Services.Maps namespace |
| Microsoft.Phone.Maps.Services.GeocodeQuery, ReverseGeocodeQuery classes | MapLocationFinder class |
| System.Device.Location.GeoCoordinate class | Geopoint class |
| Microsoft.Phone.Maps.Services.Route class | MapRoute class |
| Microsoft.Phone.Maps.Services.RouteQuery class | MapRouteFinder class |
| Monetization | |
| Microsoft.Phone.Marketplace namespace | Windows.ApplicationModel.Store namespace |
| Media | |
| Microsoft.Phone.Media namespace | MediaElement class |
| Networking | |
| (MPNN = Microsoft.Phone.Net.NetworkInformation) MPNN.DeviceNetworkInformation class |
Hostname, NetworkInformation classes |
| (MPNN = Microsoft.Phone.Net.NetworkInformation) MPNN.NetworkInterface class |
NetworkInformation class |
| (MPNN = Microsoft.Phone.Net.NetworkInformation) MPNN.NetworkInterfaceInfo class |
ConnectionProfile class |
| (MPNN = Microsoft.Phone.Net.NetworkInformation) MPNN.NetworkInterfaceList class |
NetworkInformation class |
| (MPNN = Microsoft.Phone.Net.NetworkInformation) MPNN.SocketExtensions class |
No direct equivalent |
| (MPNN = Microsoft.Phone.Net.NetworkInformation) MPNN.WebRequestExtensions class |
No direct equivalent |
| Microsoft.Phone.Networking.Voip namespace | No direct equivalent |
| System.Net.CookieCollection class | Still supported, but some properties are missing (for example, IsReadOnly) |
| System.Net.DownloadProgressChangedEventArgs class, and similar classes related to System.Net.WebClient | HttpClient class (or System.Net.Http.HttpClient). Derive from System.Net.Http.StreamContent to measure progress. |
| System.Net.DnsEndPoint, IPAddress classes | These classes are still supported, but some properties are missing. Alternatively, port to the HostName class. |
| System.Net.HttpUtility class | HtmlFormatHelper class |
| System.Net.HttpWebRequest class | Partial support, but the recommended, forward-looking alternative is the HttpClient class (or System.Net.Http.HttpClient). These APIs use System.Net.Http.HttpRequestMessage to represent an HTTP request. |
| System.Net.HttpWebResponse class | Still supported, but use Dispose() instead of Close(). But, the recommended, forward-looking alternative is the HttpClient class (or System.Net.Http.HttpClient). These APIs use System.Net.Http.HttpResponseMessage to represent an HTTP response. |
| (SNN = System.Net.NetworkInformation) SNN.NetworkChange class |
Still supported, except for the constructor. |
| System.Net.OpenReadCompletedEventArgs class, and similar classes related to System.Net.WebClient | HttpClient class (or System.Net.Http.HttpClient) |
| System.Net.Sockets.Socket class | Still supported, but use Dispose() instead of Close(). Alternatively, port to theStreamSocket class. |
| System.Net.Sockets.SocketException class | Still supported, but use the SocketErrorCode property instead of ErrorCode. |
| System.Net.Sockets.UdpAnySourceMulticastClient, UdpSingleSourceMulticastClient classes | DatagramSocket class |
| System.Net.UploadProgressChangedEventArgs class, and similar classes related to System.Net.WebClient | HttpClient class (or System.Net.Http.HttpClient) |
| System.Net.WebClient class | HttpClient class (or System.Net.Http.HttpClient) |
| System.Net.WebRequest class | Partial support (a different set of properties), but the recommended, forward-looking alternative is the HttpClient class (or System.Net.Http.HttpClient). These APIs use System.Net.Http.HttpRequestMessage to represent an HTTP request. |
| System.Net.WebResponse class | Still supported, but use Dispose() instead of Close(). But, the recommended, forward-looking alternative is the HttpClient class (or System.Net.Http.HttpClient). These APIs use System.Net.Http.HttpResponseMessage to represent an HTTP response. |
| (SN = System.Net) SN.WriteStreamClosedEventArgs class |
HttpClient class (or System.Net.Http.HttpClient) |
| (SN = System.Net) SN.WriteStreamClosedEventHandler class |
HttpClient class (or System.Net.Http.HttpClient) |
| System.UriFormatException class | System.FormatException class |
| Notifications | |
| MPN = Microsoft.Phone.Notification namespace | Windows.UI.Notifications, Windows.Networking.PushNotifications namespaces |
| MPN = Microsoft.Phone.Notification MPN.HttpNotification class |
TileNotification class |
| MPN = Microsoft.Phone.Notification MPN.HttpNotificationChannel class |
PushNotificationChannel class |
| Programming | |
| System namespace | Windows.Foundation namespace |
| System.Diagnostics.StackFrame, StackTrace classes | No direct equivalent |
| System.Diagnostics namespace | Windows.Foundation.Diagnostics namespace |
| System.ICloneable interface | A custom method that returns the appropriate type. |
| System.Reflection.Emit.ILGenerator class | No direct equivalent |
| Reactive Extensions | |
| Microsoft.Phone.Reactive namespace | No direct equivalent |
| Reflection | |
| System.Type class | System.Reflection.TypeInfo class. See Reflection in the .NET Framework for UWP apps. |
| Resources | |
| System.Resources.ResourceManager class | (WA = Windows.ApplicationModel) WA.Resources.Core and WA.Resources namespaces, ResourceManager class. See Creating and retrieving resources in Windows Runtime apps. |
| Secure Element | |
| (MPS = Microsoft.Phone.SecureElement) MPS.SecureElementChannel, MPS.SecureElementSession classes |
SmartCardConnection class |
| (MPS = Microsoft.Phone.SecureElement) MPS.SecureElementReader class |
SmartCardReader class |
| Security | |
| (SSC = System.Security.Cryptography) SSC.Aes, SSC.RSA classes |
CryptographicEngine class |
| (SSC = System.Security.Cryptography) SSC.HMACSHA256, SSC.SHA256 classes |
HashAlgorithmProvider class |
| (SSC = System.Security.Cryptography) SSC.ProtectedData class |
DataProtectionProvider class |
| (SSC = System.Security.Cryptography) SSC.RandomNumberGenerator class |
CryptographicBuffer class |
| (SSC = System.Security.Cryptography) SSC.X509Certificates.X509Certificate class |
CertificateEnrollmentManager class |
| Shell | |
| (MPSh = Microsoft.Phone.Shell) MPSh.ApplicationBar class |
CommandBar class |
| (MPSh = Microsoft.Phone.Shell) MPSh.ApplicationBarIconButton class |
AppBarButton class (when used inside the PrimaryCommands property) |
| (MPSh = Microsoft.Phone.Shell) MPSh.ApplicationBarMenuItem class |
AppBarButton class (when used inside the SecondaryCommands property) |
| (MPSh = Microsoft.Phone.Shell) MPSh.CycleTileData, MPSh.FlipTileData, MPSh.IconicTileData, MPSh.ShellTileData, MPSh.StandardTileData classes |
TileTemplateType class |
| (MPSh = Microsoft.Phone.Shell) MPSh.PhoneApplicationService class |
CoreApplication, DisplayRequest classes |
| (MPSh = Microsoft.Phone.Shell) MPSh.ProgressIndicator class |
StatusBarProgressIndicator class |
| (MPSh = Microsoft.Phone.Shell) MPSh.ShellTile class |
SecondaryTile class |
| (MPSh = Microsoft.Phone.Shell) MPSh.ShellTileSchedule class |
TileUpdater class |
| (MPSh = Microsoft.Phone.Shell) MPSh.ShellToast class |
ToastNotificationManager class |
| (MPSh = Microsoft.Phone.Shell) MPSh.SystemTray class |
StatusBar class |
| Storage and I/O | |
| Microsoft.Phone.Storage.ExternalStorage, ExternalStorageDevice, ExternalStorageFile, ExternalStorageFolder classes | KnownFolders class |
| System.IO namespace | Windows.Storage, Windows.Storage.Streams namespaces |
| System.IO.Directory class | StorageFolder class |
| System.IO.File class | StorageFile and PathIO classes |
| (SII = System.IO.IsolatedStorage) SII.IsolatedStorageFile class |
ApplicationData.LocalFolder property |
| (SII = System.IO.IsolatedStorage) SII.IsolatedStorageSettings class |
ApplicationData.LocalSettings property |
| System.IO.Stream class | Still supported, but use ReadAsync() and WriteAsync() instead of BeginRead()/EndRead() and BeginWrite()/EndWrite(). |
| Wallet | |
| Microsoft.Phone.Wallet namespace | Windows.ApplicationModel.Wallet namespace |
| Xml | |
| (SX = System.Xml) | SX.XmlConvert.ToDateTime method |
| (SX = System.Xml) | SX.XmlConvert.ToDateTimeOffset method |
The next topic is Porting the project.