Behandeln von Problemen beim Portieren von Windows Phone Silverlight zu UWP

Im vorherigen Thema ging es um das Portieren des Projekts.

Wir empfehlen dringend, dieses Handbuch für das Portieren vollständig zu lesen. Wir wissen aber auch, dass Sie möglichst schnell die Phase erreichen möchten, in der Ihr Projekt erstellt und ausgeführt wird. Zu diesem Zweck können Sie einen temporären Fortschritt erzielen, indem Sie allen nicht unbedingt erforderlichen Code auskommentieren und anschließend zurückkehren, um die Schulden später zu bezahlen. Die Tabelle mit Symptomen und Möglichkeiten zur Problembehandlung in diesem Thema kann in dieser Phase hilfreich für Sie sein, ersetzt jedoch nicht das Lesen der nächsten Themen. Sie können die Tabelle jederzeit zu Rate ziehen, während Sie die weiteren Themen lesen.

Ermitteln von Problemen

XAML-Analyseausnahmen sind u U. schwierig zu diagnostizieren, insbesondere wenn keine sinnvollen Fehlermeldungen innerhalb der Ausnahme vorhanden sind. Stellen Sie sicher, dass der Debugger für die Erfassung von Ausnahmen (erste Chance) konfiguriert ist (um die Analyseausnahme möglichst früh zu erfassen). Möglicherweise können Sie die Ausnahmevariable im Debugger überprüfen, um zu ermitteln, ob das HRESULT oder die Meldung hilfreiche Informationen enthält. Überprüfen Sie auch das Visual Studio-Ausgabefenster auf Fehlermeldungen des XAML-Parsers.

Wenn Ihre App beendet wird und Sie nur wissen, dass während der XAML-Markupanalyse ein Ausnahmefehler ausgelöst wurde, ist die Ursache möglicherweise ein Verweis auf eine fehlende Ressource (d. h. eine Ressource, deren Schlüssel für Windows Phone Silverlight-Apps, jedoch nicht für Windows 10-Apps vorhanden ist, z. B. einige System-TextBlock-Stilschlüssel). Oder es kann sich um eine Ausnahme handeln, die innerhalb eines UserControl-Steuerelements, eines benutzerdefinierten Steuerelements oder eines benutzerdefinierten Layoutbereichs ausgelöst wird.

Als letzte Möglichkeit kann eine Binärdatei aufgeteilt werden. Entfernen Sie etwa die Hälfte des Markups von einer Seite, und führen Sie die App erneut aus. Sie wissen dann, ob sich der Fehler in der Hälfte befindet, die Sie entfernt haben (die Sie nun auf jeden Fall wiederherstellen sollten) oder ob sich der Fehler in der Hälfte befindet, die Sie nicht entfernt haben. Wiederholen Sie den Vorgang durch Teilen der Hälfte mit den Fehler solange, Sie das Problem eingegrenzt haben.

TargetPlatformVersion

In diesem Abschnitt wird erläutert, was zu tun ist, wenn beim Öffnen eines Windows 10-Projekts in Visual Studio folgende Meldung angezeigt wird: „Visual Studio-Update erforderlich. Mindestens ein Projekt erfordert ein Plattform-SDK (<version>), das entweder nicht installiert oder in einem zukünftigen Update von Visual Studio enthalten ist.“

• Ermitteln Sie zunächst die Versionsnummer des SDK für Windows 10, die Sie installiert haben. Navigieren Sie zu C:\Programme (x86)\Windows Kits\10\Include\<versionfoldername> , und notieren Sie <sich versionfoldername>, der sich in der Vierfachnotation "Major.Minor.Build.Revision" befindet.
• Öffnen Sie Ihre Projektdatei zur Bearbeitung, und suchen Sie das TargetPlatformVersion-Element und das TargetPlatformMinVersion-Element. Bearbeiten Sie sie so, dass sie wie folgt aussehen, und <ersetzen Sie versionsordnername> durch die Versionsnummer der Vierfach-Notation, die Sie auf dem Datenträger gefunden haben:

   <TargetPlatformVersion><versionfoldername></TargetPlatformVersion>
   <TargetPlatformMinVersion><versionfoldername></TargetPlatformMinVersion>

Symptome und Möglichkeiten zur Problembehandlung

Die Lösungsinformationen in der Tabelle sollten ausreichen, um Ihr Problem selbst zu behandeln. Weitere Details zu den einzelnen Problemen finden Sie in den späteren Themen.

Symptom	Problembehandlung
Der XAML-Parser oder -Compiler meldet den Fehler „Der Name „<typename>“ ist im Namespace „[…]“ nicht vorhanden“.	Wenn <typename> ein benutzerdefinierter Typ ist, ändern Sie in Ihren Namespace-Präfixdeklarationen im XAML-Markup „clr-namespace“ in „using“, und entfernen Sie alle Assemblytoken. Für Plattformtypen bedeutet dies, dass der Typ nicht für die Universelle Windows-Plattform (UWP) gilt. Suchen Sie also nach der Entsprechung, und aktualisieren Sie Ihr Markup damit. Die Beispiele phone:PhoneApplicationPage und shell:SystemTray.IsVisible können sofort auftreten.
Der XAML-Parser oder Compiler gibt den Fehler "Der Membername<> wird nicht erkannt oder ist nicht zugänglich" oder "Die Eigenschaft "<propertyname>" wurde nicht im Typ [...]gefunden.	Diese Fehler werden angezeigt, nachdem Sie einige Typnamen portiert haben, z. B. das Page-Stammelement. Der Member oder die Eigenschaft gilt nicht für die UWP. Suchen Sie also nach der Entsprechung, und aktualisieren Sie Ihr Markup damit. Die Beispiele SupportedOrientations und Orientation können sofort auftreten.
Der XAML-Parser oder -Compiler gibt folgenden Fehler aus: „Die anfügbare Eigenschaft [...] wurde nicht gefunden [...].“ oder „Unbekannter anfügbarer Member [...].“.	Dies wird wahrscheinlich durch den Typ und nicht durch die angefügte Eigenschaft verursacht; in diesem Fall tritt bereits ein Fehler für diesen Typ auf, der verschwindet, sobald sie ihn behoben haben. Die Beispiele phone:PhoneApplicationPage.Resources und phone:PhoneApplicationPage.DataContext können sofort auftreten.
Der XAML-Parser bzw. -Compiler oder eine Laufzeitausnahme meldet den Fehler „Die Ressource „<resourcekey>“ konnte nicht aufgelöst werden“.	Der Ressourcenschlüssel gilt nicht für UWP (Universelle Windows-Plattform)-Apps. Suchen Sie nach dem richtigen äquivalenten Ressourcenobjekt, und aktualisieren Sie Ihr Markup. System-TextBlock-Stilschlüssel wie PhoneTextNormalStyle können sofort auftreten.
Der C#-Compiler gibt folgenden Fehler aus: „Der Typ- oder Namespacename „<name>“ konnte nicht gefunden werden […]“ oder „Der Typ- oder Namespacename „<name>“ ist im Namespace […] nicht vorhanden“ oder „Der Typ- oder Namespacename „<name>“ ist im aktuellen Kontext nicht vorhanden“.	Dies bedeutet wahrscheinlich, dass der Compiler den richtigen UWP-Namespace für einen Typ noch nicht kennt. Sie können den Visual Studio-Befehl Auflösen verwenden, um dieses Problem zu beheben. Wenn die API nicht in der Gruppe der APIs enthalten ist, die als Familie der universellen Geräte bezeichnet wird (die API also in einem Erweiterungs-SDK implementiert ist), verwenden Sie die Erweiterungs-SDKs. Es kann andere Fälle geben, in denen das Portieren weniger einfach ist. Die Beispiele DesignerProperties und BitmapImage können sofort auftreten.
Wenn sie auf dem Gerät ausgeführt wird, wird die App beendet, oder beim Starten von Visual Studio wird der Fehler "Windows-Runtime 8.x-App kann nicht aktiviert werden [...] angezeigt. Fehler bei der Aktivierungsanforderung: „Windows konnte nicht mit der Zielanwendung kommunizieren.“ Dies weist in der Regel darauf hin, dass der Prozess der Zielanwendung abgebrochen wurde. […]”.	Das Problem ist möglicherweise der imperative Code, der während der Initialisierung auf Ihren eigenen Seiten oder in gebundenen Eigenschaften (oder anderen Typen) ausgeführt wird. Es könnte auch beim Analysieren der XAML-Datei passieren, die angezeigt wird, wenn die App beendet wird (beim Starten in Visual Studio ist dies die Startseite). Suchen Sie nach ungültigen Ressourcenschlüsseln, und/oder probieren Sie einige der Anleitungen im Abschnitt Nachverfolgung von Problemen in diesem Thema aus.
XamlCompiler-Fehler WMC0055: Textwert "<Ihre Streamgeometrie>" kann der Eigenschaft "Clip" vom Typ "RectangleGeometry" nicht zugewiesen werden	In der UWP der Typ der UWP-App mit Microsoft DirectX XAML und C++.
XamlCompiler-Fehler WMC0001: Unbekannter Typ „RadialGradientBrush“ im XML-Namespace [...]	Die UWP verfügt nicht über den RadialGradientBrush-Typ. Entfernen Sie das RadialGradientBrush-Element aus dem Markup, und verwenden Sie einen anderen Typ von UWP-App mit Microsoft DirectX, XAML und C++.
XamlCompiler-Fehler WMC0011: Unbekanntes Element "OpacityMask" für element "<UIElement type>"	Die UWP-App Microsoft DirectX und XAML C++ UWP.
Eine Ausnahme (erste Chance) vom Typ „System.Runtime.InteropServices.COMException“ ist in SYSTEM.NI.DLL aufgetreten. Weitere Informationen: Die Anwendung rief eine Schnittstelle auf, die für einen anderen Thread der Anwendung aufgerufen wurde. (Ausnahme von HRESULT: 0x8001010E (RPC_E_WRONG_THREAD)).	Die Schritte, die Sie gerade ausführen, müssen im UI-Thread ausgeführt werden. Rufen Sie den CoreWindow.GetForCurrentThread) auf.
Eine Animation wird ausgeführt, hat jedoch keine Auswirkungen auf ihre Zieleigenschaft.	Gestalten Sie die Animation unabhängig, oder legen Sie EnableDependentAnimation="True" dafür fest. Weitere Informationen finden Sie unter Animation.
Beim Öffnen eines Windows 10-Projekts in Visual Studio wird folgende Meldung angezeigt: „Visual Studio-Update erforderlich. Mindestens ein Projekt erfordert ein Plattform-SDK (<version>), das entweder nicht installiert oder in einem zukünftigen Update von Visual Studio enthalten ist.“	Weitere Informationen finden Sie im Abschnitt TargetPlatformVersion in diesem Thema.
Wenn in einer XAML.CS-Datei „InitializeComponent“ aufgerufen wird, wird eine „System.InvalidCastException“ ausgelöst.	Dies kann passieren, wenn mehrere XAML-Dateien (mindestens eine davon MRT-qualifiziert) dieselbe XAML.CS-Datei verwenden und Elemente x:Name-Attribute aufweisen, die zwischen den beiden XAML-Dateien inkonsistent sind. Versuchen Sie, den gleichen Elementen in XAML-Dateien denselben Namen hinzuzufügen, oder lassen Sie Namen ganz weg.

Das nächste Thema ist Portieren von XAML und UI.