.NET für Windows Store-Apps – Übersicht

.NET Framework enthält eine Teilmenge verwalteter Typen, mit denen Sie Windows Store-Apps mit C# oder Visual Basic erstellen können. Diese Teilmenge verwalteter Typen wird als .NET für Windows Store-Apps bezeichnet und ermöglicht .NET Framework-Entwicklern, Windows Store-Apps innerhalb einer vertrauten Programmierumgebung zu erstellen. Typen, die nicht mit der Entwicklung von Windows Store-Apps verknüpft sind, sind in dieser Teilmenge nicht enthalten.

Sie verwenden diese verwalteten Typen mit Typen aus der Windows-Runtime-API, um Windows Store-Apps zu erstellen. In der Regel werden Sie keine Unterschiede zwischen der Verwendung verwalteter Typen und der Verwendung der Windows-Runtime-Typen feststellen, außer dass die verwalteten Typen innerhalb von Namespaces verbleiben, die mit System beginnen, und die Windows-Runtime-Typen innerhalb von Namespaces, die mit Windows beginnen. Zusammen bieten .NET für Windows Store-Apps und Windows-Runtime den vollständigen Satz von Typen und Membern, die zum Entwickeln von Windows Store-Apps mit C# oder Visual Basic verfügbar sind.

Beim Design der Teilmenge von verwalteten Typen und Membern wurde der Fokus klar auf die Windows Store-App-Entwicklung gesetzt. Deshalb wurde Folgendes ausgelassen:

• Typen und Member, die sich nicht für die Entwicklung von Windows Store-Apps eignen (beispielsweise Konsolen- und ASP.NET-Typen).

• Veraltete Typen

• Typen, die sich mit Windows-Runtime-Typen überschneiden.

• Typen und Member, die Betriebssystemfunktionen umschließen (beispielsweise System.Diagnostics.EventLog und Leistungsindikatoren).

• Member, die zu Verwirrung führen (wie die Close-Methode auf E/A-Typen).

In einigen Fällen ist ein Typ, der in einer .NET Framework-Desktop-App verwendet wird, in .NET für Windows Store-Apps nicht vorhanden. Stattdessen können Sie einen Typ aus der Windows-Runtime verwenden. Beispielsweise ist die System.IO.IsolatedStorage.IsolatedStorageSettings-Klasse nicht in .NET für Windows Store-Apps enthalten, aber die Windows.Storage.ApplicationDataContainer-Klasse bietet ein ähnliches Verhalten beim Speichern von App-Einstellungen. Beispiele für allgemeine Änderungen, die Sie möglicherweise vornehmen müssen, sind im Abschnitt Konvertieren von vorhandenem .NET Framework-Code enthalten.

Der gesamte Satz von Assemblys für .NET für Windows Store-Apps wird automatisch in Ihrem Projekt referenziert, wenn Sie eine Windows Store-App mit C# oder Visual Basic erstellen. Daher können Sie alle Typen verwenden, die von .NET für Windows Store-Apps in Ihrem Projekt unterstützt werden, ohne zusätzliche Aktionen durchführen zu müssen. Eine Liste der kombinierten Namespaces, die von .NET für Windows Store-Apps und Windows-Runtime bereitgestellt werden (gruppiert nach Funktionsbereich), finden Sie im Abschnitt .NET Framework- und Windows Runtime-Namespaces.

Eine Liste der Namespaces und Typen, die in der .NET Framework-Teilmenge enthalten sind, finden Sie unter .NET für Windows Store-Apps – unterstützte APIs.

Sie können auch ein Portable Klassenbibliothek-Projekt erstellen, um eine .NET Framework-Bibliothek zu entwickeln, die von einer Windows Store-App verwendet werden kann. Das Projekt muss .NET für Windows Store-Apps als eine der Zielplattformen enthalten. Eine Portable Klassenbibliothek ist besonders nützlich, wenn Sie Klassen entwickeln möchten, die von Apps für verschiedene Plattformtypen, beispielsweise einer Windows Phone-App, einer Desktop-App und einer Windows Store-App verwendet werden können. Weitere Informationen erhalten Sie unter Portable Klassenbibliotheks-Übersicht.

Dieses Thema enthält die folgenden Abschnitte:

• Konvertieren von vorhandenem .NET Framework-Code

• Erweiterungsmethoden zum Konvertieren von Typen

• .NET Framework- und Windows Runtime-Namespaces

Konvertieren von vorhandenem .NET Framework-Code

In der Regel konvertieren Sie nicht einfach eine vorhandene .NET Framework-App in eine Windows Store-App, sondern entwerfen die .NET Framework-App für eine bessere Benutzerfreundlichkeit neu. Allerdings ist es auch möglich, dass Sie nur Teile einer vorhandenen .NET Framework-App für eine Verwendung in einer neuen Windows Store-App konvertieren. Beim Konvertieren von vorhandenem .NET Framework-Code sollten Sie die folgenden Änderungen beachten, die Sie möglicherweise in der Windows Store-App vornehmen müssen:

• Änderungen der Benutzeroberfläche

• E/A-Änderungen

• Speicheränderungen

• Netzwerkänderungen

• Threadingänderungen

• Reflektionsänderungen

• Sicherheitsänderungen

• Ressourcenänderungen

• Ausnahmeänderungen

• WCF-Änderungen

• Änderungen an allgemeinen .NET Framework-Typen

Änderungen der Benutzeroberfläche

Wenn Sie Benutzeroberflächencode aus einer Silverlight-basierten Anwendung oder Windows Phone-App konvertieren, können Sie oftmals die gleichen Benutzeroberflächentypen verwenden. Die Typen befinden sich jetzt jedoch in den Windows.UI.Xaml-Namespaces und nicht in den System.Windows-Namespaces. Diese neuen Benutzeroberflächentypen ähneln den vorherigen Benutzeroberflächentypen von .NET Framework, allerdings enthalten sie einige andere Member.

Weitere Informationen zum Portieren von Benutzeroberflächencode finden Sie unter Migrieren einer Windows Phone 7-App zu XAML.

E/A-Änderungen

Die E/A-Typen enthalten neue Member, um das neue await-Schlüsselwort im asynchronen Programmiermodell zu unterstützen.

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

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

Speicheränderungen

Anstatt die System.IO.IsolatedStorage-Klasse zu verwenden, verwenden Sie die Typen in den Windows.Storage-Namespaces, um lokale Daten und Dateien zu speichern.

ApplicationData.Current.LocalFolder

ApplicationData.Current.LocalSettings

Weitere Informationen finden Sie unter Anwendungsdaten.

Netzwerkänderungen

Threadingänderungen

Einige der Threadingmember von .NET Framework haben sich geändert, und einige Typen sind nun in der Windows-Runtime-API verfügbar.

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)

Reflektionsänderungen

Die meisten Member aus der System.Type-Klasse wurden in die System.Reflection.TypeInfo-Klasse verschoben. Sie können das TypeInfo-Objekt abrufen, indem Sie die System.Reflection.IntrospectionExtensions.GetTypeInfo(System.Type)-Methode aufrufen. Diese Methode ist eine Erweiterungsmethode für Type.

Weitere Informationen finden Sie unter Reflektion in .NET Framework für Windows Store-Apps in der MSDN Library.

Sicherheitsänderungen

Viele der Typen für Sicherheits-, Authentifizierungs- und Kryptografievorgänge sind über Windows-Runtime-Typen verfügbar. Eine vollständige Liste der Sicherheitsnamespaces, die für Windows Store-Apps verfügbar sind, finden Sie in der Sicherheitsnamespace-Liste weiter unten in diesem Thema.

Ressourcenänderungen

Für Windows Store-Apps erstellen Sie eine einzelne Ressourcendatei anstelle des Nabe und Speiche-Modells, das in Desktop-Apps verwendet wird. Außerdem verwenden Sie die Ressourcentypen aus den Windows.ApplicationModel.Resources- und Windows.ApplicationModel.Resources.Core-Namespaces und nicht aus dem System.Resources-Namespace.

Weitere Informationen finden Sie unter Erstellen und Abrufen von Ressourcen in Windows Store-Apps.

Ausnahmeänderungen

In einigen Fällen löst ein verwalteter Typ eine Ausnahme aus, die nicht in .NET für Windows Store-Apps enthalten ist. In diesen Fällen können Sie die übergeordnete Klasse der Ausnahme abfangen, die nicht enthalten ist. In einer Desktop-App fangen Sie die UriFormatException-Ausnahme beispielsweise ab, um einen ungültigen URI zu bearbeiten. In einer App im Windows Store wird die FormatException-Ausnahme hingegen abgefangen, da UriFormatException nicht in .NET für Windows Store-Apps enthalten ist. FormatException ist die übergeordnete Klasse von UriFormatException.

WCF-Änderungen

In Windows Store-Apps können Sie die Clientfunktionen der Windows Communication Foundation (WCF) nutzen, um Daten von einem WCF-Dienst abzurufen, aber Sie können keinen WCF-Dienst erstellen, um Daten bereitzustellen.

Änderungen an allgemeinen .NET Framework-Typen

new ReadOnlyCollection<string>(selectedList)

New ReadOnlyCollection(Of String)(selectedList)

Erweiterungsmethoden zum Konvertieren von Typen

In den meisten Fällen entwickeln Sie Windows Store-Apps mit .NET Framework-Typen und Windows-Runtime-Typen ohne besondere Berücksichtigung oder Konvertierung. In einigen Fällen aber stellt .NET Framework Erweiterungsmethoden bereit, um die Interaktion zwischen .NET Framework-Typen und Windows-Runtime-Typen zu vereinfachen. Diese Erweiterungsmethoden finden sich in folgenden Klassen:

• System.IO.WindowsRuntimeStreamExtensions – zum Konvertieren zwischen verwalteten Streams und Windows-Runtime-Streams.

• System.IO.WindowsRuntimeStorageExtensions – zum Öffnen von Windows-Runtime-Dateien und -Ordnern als verwaltete Streams.

• System.Runtime.InteropServices.WindowsRuntime.WindowsRuntimeBufferExtensions – zum Konvertieren in und von IBuffer.

.NET Framework- und Windows-Runtime-Namespaces

In den folgenden Abschnitten sind die Namespaces nach Funktionen aufgelistet, die in .NET für Windows Store-Apps und Windows-Runtime bereitgestellt werden.

Auflistungen

• System.Collections

• System.Collections.Concurrent

• System.Collections.Generic

• System.Collections.ObjectModel

• System.Collections.Specialized

• Windows.Foundation.Collections

Kern

• 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

Daten und Inhalt

• 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

Geräte

• 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

Diagnose

• System.Diagnostics

• System.Diagnostics.CodeAnalysis

• System.Diagnostics.Contracts

• System.Dianostics.Tracing

• Windows.Foundation.Diagnostics

Dateien und Ordner

• 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

Globalisierung

• System.Globalization

• Windows.Globalization

• Windows.Globalization.Collation

• Windows.Globalization.DateTimeFormatting

• Windows.Globalization.Fonts

• Windows.Globalization.NumberFormatting

Grafik

• 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)

Zum Installieren der folgenden Namespaces öffnen Sie das Projekt in Visual Studio 2012, und wählen Sie NuGet-Pakete verwalten aus dem Menü Projekt. Suchen Sie anschließend online nach dem Microsoft.Composition-Paket.

• System.Composition

• System.Composition.Convention

• System.Composition.Hosting

• System.Composition.Hosting.Core

Medien

• 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

Netzwerk

• 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

Präsentation

• 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

Drucken

• Windows.Graphics.Printing

• Windows.Graphics.Printing.OptionDetails

• Windows.UI.Xaml.Printing

Reflektion

• System.Reflection

• System.Reflection.Context

• System.Reflection.Emit

Ressourcen

• System.Resources

• Windows.ApplicationModel.Resources

• Windows.ApplicationModel.Resources.Core

• Windows.ApplicationModel.Resources.Management

• Windows.UI.Xaml.Resources

Sicherheit

• 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

Soziales Netzwerk

• Windows.ApplicationModel.Contacts

• Windows.ApplicationModel.Contacts.Provider

Threading

• System.Threading

• System.Threading.Tasks

• System.Threading.Tasks.DataFlow

• Windows.System.Threading

• Windows.System.Threading.Core

Benutzeroberflächenautomatisierung

• Windows.UI.Xaml.Automation

• Windows.UI.Xaml.Automation.Peers

• Windows.UI.Xaml.Automation.Provider

• Windows.UI.Xaml.Automation.Text

Benutzerinteraktion

• 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

Sprachen und Compiler

• Microsoft.CSharp.RuntimeBinder

• Microsoft.VisualBasic

• Microsoft.VisualBasic.CompilerServices

• System.CodeDom.Compiler

• System.Runtime.CompilerServices

• System.Runtime.Versioning

Siehe auch

Konzepte

.NET für Windows Store-Apps – unterstützte APIs

Erstellen von Windows-Runtime-Komponenten in C# und Visual Basic

Weitere Ressourcen

.NET Framework-Unterstützung für Windows Store-Apps und Windows-Runtime