Общие сведения о .NET для приложений Магазина Windows

В .NET Framework имеется набор управляемых типов, которые можно использовать для создания приложений Магазин Windows с помощью C# или Visual Basic. Это подмножество управляемых типов называется Приложения .NET для Магазина Windows и позволяет разработчикам .NET Framework для создавать приложения Магазин Windows с использованием привычной платформы программирования. Все типы, не относящихся к разработке приложений Магазин Windows, не входят в это подмножество.

Эти управляемые типы должны использоваться с типами API Среда выполнения Windows для создания приложения Магазин Windows. Как правило, различия между использованием управляемых типов и типов Среда выполнения Windows незаметны, за исключением того, что управляемые типы находятся в пространствах имен, начинающихся с System, а типы Среда выполнения Windows находятся в пространствах имен, начинающихся с Windows. Вместе Приложения .NET для Магазина Windows и Среда выполнения Windows обеспечивают полный набор типов и членов, доступных для разработки приложений Магазин Windows на языках C# или Visual Basic.

Подмножество управляемых типов и членов было разработано с акцентом на разработку приложений Магазин Windows. В результате оно не содержит следующее:

• типы и члены, неприменимые к разработке приложений Магазин Windows (например, типы консоли и ASP.NET);

• устаревшие типы;

• типы, пересекающиеся с типами Среда выполнения Windows;

• типы и члены, которые обеспечивают оболочку для функций операционной системы (например, EventLog и счетчики производительности);

• члены, вызывающие путаницу (например, метод Close в типах ввода-вывода).

В некоторых случаях тип, который использовался в приложении рабочего стола .NET Framework, не существует в Приложения .NET для Магазина Windows. Вместо него можно использовать тип из Среда выполнения Windows. Например, класс System.IO.IsolatedStorage.IsolatedStorageSettings не содержится в Приложения .NET для Магазина Windows, однако класс Windows.Storage.ApplicationDataContainer обеспечивает аналогичное поведение для хранения параметров приложения. Примеры типовых изменений, которые может потребоваться вносить, описаны в разделе Преобразование существующего кода .NET Framework.

При создании приложения Магазин Windows с помощью C# или Visual Basic в проект автоматически включаются ссылки на весь набор сборок Приложения .NET для Магазина Windows. Поэтому вы можете использовать в проекте любые типы, поддерживаемые Приложения .NET для Магазина Windows, без каких-либо дополнительных действий. Список объединенных пространств имен, входящих в Приложения .NET для Магазина Windows и Среда выполнения Windows (сгруппированный по функциональным областям), представлен в разделе Пространства имен .NET Framework и среды выполнения Windows.

Список пространств имен и типов, входящих в подмножество .NET Framework, см. в разделе .NET for Windows Store apps – supported APIs.

Также можно создать проект Переносимая библиотека классов для разработки библиотеки .NET Framework, которая может использоваться из приложения Магазин Windows. В качестве одной из целевых платформ проект должен включать .NET для приложений Магазина Windows. Переносимая библиотека классов особенно полезна, когда требуется создавать классы, которые можно использовать из приложений для различных типов платформ, таких как приложения Windows Phone, настольные приложения и приложения Магазин Windows. См. раздел Portable Class Libraries.

В этом разделе содержатся следующие подразделы.

• Преобразование существующего кода .NET Framework

• Методы расширения для преобразования типов

• Пространства имен .NET Framework и среды выполнения Windows

В этих разделах содержатся сведения о преобразовании других частей приложения для среды выполнения Windows.

• Портирование приложения в среду выполнения Windows

• Переход с Windows Phone Silverlight на WinRT

• Перенос кода Silverlight или WPF в приложение Магазина Windows

• Языки, инструменты и платформы

Преобразование существующего кода .NET Framework

Как правило, разработчики не осуществляют простое преобразование имеющегося приложения .NET Framework в приложение Магазин Windows; вместо этого они перерабатывают приложение .NET Framework с учетом новых возможностей пользовательского интерфейса. Однако может потребоваться преобразовать часть имеющегося приложения .NET Framework для ее использования в новом приложении Магазин Windows. При преобразовании существующего кода .NET Framework необходимо помнить о следующих изменениях, которые, возможно, нужно будет внести в приложение Магазин Windows.

• Изменения пользовательского интерфейса

• Изменения ввода-вывода

• Изменения хранилища

• Изменения сети

• Изменения в потоках

• Изменения отражения

• Изменения системы безопасности

• Изменения ресурсов

• Изменения исключений

• Изменения WCF

• Изменения в обычных типах .NET Framework

Изменения пользовательского интерфейса

При преобразовании кода пользовательского интерфейса из приложения Silverlight или приложения Windows Phone можно использовать многие похожие типы пользовательского интерфейса, но теперь они находятся в пространстве имен Windows.UI.Xaml, а не в пространстве имен System.Windows. Эти новые типы пользовательского интерфейса аналогичны предыдущим типам пользовательского интерфейса .NET Framework, но содержат ряд других членов.

Заменить	На
Типы пользовательского интерфейса в пространствах имен System.Windows.*	Типы пользовательского интерфейса в пространствах имен Windows.UI.Xaml.* (например, класс Border расположен в пространстве имен Windows.UI.Xaml.Controls)

Дополнительные сведения о портировании кода пользовательского интерфейса см. в разделе Миграция приложения Windows Phone 7 в XAML.

Изменения ввода-вывода

Типы ввода-вывода включают новые члены, поддерживающие новое ключевое слово await в асинхронной модели программирования.

Заменить	На
Методы System.IO.Stream.BeginRead и EndRead	Метод System.IO.Stream.ReadAsync Пример см. в разделе ReadAsync(array<Byte[], Int32, Int32).
Методы System.IO.Stream.BeginWrite и EndWrite	Метод System.IO.Stream.WriteAsync Пример см. в разделе WriteAsync(array<Byte[], Int32, Int32).
Метод Close() в классах ввода-вывода	Метод Dispose() в классах ввода-вывода. -или- Объявите и создайте объект ввода-вывода в инструкции using (C#) или Using (Visual Basic), чтобы он правильно удалялся; например: using (StreamReader sr = new StreamReader(await passedFile.OpenStreamForReadAsync())) { while ((nextLine = await sr.ReadLineAsync()) != null) { contents.Append(nextLine); } } Using sr As StreamReader = New StreamReader(Await passedFile.OpenStreamForReadAsync()) While (nextLine = Await sr.ReadLineAsync()) <> Nothing contents.Append(nextLine) End While End Using
Метод System.IO.File.ReadAllText	Метод ReadTextAsync в классе Windows.Storage.PathIO
Код для получения и открытия файла	public static async void ReadFileSamples() { // Read a file from package StorageFolder packageFolder = ApplicationModel.Package.Current.InstalledLocation; StorageFile packagedFile = await packageFolder.GetFileAsync("FileInPackage"); // Read a file from AppData StorageFolder localFolder = ApplicationData.Current.LocalFolder; StorageFile localFile = await localFolder.GetFileAsync("FileInAppData"); } 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

Изменения хранилища

Вместо класса System.IO.IsolatedStorage используйте для хранения локальных данных и файлов типы в пространствах имен Windows.Storage.

Заменить	На
Класс System.IO.IsolatedStorage.IsolatedStorageFile	Свойство LocalFolder в классе Windows.Storage.ApplicationData ApplicationData.Current.LocalFolder
Класс System.IO.IsolatedStorage.IsolatedStorageSettings	Свойство LocalSettings в классе Windows.Storage.ApplicationData ApplicationData.Current.LocalSettings

Дополнительные сведения см.в разделе Доступ к данным приложения с помощью среды выполнения Windows (приложения среды выполнения Windows).

Изменения сети

Заменить	На
Класс System.Net.WebClient	Класс HttpClient для отправки HTTP-запросов и получения HTTP-ответов -или- Типы в пространстве имен Windows.Networking.BackgroundTransfer для отправки или скачивания больших объемов данных
Типы в пространстве имен System.Net.Sockets	Типы в пространстве имен Windows.Networking.Sockets
Относительные URI при передаче в типы Среда выполнения Windows	Абсолютные URI Дополнительные сведения см. в разделе Передача URI в среду выполнения Windows.
Код обработки исключения, который перехватывает исключение UriFormatException	Код, который перехватывает исключение FormatException, являющееся родительским классом для UriFormatException

Изменения в потоках

Некоторые члены потоков .NET Framework изменились, и некоторые типы теперь доступны в API Среда выполнения Windows.

Заменить	На
Метод System.Threading.Thread.MemoryBarrier	Метод Interlocked.MemoryBarrier в пространстве имен System.Threading
Свойство System.Threading.Thread.ManagedThreadId	Свойство Environment.CurrentManagedThreadId в пространстве имен System
Свойство System.Threading.Thread.CurrentCulture	Свойство CultureInfo.CurrentCulture в пространстве имен System.Globalization
Свойство System.Threading.Thread.CurrentUICulture	Свойство CultureInfo.CurrentUICulture в пространстве имен System.Globalization
Класс System.Threading.Timer	Класс Windows.System.Threading.ThreadPoolTimer
Класс System.Threading.ThreadPool	Класс Windows.System.Threading.ThreadPool
Код, помещающий задания в очередь в пуле	Task.Run(() => { // work goes here }); Task.Run( Sub() ' work goes here End Sub)
Код, помещающий задания в очередь в пуле и ожидающий их завершения	await Task.Run(() => { // work goes here }); Await Task.Run( Sub() ' work goes here End Sub)
Код, создающий рабочий элемент, который выполняется длительное время	Task.Factory.StartNew(() => { // work goes here }, TaskCreationOptions.LongRunning); Task.Factory.StartNew( Sub() ' work goes here End Sub, TaskCreationOptions.LongRunning)

Изменения отражения

Большинство членов класса System.Type были перемещены в класс System.Reflection.TypeInfo. Объект TypeInfo можно получить, вызвав метод System.Reflection.IntrospectionExtensions.GetTypeInfo(System.Type), который является методом расширения для Type.

Заменить	На
type.Assembly	type.GetTypeInfo().Assembly
type.GetMethods(BindingFlags.DeclaredOnly)	type.GetTypeInfo().DeclaredMethods
type.GetMethod("MethodName", BindingFlags.DeclaredOnly)	type.GetTypeInfo().GetDeclaredMethod("MethodName")
type.GetNestedTypes()	type.GetTypeInfo().DeclaredNestedTypes
Метод System.Delegate.CreateDelegate	Метод MethodInfo.CreateDelegate

Дополнительные сведения см. в разделе Reflection in the .NET Framework for Windows Store Apps в библиотеке MSDN.

Изменения системы безопасности

Многие типы безопасности, аутентификации и операций шифрования доступны через типы Среда выполнения Windows. Полный список пространств имен безопасности, которые доступны для приложений Магазин Windows, см. в списке пространств имен безопасности далее в этом разделе.

Изменения ресурсов

Для приложений Магазин Windows создается один файл ресурсов, вместо модели "звезда", которая использовалась в настольных приложениях. Кроме того, используйте типы ресурсов в пространствах имен Windows.ApplicationModel.Resources и Windows.ApplicationModel.Resources.Core вместо пространства имен System.Resources.

Дополнительные сведения см. в разделе Создание и извлечение ресурсов в приложениях для Магазина Windows.

Изменения исключений

В некоторых случаях управляемый тип создает исключение, которое не входит в Приложения .NET для Магазина Windows. В этих случаях можно перехватить родительский класс исключения, который не включен. Например, в настольном приложении для обработки недопустимого URI перехватывается исключение UriFormatException; однако в приложении Магазин Windows следует перехватывать исключение FormatException, поскольку UriFormatException не включено в Приложения .NET для Магазина Windows. FormatException является родительским классом для UriFormatException.

Изменения WCF

В приложениях Магазин Windows можно с помощью функциональности клиента Windows Communication Foundation (WCF) извлекать данные из службы WCF, но нельзя создать службу WCF для предоставления данных.

Изменения в обычных типах .NET Framework

Заменить	На
Метод System.Xml.XmlConvert.ToDateTime	Метод XmlConvert.ToDateTimeOffset
Интерфейс System.ICloneable	Пользовательский метод, который возвращает соответствующий тип
Методы System.Array.AsReadOnly и System.Collections.Generic.List<T>.AsReadOnly	Новый экземпляр класса ReadOnlyCollection, создаваемый следующим образом: new ReadOnlyCollection<string>(selectedList) New ReadOnlyCollection(Of String)(selectedList)

Методы расширения для преобразования типов

В большинстве случаев приложения Магазин Windows разрабатываются с использованием и типов .NET Framework, и типов Среда выполнения Windows без каких-либо специальных ограничений и преобразований. Однако в некоторых случаях в .NET Framework имеются методы расширения, упрощающие взаимодействие между типами .NET Framework и типами Среда выполнения Windows. Эти методы расширения принадлежат к следующим классам.

• WindowsRuntimeStreamExtensions — для преобразования между управляемыми потоками и потоками в Среда выполнения Windows.

• WindowsRuntimeStorageExtensions — для открытия файлов и папок Среда выполнения Windows как управляемых потоков.

• WindowsRuntimeBufferExtensions — для преобразования в и из IBuffer.

Пространства имен .NET Framework и Среда выполнения Windows

В следующих разделах перечислены пространства имен, предоставляемые в Приложения .NET для Магазина Windows и Среда выполнения Windows, упорядоченные по функциональным возможностям.

Коллекции

• System.Collections

• System.Collections.Concurrent

• System.Collections.Generic

• System.Collections.ObjectModel

• System.Collections.Specialized

• Windows.Foundation.Collections

Ядро

• System

• System.ComponentModel

• System.Dynamic

• System.Numerics

• System.Runtime

• Пространство имен System.Runtime.ExceptionServices

• System.Runtime.InteropServices

• Пространство имен System.Runtime.InteropServices.ComTypes

• System.Runtime.InteropServices.WindowsRuntime

• System.Text

• System.Text.RegularExpressions

• Windows.ApplicationModel

• Windows.ApplicationModel.Activation

• Windows.ApplicationModel.Background

• Windows.ApplicationModel.Core

• Windows.ApplicationModel.Search

• Windows.ApplicationModel.Store

• Windows.Foundation

• Windows.Foundation.Metadata

• Windows.Management.Core

• Windows.Management.Deployment

• Windows.System

• Windows.System.Display

• Windows.System.RemoteDesktop

• Windows.System.UserProfile

• Windows.UI.WebUI

• Windows.UI.Xaml

• Windows.UI.Xaml.Hosting

• Windows.UI.Xaml.Interop

• Windows.UI.Xaml.Markup

Данные и содержимое

• System.ComponentModel.DataAnnotations

• System.ComponentModel.DataAnnotations.Schema

• System.Linq

• System.Linq.Expressions

• System.Runtime.Serialization

• System.Runtime.Serialization.Json

• System.Xml

• System.Xml.Linq

• System.Xml.Schema

• System.Xml.Serialization

• Windows.ApplicationModel.DataTransfer

• Windows.ApplicationModel.DataTransfer.ShareTarget

• Windows.Data.Html

• Windows.Data.Json

• Windows.Data.Xml.Dom

• Windows.Data.Xml.Xsl

• Windows.Web

• Windows.Web.AtomPub

• Windows.Web.Syndication

• Windows.UI.Xaml.Data

• Windows.UI.Xaml.Documents

Устройства

• Windows.Devices.Enumeration

• Windows.Devices.Enumeration.Pnp

• Windows.Devices.Geolocation

• Windows.Devices.Input

• Windows.Devices.Portable

• Windows.Devices.Printers.Extensions

• Windows.Devices.Sensors

• Windows.Devices.Sms

Диагностика

• System.Diagnostics

• System.Diagnostics.CodeAnalysis

• System.Diagnostics.Contracts

• System.Dianostics.Tracing

• Windows.Foundation.Diagnostics

Файлы и папки

• System.IO

• System.IO.Compression

• Windows.Storage

• Windows.Storage.AccessCache

• Windows.Storage.BulkAccess

• Windows.Storage.Compression

• Windows.Storage.FileProperties

• Windows.Storage.Pickers

• Windows.Storage.Pickers.Provider

• Windows.Storage.Provider

• Windows.Storage.Search

• Windows.Storage.Streams

Глобализация

• System.Globalization

• Windows.Globalization

• Windows.Globalization.Collation

• Windows.Globalization.DateTimeFormatting

• Windows.Globalization.Fonts

• Windows.Globalization.NumberFormatting

Графика

• Windows.Graphics.Display

• Windows.Graphics.Imaging

• Windows.UI.Xaml.Media

• Windows.UI.Xaml.Media.Animation

• Windows.UI.Xaml.Media.Imaging

• Windows.UI.Xaml.Shapes

Managed Extensibility Framework (MEF)

Чтобы установить следующие пространства имен, откройте проект в Visual Studio 2012 или более поздней версии, выберите в меню Проект пункт Управление пакетами NuGet и найдите в Интернете пакет Microsoft.Composition.

• System.Composition

• System.Composition.Convention

• System.Composition.Hosting

• System.Composition.Hosting.Core

Мультимедиа

• Windows.Media

• Windows.Media.Capture

• Windows.Media.Devices

• Windows.Media.MediaProperties

• Windows.Media.Playlists

• Windows.Media.PlayTo

• Windows.Media.Protection

• Windows.Media.Transcoding

• Windows.UI.Xaml.Media

Сеть

• System.Net

• System.Net.Http

• System.Net.Http.Headers

• System.Net.NetInformation

• System.ServiceModel

• System.ServiceModel.Channels

• System.ServiceModel.Description

• System.ServiceModel.Dispatcher

• System.ServiceModel.Security

• System.ServiceModel.Security.Tokens

• Windows.Networking

• Windows.Networking.BackgroundTransfer

• Windows.Networking.Connectivity

• Windows.Networking.NetworkOperators

• Windows.Networking.Proximity

• Windows.Networking.PushNotifications

• Windows.Networking.Sockets

Представление

• Windows.UI

• Windows.UI.ApplicationSettings

• Windows.UI.Core

• Windows.UI.Core.AnimationMetrics

• Windows.UI.Notifications

• Windows.UI.Popups

• Windows.UI.StartScreen

• Windows.UI.Text

• Windows.UI.ViewManagement

• Windows.UI.Xaml

• Windows.UI.Xaml.Controls

• Windows.UI.Xaml.Controls.Primitives

• Windows.UI.Xaml.Documents

• Windows.UI.Xaml.Media.Animation

• Windows.UI.Xaml.Media.Media3D

• Windows.UI.Xaml.Navigation

Печать

• Windows.Graphics.Printing

• Windows.Graphics.Printing.OptionDetails

• Windows.UI.Xaml.Printing

Отражение

• System.Reflection

• System.Reflection.Context

• System.Reflection.Emit

Ресурсы

• System.Resources

• Windows.ApplicationModel.Resources

• Windows.ApplicationModel.Resources.Core

• Windows.ApplicationModel.Resources.Management

• Windows.UI.Xaml.Resources

Безопасность

• System.Security

• System.Security.Principal

• Windows.Security.Authentication.OnlineId

• Windows.Security.Authentication.Web

• Windows.Security.Credentials

• Windows.Security.Credentials.UI

• Windows.Security.Cryptography

• Windows.Security.Cryptography.Certificates

• Windows.Security.Cryptography.Core

• Windows.Security.Cryptography.DataProtection

• Windows.Security.ExchangeActiveSyncProvisioning

Социальные функции

• Windows.ApplicationModel.Contacts

• Windows.ApplicationModel.Contacts.Provider

Работа с потоками

• System.Threading

• System.Threading.Tasks

• System.Threading.Tasks.DataFlow

• Windows.System.Threading

• Windows.System.Threading.Core

Автоматизация пользовательского интерфейса

• Windows.UI.Xaml.Automation

• Windows.UI.Xaml.Automation.Peers

• Windows.UI.Xaml.Automation.Provider

• Windows.UI.Xaml.Automation.Text

Взаимодействие с пользователем

• System.Windows.Input

• Windows.UI

• Windows.UI.Input

• Windows.UI.Input.Inking

• Windows.UI.Xaml.Controls.Primitives

• Windows.UI.Xaml.Input

• Windows.UI.Xaml.Media

• Windows.UI.Xaml.Media.Animation

• Windows.UI.Xaml.Media.Media3D

Языки и компиляторы

• Microsoft.CSharp.RuntimeBinder

• Microsoft.VisualBasic

• Microsoft.VisualBasic.CompilerServices

• System.CodeDom.Compiler

• System.Runtime.CompilerServices

• System.Runtime.Versioning

См. также

Основные понятия

Создание компонентов среды выполнения Windows в C# и Visual Basic

Другие ресурсы

.NET for Windows Store apps – supported APIs

Поддержка приложений для Магазина Windows и среды выполнения Windows в .NET Framework