Windows Phone Silverlight to Windows Runtime 8 namespace and class mappings

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

Note  For info about porting to a Universal Windows Platform (UWP) app for Windows 10, see Namespace and class mappings.

 

This topic provides a comprehensive mapping of Windows Phone Silverlight APIs to their Windows Runtime 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 Windows Runtime 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 Windows Runtime namespace name. Your class will be in that namespace. If your namespace is not listed then its name has not changed.

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

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

System.ServiceModel.BasicHttpBinding 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

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.DnsEndPoint, IPAddress classes

HostName class

System.Net.HttpUtility class

HtmlFormatHelper class

System.Net.WebClient class

HttpClient class

System.Net.Sockets.Socket class

StreamSocket class

System.Net.Sockets.UdpAnySourceMulticastClient, UdpSingleSourceMulticastClient classes

DatagramSocket 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.Reflection.Emit.ILGenerator class

No direct equivalent

Reactive Extensions

Microsoft.Phone.Reactive namespace

No direct equivalent

Resources

System.Resources.ResourceManager class

ResourceManager class

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,

(SII = System.IO.IsolatedStorage)

SII.IsolatedStorageFile class

StorageFile class

(SII = System.IO.IsolatedStorage)

SII.IsolatedStorageSettings class

ApplicationDataContainer class

Wallet

Microsoft.Phone.Wallet namespace

Windows.ApplicationModel.Wallet namespace