.NET for Windows Store apps overview
The .NET Framework provides a subset of managed types that you can use to create Windows 8.x Store apps using C# or Visual Basic. This subset of managed types is called the .NET for Windows 8.x Store apps and enables .NET Framework developers to create Windows 8.x Store apps within a familiar programming framework. Any types that are not related to developing Windows 8.x Store apps are not included in the subset.
You use these managed types with types from the Windows Runtime API to create Windows 8.x Store apps. Typically, you won't notice any differences between using the managed types and the Windows Runtime types except that the managed types reside in namespaces that start with System, and the Windows Runtime types reside in namespaces that start with Windows. Together, the .NET for Windows 8.x Store apps and the Windows Runtime provide the complete set of types and members available for developing Windows 8.x Store apps with C# or Visual Basic.
The subset of managed types and members was designed with a clear focus on Windows 8.x Store app development. As a result, it omits the following:
Types and members that are not applicable to developing Windows 8.x Store apps (such as console and ASP.NET types).
Obsolete and legacy types.
Types that overlap with Windows Runtime types.
Types and members that wrap operating system functionality (such as System.Diagnostics.EventLog and performance counters).
Members that cause confusion (such as the Close method on I/O types).
In some cases, a type that you used in a .NET Framework desktop app doesn't exist within the .NET for Windows 8.x Store apps. Instead, you can use a type from the Windows Runtime. For example, the System.IO.IsolatedStorage.IsolatedStorageSettings class isn't included in the .NET for Windows 8.x Store apps, but the Windows.Storage.ApplicationDataContainer class provides similar behavior for storing app settings. Examples of common changes you might have to make are included in the section Converting your existing .NET Framework code.
The entire set of assemblies for the .NET for Windows 8.x Store apps is automatically referenced in your project when you create a Windows 8.x Store app using C# or Visual Basic. Therefore, you can use any of the types supported by the .NET for Windows 8.x Store apps in your project without any additional actions. For a list of the combined namespaces provided by the .NET for Windows 8.x Store apps and the Windows Runtime (grouped by functional area), see the .NET Framework and Windows Runtime namespaces section.
For a list of namespaces and types included in the .NET Framework subset, see .NET for Windows apps.
You can also create a Portable Class Library project to develop a .NET Framework library that can be used from a Windows 8.x Store app. The project must include .NET for Windows Store apps as one of the target platforms. The Portable Class Library is particularly useful when you want to develop classes that can be used from apps for different types of platforms, such as a Windows Phone app, desktop app, and Windows 8.x Store app. See Cross-Platform Development with the Portable Class Library.
This topic includes the following sections on .NET for Windows Runtime:
These topics provide information on converting other parts of your app to the Windows Runtime:
Typically, you do not simply convert an existing .NET Framework app to a Windows 8.x Store app; you redesign the .NET Framework app for the new user experience. However, you may want to convert parts of an existing .NET Framework app for use in a new Windows 8.x Store app. When you convert existing .NET Framework code, you should be aware of the following changes you may need to make in your Windows 8.x Store app:
When you convert UI code from a Silverlight-based app or Windows Phone app, you can use many of the same UI types, but the types are now located in the Windows.UI.Xaml namespaces instead of the System.Windows namespaces. These new UI types are similar to the previous .NET Framework UI types but contain some different members.
UI types in System.Windows.* namespaces
UI types in Windows.UI.Xaml.* namespaces
For more information about porting UI code, see Migrating a Windows Phone 7 app to XAML.
The I/O types include new members to support the new await keyword in the asynchronous programming model.
System.IO.Stream.BeginRead and EndRead methods
For an example, see ReadAsync(Byte(), Int32, Int32).
System.IO.Stream.BeginWrite and EndWrite methods
For an example, see WriteAsync(Byte(), Int32, Int32).
Close() method on I/O classes
Dispose() method on I/O classes.
Declare and instantiate the I/O object within a using (C#) or Using (Visual Basic) statement to ensure that it is properly disposed; for example:
Code to retrieve and open a file
Public Async Shared Sub ReadFileSamples() ' Read a file from package Dim packageFolder As StorageFolder = ApplicationModel.Package.Current.InstalledLocation Dim packagedFile As StorageFile = Await packageFolder.GetFileAsync("FileInPackage") ' Read a file from AppData Dim localFolder As StorageFolder = ApplicationData.Current.LocalFolder Dim localFile As StorageFile = Await localFolder.GetFileAsync("FileInAppData ") End Sub
Instead of using the System.IO.IsolatedStorage class, use the types in the Windows.Storage namespaces to store local data and files.
The LocalFolder property on the Windows.Storage.ApplicationData class
The LocalSettings property on the Windows.Storage.ApplicationData class
For more information, see Application data.
System.Net.Http.HttpClient class for sending HTTP requests and receiving HTTP responses
Types in the Windows.Networking.BackgroundTransfer namespace to upload or download large amounts of data
Types in the System.Net.Sockets namespace
Types in the Windows.Networking.Sockets namespace
Relative URIs, when passed to Windows Runtime types
For more information, see Passing a URI to the Windows Runtime.
Exception handling code that catches the UriFormatException exception
Some of the .NET Framework threading members have changed, and some types are now available in the Windows Runtime API.
Interlocked.MemoryBarrier method in the System.Threading namespace
Environment.CurrentManagedThreadId property in the System namespace
CultureInfo.CurrentCulture property in the System.Globalization namespace
CultureInfo.CurrentUICulture property in the System.Globalization namespace
Code that queues work to the pool
Code that queues work to the pool and waits for completion
Code that creates a long-running work item
Most members from the System.Type class have been moved to the System.Reflection.TypeInfo class. You can retrieve the TypeInfo object by calling the System.Reflection.IntrospectionExtensions.GetTypeInfo(System.Type) method, which is an extension method for Type.
For more information, see Reflection in the .NET Framework for Windows Store Apps in the MSDN Library.
Many of the types for security, authentication, and cryptography operations are available through Windows Runtime types. For a complete list of the security namespaces that are available for Windows 8.x Store apps, see the security namespaces list later in this topic.
For Windows 8.x Store apps, you create a single resource file instead of the hub-and-spoke model that is used in desktop apps. In addition, use the resource types in the Windows.ApplicationModel.Resources and Windows.ApplicationModel.Resources.Core namespaces instead of the System.Resources namespace.
For more information, see Creating and retrieving resources in Windows Runtime apps.
In some cases, a managed type throws an exception that is not included in the .NET for Windows 8.x Store apps. In these cases, you can catch the parent class of the exception that is not included. For example, in a desktop app, you catch the UriFormatException exception to handle an invalid URI; but in a Windows 8.x Store app, you catch the FormatException exception because UriFormatException is not included in the .NET for Windows 8.x Store apps. FormatException is the parent class of UriFormatException.
In Windows 8.x Store apps, you can utilize Windows Communication Foundation (WCF) client functionality to retrieve data from a WCF service, but you cannot create a WCF service to serve data.
Changes in general .NET Framework types
A custom method that returns the appropriate type
System.Array.AsReadOnly and System.Collections.Generic.List<T>.AsReadOnly methods
A new instance of the System.Collections.ObjectModel.ReadOnlyCollection(Of T) class, created as follows:
In most cases, you develop Windows 8.x Store apps by using .NET Framework types and Windows Runtime types together without any special consideration or conversion. However, in a few cases, the .NET Framework provides extension methods to simplify the interaction between .NET Framework types and Windows Runtime types. These extension methods are in the following classes:
System.IO.WindowsRuntimeStreamExtensions – for converting between managed streams and streams in the Windows Runtime.
System.IO.WindowsRuntimeStorageExtensions – for opening Windows Runtime files and folders as managed streams.
System.Runtime.InteropServices.WindowsRuntime.WindowsRuntimeBufferExtensions – for converting to and from IBuffer.
The following sections list the namespaces provided in the .NET for Windows 8.x Store apps and Windows Runtime, organized by functionality.