Bibliothèque d’interface utilisateur Windows 3 Preview 3 (novembre 2020)Windows UI Library 3 Preview 3 (November 2020)

La bibliothèque d’interface utilisateur Windows (WinUI) 3 est un framework d’expérience utilisateur natif pour les applications de bureau Windows et UWP.Windows UI Library (WinUI) 3 is a native user experience (UX) framework for both Windows Desktop and UWP apps.

WinUI 3 Preview 3 offre des fonctionnalités nouvelles et améliorées ainsi que des correctifs de bogues importants.WinUI 3 Preview 3 brings both new and improved functionality, along with significant bug fixes.

Consultez Limitations et problèmes connus de la version Preview 3 .See Preview 3 limitations and known issues.

Important

Cette préversion de WinUI 3 est destinée à une évaluation anticipée et à la collecte de commentaires de la communauté des développeurs.This WinUI 3 preview release is intended for early evaluation and to gather feedback from the developer community. Il ne doit PAS être utilisé pour les applications de production.It should NOT be used for production apps.

Nous continuerons de délivrer des préversions de WinUI 3 en 2021, qui seront suivies de la première version officielle.We will continue shipping preview releases of WinUI 3 into 2021, followed by the first official release.

Utilisez le dépôt GitHub WinUI pour fournir des commentaires et journaliser des suggestions et des problèmes.Please use the WinUI GitHub repo to provide feedback and log suggestions and issues.

Installer WinUI 3 Preview 3Install WinUI 3 Preview 3

WinUI 3 Preview 3 inclut des modèles de projet Visual Studio qui vous permettent de générer des applications avec une interface utilisateur basée sur WinUI, et un package NuGet qui contient les bibliothèques WinUI.WinUI 3 Preview 3 includes Visual Studio project templates to help get started building apps with a WinUI-based user interface, and a NuGet package that contains the WinUI libraries. Pour installer WinUI 3 Preview 3, effectuez ces étapes.To install WinUI 3 Preview 3, follow these steps.

Notes

Vous pouvez également cloner et générer la version WinUI 3 Preview 3 de XAML Controls Gallery.You can also clone and build the WinUI 3 Preview 3 version of the XAML Controls Gallery.

  1. Vérifiez que votre ordinateur de développement dispose de Windows 10 version 1803 (build 17134) ou d’une version plus récente.Ensure that your development computer has Windows 10, version 1803 (build 17134), or newer installed.

  2. Installez Visual Studio 2019, version 16.9 PreviewInstall Visual Studio 2019, version 16.9 Preview

    Vous devez inclure les charges de travail suivantes lors de l’installation de Visual Studio :You must include the following workloads when installing Visual Studio:

    • Développement .NET Desktop (installe également .NET 5).NET Desktop Development (this also installs .NET 5)
    • Développement pour la plateforme Windows universelleUniversal Windows Platform development

    Pour générer des applications C++, vous devez également inclure les charges de travail suivantes :To build C++ apps, you must also include the following workloads:

    • Développement Desktop en C++Desktop development with C++
    • Le composant facultatif Outils de plateforme Windows universelle C++ (v142) pour la charge de travail Plateforme Windows universelle (voir « Détails de l’installation » sous la section « Développement pour plateforme Windows universelle », dans le volet de droite)The C++ (v142) Universal Windows Platform tools optional component for the Universal Windows Platform workload (see "Installation Details" under the "Universal Windows Platform development" section, on the right pane)
  3. Assurez-vous que votre système a une source de package NuGet activée pour nuget.org. Pour plus d’informations, consultez Configurations NuGet courantes.Windows Community ToolkitMake sure your system has a NuGet package source enabled for nuget.org. For more information, see Common NuGet configurations.Windows Community Toolkit

  4. Téléchargez et installez le package VSIX WinUI 3 Preview 3.Download and install the WinUI 3 Preview 3 VSIX package. Ceci ajoute à la fois les modèles de projet WinUI 3 et le package NuGet contenant les bibliothèques WinUI 3 à Visual Studio 2019.This adds both the WinUI 3 project templates and the NuGet package containing the WinUI 3 libraries to Visual Studio 2019.

    Pour obtenir des instructions sur la façon d’ajouter le package VSIX à Visual Studio, consultez Recherche et utilisation des extensions Visual Studio.For instructions on how to add the VSIX package to Visual Studio, see Finding and Using Visual Studio Extensions.

Vue web 2WebView2

Si vous utilisez le contrôle WebView2 dans votre application, installez la version Canal Dev du navigateur Microsoft Edge à partir de Microsoft Edge Insider Channels.If you're using the WebView2 control in your app, please install the Dev Channel version of the Microsoft Edge Browser from Microsoft Edge Insider Channels. Veillez à désinstaller toutes les instances existantes de Microsoft Edge Beta, de Microsoft Edge Dev et de Microsoft Edge WebView2 Runtime.Make sure to uninstall any existing instances of Microsoft Edge Beta, Microsoft Edge Dev, and Microsoft Edge WebView2 Runtime.

Windows Community ToolkitWindows Community Toolkit

Si vous utilisez le kit de ressources Communauté Windows, téléchargez la dernière version.If you're using the Windows Community Toolkit, download the latest version.

Créer des projets WinUICreate WinUI projects

Après l’installation du package VSIX WinUI 3 Preview 3, vous êtes prêt à créer un projet en utilisant un des modèles de projet WinUI dans Visual Studio.After installing the WinUI 3 Preview 3 VSIX package, you're ready to create a new project using one of the WinUI project templates in Visual Studio. Pour accéder aux modèles de projet WinUI dans la boîte de dialogue Créer un projet, filtrez le langage sur C++ ou C# , la plateforme sur Windows et le type de projet sur WinUI.To access the WinUI project templates in the Create a new project dialog, filter the language to C++ or C#, the platform to Windows, and the project type to WinUI. Vous pouvez également rechercher WinUI, puis sélectionner l’un des modèles C# ou C++ disponibles.Alternatively, you can search for WinUI and select one of the available C# or C++ templates.

Modèles de projet WinUI

Pour plus d’informations sur la façon de commencer avec les modèles de projet WinUI, consultez les articles suivants :For more information about getting started with the WinUI project templates, see the following articles:

En plus des limitations et les problèmes connus, la génération d’une application à l’aide des projets WinUI est semblable à la génération d’une application UWP avec XAML et WinUI 2.x.Aside from the limitations and known issues, building an app using the WinUI projects is similar to building a UWP app with XAML and WinUI 2.x. Par conséquent, la majeure partie de la documentation d’aide pour les applications UWP et les espaces de noms WinRT Windows.UI figurant dans le SDK Windows est applicable.Therefore, most of the guidance documentation for UWP apps and the Windows.UI WinRT namespaces in the Windows SDK is applicable.

Avec cette version, nous avons également ajouté une documentation de référence de l’API WinUI 3 pour toutes les API WinRT portées sur WinUI 3.With this release, we've also added WinUI 3 API reference documentation for all WinRT APIs ported to WinUI 3.

Si vous avez créé un projet en utilisant WinUI 3 Preview 2, vous pouvez mettre à niveau votre projet pour qu’il utilise Preview 3.If you created a project using WinUI 3 Preview 2, you can upgrade your project to use Preview 3. Pour obtenir des instructions détaillées, consultez le dépôt GitHub WinUI.See the WinUI GitHub repository for detailed instructions.

Modèles de projet pour WinUI 3Project templates for WinUI 3

Vous pouvez utiliser ces modèles de projet WinUI pour créer des applications.You can use these WinUI project templates to create apps.

ModèleTemplate LanguageLanguage DescriptionDescription
Blank App, Packaged (WinUI in Desktop)Blank App, Packaged (WinUI in Desktop) C# et C++C# and C++ Crée une application .NET 5 de bureau (C#) ou Win32 native (C++) avec une interface utilisateur basée sur WinUI.Creates a desktop .NET 5 (C#) or native Win32 (C++) app with a WinUI-based user interface. Le projet généré comprend une fenêtre de base qui dérive de la classe Microsoft.UI.Xaml.Window de la bibliothèque WinUI que vous pouvez utiliser pour commencer à générer votre interface utilisateur.The generated project includes a basic window that derives from the Microsoft.UI.Xaml.Window class in the WinUI library that you can use to start building your UI. Pour plus d’informations sur ce type de projet, consultez Bien démarrer avec WinUI 3 pour les applications de bureau.For more information about this project type, see Get started with WinUI 3 for desktop apps.

La solution inclut également un projet de création de packages d’applications Windows qui est configuré pour générer l’application dans un package MSIX.The solution also includes a Windows Application Packaging Project that is configured to build the app into an MSIX package. Vous bénéficiez ainsi d’une expérience de déploiement moderne, de la possibilité de l’intégrer aux fonctionnalités de Windows 10 par le biais d’extensions de package, et bien plus encore.This provides a modern deployment experience, the ability to integrate with Windows 10 features via package extensions, and much more.
Application vide (WinUI dans UWP)Blank App (WinUI in UWP) C# et C++C# and C++ Crée une application UWP avec une interface utilisateur basée sur WinUI.Creates a UWP app that with a WinUI-based user interface. Le projet généré comprend une page de base qui dérive de la classe Microsoft.UI.Xaml.Controls.Page de la bibliothèque WinUI que vous pouvez utiliser pour commencer à générer votre interface utilisateur.The generated project includes a basic page that derives from the Microsoft.UI.Xaml.Controls.Page class in the WinUI library that you can use to start building your UI. Pour plus d’informations sur ce type de projet, consultez Bien démarrer avec WinUI 3 pour les applications UWP.For more information about this project type, see Get started with WinUI 3 for UWP apps.

Vous pouvez utiliser ces modèles de projet WinUI pour générer des composants qui peuvent être chargés et utilisés par une application basée sur WinUI.You can use these WinUI project templates to build components that can be loaded and used by a WinUI-based app.

ModèleTemplate LanguageLanguage DescriptionDescription
Class Library (WinUI in Desktop)Class Library (WinUI in Desktop) C# uniquementC# only Crée une bibliothèque de classes managées (DLL) .NET 5 en C# qui peut être utilisée par d’autres applications de bureau .NET 5 avec une interface utilisateur basée sur WinUI.Creates a .NET 5 managed class library (DLL) in C# that can be used by other .NET 5 desktop apps with a WinUI-based user interface.
Bibliothèque de classes (WinUI dans UWP)Class Library (WinUI in UWP) C# uniquementC# only Crée une bibliothèque de classes managées (DLL) en C# qui peut être utilisée par d’autres applications UWP avec une interface utilisateur basée sur WinUI.Creates a managed class library (DLL) in C# that can be used by other UWP apps with a WinUI-based user interface.
Composant Windows Runtime (WinUI)Windows Runtime Component (WinUI) C++C++ Crée un composant Windows Runtime écrit en C++/WinRT qui peut être consommé par n’importe quelle application UWP ou de bureau avec une interface utilisateur basée sur WinUI, quel que soit le langage de programmation dans lequel l’application est écrite.Creates a Windows Runtime component written in C++/WinRT that can be consumed by any UWP or Desktop app with a WinUI-based user interface, regardless of the programming language in which the app is written.
Composant Windows Runtime (UWP)Windows Runtime Component (UWP) C#C# Crée un composant Windows Runtime écrit en C# qui peut être consommé par n’importe quelle application UWP avec une interface utilisateur basée sur WinUI, quel que soit le langage de programmation dans lequel l’application est écrite.Creates a Windows Runtime component written in C# that can be consumed by any UWP app with a WinUI-based user interface, regardless of the programming language in which the app is written.

Modèles d’élément pour WinUI 3Item templates for WinUI 3

Les modèles d’élément suivants sont disponibles pour être utilisés dans un projet WinUI.The following item templates are available for use in a WinUI project. Pour accéder à ces modèles d’élément WinUI, cliquez avec le bouton droit sur le nœud du projet dans l’Explorateur de solutions, sélectionnez Ajouter -> Nouvel élément, puis cliquez sur WinUI dans la boîte de dialogue Ajouter un nouvel élément.To access these WinUI item templates, right-click the project node in Solution Explorer, select Add -> New item, and click WinUI in the Add New Item dialog.

Modèles d’élément WinUI

ModèleTemplate LanguageLanguage DescriptionDescription
Page vierge (WinUI)Blank Page (WinUI) C# et C++C# and C++ Ajoute un fichier XAML et un fichier de code qui définit une nouvelle page dérivée de la classe Microsoft.UI.Xaml.Controls.Page de la bibliothèque WinUI.Adds a XAML file and code file that defines a new page derived from the Microsoft.UI.Xaml.Controls.Page class in the WinUI library.
Fenêtre vide (WinUI dans les applications de bureau)Blank Window (WinUI in Desktop) C# et C++C# and C++ Ajoute un fichier XAML et un fichier de code qui définit une nouvelle fenêtre dérivée de la classe Microsoft.UI.Xaml.Window de la bibliothèque WinUI.Adds a XAML file and code file that defines a new window derived from the Microsoft.UI.Xaml.Window class in the WinUI library.
Contrôle personnalisé (WinUI)Custom Control (WinUI) C# et C++C# and C++ Ajoute un fichier de code pour créer un contrôle basé sur un modèle avec un style par défaut.Adds a code file for creating a templated control with a default style. Le contrôle basé sur un modèle est dérivé de la classe Microsoft.UI.Xaml.Controls.Control de la bibliothèque WinUI.The templated control is derived from the Microsoft.UI.Xaml.Controls.Control class in the WinUI library.

Pour obtenir une procédure pas à pas qui montre comment utiliser ce modèle d’élément, consultez Contrôles XAML basés sur un modèle pour les applications UWP et WinUI 3 avec C++/WinRT et Contrôles XAML basés sur un modèle pour les applications WinUI 3 avec C#.For a walkthrough that demonstrates how to use this item template, see Templated XAML controls for UWP and WinUI 3 apps with C++/WinRT and Templated XAML controls for UWP and WinUI 3 apps with C#. Pour plus d’informations sur les contrôles basés sur des modèles, consultez Contrôles XAML personnalisés.For more information about templated controls, see Custom XAML Controls.
Dictionnaire de ressources (WinUI)Resource Dictionary (WinUI) C# et C++C# and C++ Ajouter une collection à clé et vide de ressources XAML.Adds an empty, keyed collection of XAML resources. Pour plus d’informations, consultez Informations de référence sur les ressources ResourceDictionary et XAML.For more information, see ResourceDictionary and XAML resource references.
Fichier de ressources (WinUI)Resources File (WinUI) C# et C++C# and C++ Ajoute un fichier dans lequel stocker les ressources de type chaîne et les ressources conditionnelles de votre application.Adds a file for storing string and conditional resources for your app. Vous pouvez utiliser cet élément pour faciliter la localisation de votre application.You can use this item to help localize your app. Pour plus d’informations, consultez Localiser les chaînes dans l’interface utilisateur et le manifeste du package d’application.For more info, see Localize strings in your UI and app package manifest.
Contrôle utilisateur (WinUI)User Control (WinUI) C# et C++C# and C++ Ajoute un fichier XAML et un fichier de code pour la création d’un contrôle utilisateur dérivé de la classe Microsoft.UI.Xaml.Controls.UserControl de la bibliothèque WinUI.Adds a XAML file and code file for creating a user control that derives from the Microsoft.UI.Xaml.Controls.UserControl class in the WinUI library. En général, un contrôle utilisateur encapsule des contrôles existants associés et fournit sa propre logique.Typically, a user control encapsulates related existing controls and provide its own logic.

Pour plus d’informations sur les contrôles utilisateur, consultez Contrôles XAML personnalisés.For more information about user controls, see Custom XAML Controls.

Support Visual StudioVisual Studio Support

Pour tirer parti des dernières fonctionnalités des outils ajoutées à WinUI 3 Preview 3, comme le rechargement à chaud, l’arborescence d’éléments visuels dynamique et l’Explorateur de propriétés dynamique, vous devez utiliser la dernière préversion de Visual Studio avec la dernière préversion de WinUI 3.In order to take advantage of the latest tooling features added into WinUI 3 Preview 3 like Hot Reload, Live Visual Tree, and Live Property Explorer, you must use the latest preview version of Visual Studio with the latest WinUI 3 preview. Le tableau ci-dessous montre la compatibilité des versions futures avec WinUI 3 Preview 3 :The table below shows the compatibility of future versions with WinUI 3 Preview 3:

Version de Visual StudioVS Version WinUI 3 Preview 3WinUI 3 Preview 3
16.8 RTM16.8 RTM NonNo
Préversions 16.916.9 Previews OuiYes
16.9 RTM16.9 RTM NonNo
Préversions 16.1016.10 Previews OuiYes

Nouvelles fonctionnalités dans Preview 3New features and capabilities in Preview 3

  • Prise en charge d’ARM64ARM64 Support
  • Glisser-déplacer à l’intérieur et à l’extérieur des applicationsDrag and drop inside and outside of apps
  • RenderTargetBitmap (actuellement seulement le contenu XAML - pas le contenu SwapChainPanel)RenderTargetBitmap (currently only XAML content - no SwapChainPanel content)
  • Améliorations apportées à notre expérience des outils/du développement :Improvements to our tooling/developer experience:
    • Arborescence d’éléments visuels dynamique, rechargement à chaud, Explorateur de propriétés dynamique et outils similairesLive Visual Tree, Hot Reload, Live Property Explorer and similar tools
    • IntelliSense fonctionne maintenant pour WinUI 3Intellisense now working for WinUI 3
  • Prise en charge de MRT CoreMRT Core Support
    • Ceci rend les applications plus rapides et plus légères au démarrage, et permet une recherche plus rapide des ressources.This makes apps faster and lighter on startup and provides quicker resource lookup.
  • Prise en charge des curseurs personnalisésCustom cursor support
  • Entrée hors threadOff-thread input
  • Améliorations des performances depuis la version Preview 2Performance improvements since Preview 2
  • Fenêtres multiples dans les applications de bureau - prise en charge améliorée depuis la version Preview 2Multiple windows in Desktop apps - improved support since Preview 2

Nouvelles fonctionnalités introduites dans les préversions passées de WinUI 3New features and capabilities introduced in past WinUI 3 Previews

Les fonctionnalités suivantes ont été introduites dans WinUI 3 Preview 1 & 2 et continuent d’être prises en charge dans WinUI 3 Preview 3.The following features and capabilities were introduced in WinUI 3 Preview 1 & 2 and continue to be supported in WinUI 3 Preview 3.

  • Possibilité de créer des applications de bureau avec WinUI, y compris .NET 5 pour les applications Win32Ability to create Desktop apps with WinUI, including .NET 5 for Win32 apps
  • RadialGradientBrushRadialGradientBrush
  • Mises à jour de TabViewTabView updates
  • Mises à jour de thèmes sombresDark theme updates
  • Améliorations et mises à jour de WebView2Improvements and updates to WebView2
    • Prise en charge des résolutions élevéesSupport for High DPI
    • Prise en charge du redimensionnement et du déplacement de fenêtreSupport for window resizing and moving
    • Mise à jour pour cibler une version plus récente de Microsoft EdgeUpdated to target more recent version of Edge
    • Vous n’avez plus besoin de référencer un package NuGet propre à WebView2No longer necessary to reference a WebView2-specific Nuget package
  • SwapChainPanelSwapChainPanel
  • Améliorations requises pour la migration open sourceImprovements required for open source migration

Pour plus d’informations sur les avantages de WinUI 3 et sur la feuille de route de WinUI, consultez la feuille de route de la bibliothèque d’interface utilisateur Windows sur GitHub.For more information on both the benefits of WinUI 3 and the WinUI roadmap, see the Windows UI Library Roadmap on GitHub.

Fournir des commentaires et des suggestionsProvide feedback and suggestions

Nous serions heureux de recevoir vos commentaires dans le dépôt GitHub WinUI.We welcome your feedback in the WinUI GitHub repo.

Quelles sont les étapes suivantes ?What's coming next?

Consultez notre feuille de route détaillée des fonctionnalités pour voir quand des fonctionnalités spécifiques seront intégrées à WinUI 3.Take a look at our detailed feature roadmap to see when specific features will be brought into WinUI 3.

Limitations et problèmes connus de Preview 3Preview 3 limitations and known issues

La version Preview 3 n’est qu’une préversion.The Preview 3 release is just that, a preview. En particulier, les scénarios concernant les applications de bureau sont nouveaux.The scenarios around Desktop apps are especially new. Attendez-vous à des bogues, des limitations et d’autres problèmes.Please expect bugs, limitations, and other issues.

Voici quelques-uns des problèmes connus avec WinUI 3 Preview 3.The following items are some of the known issues with WinUI 3 Preview 3. Si vous trouvez un problème qui ne figure pas dans la liste ci-dessous, faites-le nous savoir en contribuant à un problème existant ou en consignant un nouveau problème via le dépôt GitHub WinUI.If you find an issue that isn't listed below, please let us know by contributing to an existing issue or filing a new issue through the WinUI GitHub repo.

Prise en charge de plateforme et de système d’exploitationPlatform and OS support

WinUI 3 Preview 3 est compatible avec les PC qui exécutent la mise à jour d’avril 2018 de Windows 10 (version 1803 - build 17134) et les versions ultérieures.WinUI 3 Preview 3 is compatible with PCs running the Windows 10 April 2018 Update (version 1803 - build 17134) and newer.

Outils de développeurDeveloper tools

  • Seules les applications C# et C++/WinRT sont prises en chargeOnly C# and C++/WinRT apps are supported
  • Les applications de bureau prennent en charge .NET 5 et C# 9, et elles doivent être empaquetées dans une application MSIXDesktop apps support .NET 5 and C# 9, and must be packaged in an MSIX app
  • Les applications UWP prennent en charge .NET Native et C# 7.3UWP apps support .NET Native and C# 7.3
  • Les outils de développement et IntelliSense peuvent ne pas fonctionner correctement dans Visual Studio version 16.8.Developer tools and Intellisense may not work properly in Visual Studio version 16.8.
  • Les nouvelles applications C++/CX ne sont pas prises en charge. Toutefois, vos applications existantes continueront à fonctionner (veuillez passer à C++/WinRT dès que possible)New C++/CX apps are not supported, however, your existing apps will continue to function (please move to C++/WinRT as soon as possible)
  • La prise en charge de plusieurs fenêtres dans les applications de bureau est en cours de développement, mais n’est pas encore terminée et stable.Support for multiple windows in Desktop apps is in progress, but not yet complete and stable.
    • Signalez un bogue sur notre dépôt si vous rencontrez de nouveaux problèmes ou des régressions avec le comportement des fenêtres multiples.Please file a bug on our repo if you find new issues or regressions with multi-window behavior.
  • Le déploiement d’appareils de bureau sans package n’est pas pris en chargeUnpackaged desktop deployment is not supported
  • Lors de l’exécution d’une application de bureau avec F5, vérifiez que vous exécutez le projet d’empaquetage.When running a Desktop app using F5, make sure that you are running the packaging project. Si vous utilisez F5 sur le projet d’application, vous allez exécuter une application non empaquetée, que WinUI 3 ne prend pas encore en charge.Hitting F5 on the app project will run an unpackaged app, which WinUI 3 does not yet support.

Fonctionnalités de plateforme manquantesMissing Platform Features

  • Support XboxXbox support
  • Support HoloLensHoloLens support
  • Fenêtres contextuellesWindowed popups
    • Plus spécifiquement, la propriété ShouldConstrainToRootBounds agit toujours comme si elle était définie sur true, quelle que soit la valeur de la propriété.More specifically, the ShouldConstrainToRootBounds property always acts as if it's set to true, regardless of the property value.
  • Prise en charge des entrées manuscritesInking support
  • AcryliqueAcrylic
  • MediaElement et MediaPlayerElementMediaElement and MediaPlayerElement
  • MapControlMapControl
  • RenderTargetBitmap pour SwapChainPanel et contenu non-XAMLRenderTargetBitmap for SwapChainPanel and non-XAML content
  • SwapChainPanel ne prend pas en charge la transparenceSwapChainPanel does not support transparency
  • Global Reveal utilise le comportement de secours, un pinceau pleinGlobal Reveal uses fallback behavior, a solid brush
  • XAML Islands n’est pas pris en charge dans cette versionXAML Islands is not supported in this release
  • Les bibliothèques d’écosystèmes tiers ne fonctionneront pas complètement3rd party ecosystem libraries will not fully function
  • Les éditeurs IME ne fonctionnent pasIMEs do not work

Problèmes connusKnown issues

  • Alt+F4 ne ferme pas les fenêtres des applications de bureau.Alt+F4 does not close Desktop app windows.

  • Si vous utilisez une WebView2 dans votre application, mais qu’elle n’est pas rendue ou chargée, il se peut que vous exécutiez une version incompatible du navigateur Edge.If you’re using a WebView2 in your app but it is not rendering or loading, you may be running an incompatible version of the Edge browser. Téléchargez la version Dev Channel de Microsoft Edge et veillez à désinstaller toutes les instances existantes de Microsoft Edge Beta, de Microsoft Edge Dev et de Microsoft Edge WebView2 Runtime.Download the Dev channel of Microsoft Edge and be sure to uninstall any existing instances of Microsoft Edge Beta, Microsoft Edge Dev, and Microsoft Edge WebView2 Runtime.

  • Les fonctions de marshaling ne doivent pas être utilisées dans les applications WinUI .NET 5, car elles n’interagissent pas correctement avec C#/WinRT.Marshal functions should not be used in .NET 5 WinUI apps as they do not interoperate correctly with C#/WinRT. Pour plus d’informations, consultez cette page.For more details, see this page.

  • Si vous subissez un plantage en définissant une propriété d’URI, par exemple en utilisant un {Binding} dans le balisage XAML, vous pouvez contourner ce problème en utilisant {x:Bind} ou une préversion de C#/WinRT.If you experience a crash setting a URI property, for example using a {Binding} in Xaml markup, you can work around it by using {x:Bind}, or by using a preview version of C#/WinRT. Pour ce faire, ajoutez les lignes suivantes à votre fichier .csproj :To do this, add the following lines to your .csproj file:

    <ItemGroup>
      <FrameworkReference Update="Microsoft.Windows.SDK.NET.Ref" 
                          RuntimeFrameworkVersion="10.0.18362.11-preview" />
      <FrameworkReference Update="Microsoft.Windows.SDK.NET.Ref" 
                          TargetingPackVersion="10.0.18362.11-preview" />
    </ItemGroup>
    
  • Pour les applications UWP C# :For C# UWP apps:

    L’environnement WinUI 3 est un ensemble de composants WinRT qui peuvent être utilisés à partir de C++ (avec C++/WinRT) ou C# .The WinUI 3 framework is a set of WinRT components which can be used from C++ (using C++/WinRT) or C#. Pour C#, il existe deux versions de .NET, en fonction du modèle d’application : lors de l’utilisation de WinUI 3 dans une application UWP, vous utilisez .NET Native ; lors de l’utilisation dans une application de bureau, vous utilisez .NET 5 (et C#/WinRT).When using C#, there are two versions of .NET, depending on the app model: when using WinUI 3 in a UWP app you’re using .NET Native; when using in a Desktop app you’re using .NET 5 (and C#/WinRT).

    Lors de l’utilisation de C# pour une application WinUI 3 dans UWP, il y a quelques différences dans les espaces de noms de l’API par rapport à C# dans une application de bureau WinUI 3 ou une application WinUI 2 C# : certains types se trouvent dans un espace de noms Microsoft au lieu d’un espace de noms System.When using C# for a WinUI 3 app in UWP, there are a few API namespace differences compared to C# in a WinUI 3 Desktop app or a C# WinUI 2 app: some types are in a Microsoft namespace rather than a System namespace. Par exemple, l’interface INotifyPropertyChanged n’est pas dans l’espace de noms System.ComponentModel, mais se trouve dans l’espace de noms Microsoft.UI.Xaml.Data.For example, rather than the INotifyPropertyChanged interface being in the System.ComponentModel namespace, it’s in the Microsoft.UI.Xaml.Data namespace.

    Cela s’applique aux :This applies to:

    • INotifyPropertyChanged (et types associés)INotifyPropertyChanged (and related types)
    • INotifyCollectionChanged
    • ICommand

    Les versions de l’espace de noms System existent toujours, mais ne peuvent pas être utilisées avec WinUI 3.The System namespace versions still exist, but cannot be used with WinUI 3. Cela signifie que ObservableCollection ne fonctionne pas en l’état dans les applications UWP C# WinUI 3.This means that ObservableCollection doesn't work as-is in WinUI 3 C# UWP apps. Pour une solution de contournement, consultez l’exemple CollectionsInterop dans l’exemple XAML Controls Gallery.For a workaround, see the CollectionsInterop sample in the XAML Controls Gallery sample.

Consultez la branche WinUI 3 Preview 3 de la galerie de contrôles XAML pour obtenir un exemple d’application qui inclut l’ensemble des contrôles et des fonctionnalités de WinUI 3 Preview 3.See the WinUI 3 Preview 3 branch of the XAML Controls Gallery for a sample app that includes all WinUI 3 Preview 3 controls and features.

Application XAML Controls Gallery WinUI 3 Preview 3WinUI 3 Preview 3 XAML Controls Gallery app
Exemple de l’application XAML Controls Gallery WinUI 3 Preview 3Example of the WinUI 3 Preview 3 XAML Controls Gallery app

Pour télécharger l’exemple, clonez la branche winui3preview à l’aide de la commande suivante :To download the sample, clone the winui3preview branch using the following command:

git clone --single-branch --branch winui3preview https://github.com/microsoft/Xaml-Controls-Gallery.git

Après le clonage, veillez à basculer vers la branche winui3preview dans votre environnement Git local :After cloning, ensure that you switch to the winui3preview branch in your local Git environment:

git checkout winui3preview