Обзор приложений .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;

• типы и члены, которые обеспечивают оболочку для функций операционной системы (например, System.Diagnostics.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 для Магазина Windows — поддерживаемые API.

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

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

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

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

• Пространства имен .NET Framework и среды выполнения 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

Дополнительные сведения см. в разделе Данные приложений.

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

Заменить	На
Класс System.Net.WebClient	Класс System.Net.Http.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

Дополнительные сведения см. в разделе Отражение в .NET Framework для приложений для Магазина Windows в библиотеке 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	Новый экземпляр класса System.Collections.ObjectModel.ReadOnlyCollection<T>, создаваемый следующим образом: new ReadOnlyCollection<string>(selectedList) New ReadOnlyCollection(Of String)(selectedList)

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

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

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

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

• System.Runtime.InteropServices.WindowsRuntime.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.Compresion

• 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

См. также

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

Приложения .NET для Магазина Windows — поддерживаемые API

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

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

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