Hospedar controles XAML do UWP em aplicativos da área de trabalho (Ilhas XAML)Host UWP XAML controls in desktop apps (XAML Islands)

No Windows 10 em diante, versão 1903, você pode hospedar controles UWP em aplicativos da área de trabalho que não sejam UWP usando um recurso chamado Ilhas XAML.Starting in Windows 10, version 1903, you can host UWP controls in non-UWP desktop applications using a feature called XAML Islands. Esse recurso permite que você aprimore a aparência e a funcionalidade de seus aplicativos WPF, C++ Win32 e do Windows Forms existentes, com os recursos mais recentes de interface do usuário do Windows 10 que só estão disponíveis por meio dos controles UWP.This feature enables you to enhance the look, feel, and functionality of your existing WPF, Windows Forms, and C++ Win32 applications with the latest Windows 10 UI features that are only available via UWP controls. Isso significa que você pode usar recursos do UWP, como o Windows Ink, e controles que dão suporte ao Sistema Fluent Design em seus aplicativos WPF, Windows Forms e C++ Win32 existentes.This means that you can use UWP features such as Windows Ink and controls that support the Fluent Design System in your existing WPF, Windows Forms, and C++ Win32 applications.

Você pode hospedar qualquer controle UWP derivado de Windows.UI.Xaml.UIElement, incluindo:You can host any UWP control that derives from Windows.UI.Xaml.UIElement, including:

  • Qualquer controle UWP interno fornecido pelo SDK do Windows.Any first-party UWP control provided by the Windows SDK.
  • Qualquer controle UWP personalizado (por exemplo, um controle de usuário que consiste em vários controles UWP que funcionam juntos).Any custom UWP control (for example, a user control that consists of several UWP controls that work together). É necessário ter o código-fonte do controle personalizado para compilá-lo com o aplicativo.You must have the source code for the custom control so you can compile it with your application.

Fundamentalmente, as Ilhas XAML são criadas com a API de hospedagem XAML do UWP.Fundamentally, XAML Islands are created by using the UWP XAML hosting API. Essa API consiste em várias classes do Windows Runtime e interfaces COM que foram introduzidas no SDK do Windows 10, versão 1903.This API consists of several Windows Runtime classes and COM interfaces that were introduced in the Windows 10, version 1903 SDK. Também fornecemos um conjunto de controles .NET da Ilha XAML no Kit de Ferramentas da Comunidade do Windows que usa a API de hospedagem XAML do UWP internamente e fornece uma experiência de desenvolvimento mais conveniente para aplicativos WPF e do Windows Forms.We also provide a set of XAML Island .NET controls in the Windows Community Toolkit that use the UWP XAML hosting API internally and provide a more convenient development experience for WPF and Windows Forms apps.

A maneira como você usa as Ilhas XAML depende do tipo de aplicativo e dos tipos de controles UWP que deseja hospedar.The way you use XAML Islands depends on your application type and the types of UWP controls you want to host.

Observação

Caso tenha comentários sobre as Ilhas XAML, crie um problema no repositório Microsoft.Toolkit.Win32 e deixe seus comentários nele.If you have feedback about XAML Islands, create a new issue in the Microsoft.Toolkit.Win32 repo and leave your comments there. Se preferir enviar seus comentários de forma particular, envie-os para XamlIslandsFeedback@microsoft.com.If you prefer to submit your feedback privately, you can send it to XamlIslandsFeedback@microsoft.com. Seus insights e seus cenários são extremamente importantes para nós.Your insights and scenarios are critically important to us.

RequisitosRequirements

As Ilhas XAML têm estes requisitos de runtime:XAML Islands have these run time requirements:

  • Windows 10, versão 1903 ou uma versão posterior.Windows 10, version 1903, or a later release.
  • Se o aplicativo não for empacotado em um pacote MSIX para implantação, o computador precisará ter o Runtime do Visual C++ instalado.If your application is not packaged in an MSIX package for deployment, the computer must have the Visual C++ Runtime installed.

Aplicativos WPF e do Windows FormsWPF and Windows Forms applications

Recomendamos que os aplicativos WPF e do Windows Forms usem os controles .NET da Ilha XAML disponíveis no Kit de Ferramentas da Comunidade do Windows.We recommend that WPF and Windows Forms applications use the XAML Island .NET controls that are available in the Windows Community Toolkit. Esses controles fornecem um modelo de objeto que simula (ou fornece acesso a) propriedades, métodos e eventos dos controles UWP correspondentes.These controls provide an object model that mimics (or provides access to) the properties, methods, and events of the corresponding UWP controls. Eles também processam o comportamento, como a navegação por teclado e as alterações de layout.They also handle behavior such as keyboard navigation and layout changes.

Há dois conjuntos de controles da Ilha XAML para aplicativos WPF e do Windows Forms: controles encapsulados e controles de host.There are two sets of XAML Island controls for WPF and Windows Forms applications: wrapped controls and host controls.

Controles encapsuladosWrapped controls

Os aplicativos WPF e do Windows Forms podem usar uma seleção de controles da Ilha XAML que encapsulam a interface e a funcionalidade de um controle UWP específico.WPF and Windows Forms applications can use a selection of XAML Island controls that wrap the interface and functionality of a specific UWP control. Adicione esses controles diretamente à área de design do projeto do WPF ou do Windows Forms e use-os como qualquer outro controle WPF ou Windows Forms no designer.You can add these controls directly to the design surface of your WPF or Windows Forms project and then use them like any other WPF or Windows Forms control in the designer.

Atualmente, os controles UWP encapsulados a seguir estão disponíveis no Kit de Ferramentas da Comunidade do Windows.The following wrapped UWP controls are currently available in the Windows Community Toolkit.

ControlControl Sistema operacional mínimo compatívelMinimum supported OS DescriçãoDescription
InkCanvasInkCanvas
InkToolbarInkToolbar
Windows 10, versão 1903Windows 10, version 1903 Forneça uma superfície e as barras de ferramentas relacionadas para a interação do usuário baseada no Windows Ink em seu aplicativo da área de trabalho WPF ou do Windows Forms.Provide a surface and related toolbars for Windows Ink-based user interaction in your Windows Forms or WPF desktop application.
MediaPlayerElementMediaPlayerElement Windows 10, versão 1903Windows 10, version 1903 Insere uma exibição que transmite e renderiza o conteúdo de mídia, como um vídeo no aplicativo da área de trabalho WPF ou do Windows Forms.Embeds a view that streams and renders media content such as video in your Windows Forms or WPF desktop application.
MapControlMapControl Windows 10, versão 1903Windows 10, version 1903 Permite exibir um mapa simbólico ou fotorrealista no aplicativo da área de trabalho WPF ou do Windows Forms.Enables you to display a symbolic or photorealistic map in your Windows Forms or WPF desktop application.

Para obter um passo a passo que demonstra como usar os controles UWP encapsulados, confira Hospedar um controle UWP padrão em um aplicativo WPF.For a walkthrough that demonstrates how to use the wrapped UWP controls, see Host a standard UWP control in a WPF app.

Controles de hostHost controls

Para controles personalizados e outros cenários além daqueles abordados pelos controles encapsulados disponíveis, os aplicativos WPF e do Windows Forms também podem usar o controle WindowsXamlHost que está disponível no Kit de Ferramentas da Comunidade do Windows.For custom controls and other scenarios beyond those covered by the available wrapped controls, WPF and Windows Forms applications can also use the WindowsXamlHost control that is available in the Windows Community Toolkit.

ControlControl Sistema operacional mínimo compatívelMinimum supported OS DescriçãoDescription
WindowsXamlHostWindowsXamlHost Windows 10, versão 1903Windows 10, version 1903 Pode hospedar qualquer controle UWP derivado de Windows.UI.Xaml.UIElement, incluindo qualquer controle UWP internamente fornecido pelo SDK do Windows, bem como controles personalizados.Can host any UWP control that derives from Windows.UI.Xaml.UIElement, including any first-party UWP control provided by the Windows SDK as well as custom controls.

Para obter passos a passos que demonstram como usar o controle WindowsXamlHost, confira Hospedar um controle UWP padrão em um aplicativo WPF e Hospedar um controle UWP personalizado em um aplicativo WPF usando as Ilhas XAML.For walkthroughs that demonstrate how to use the WindowsXamlHost control, see Host a standard UWP control in a WPF app and Host a custom UWP control in a WPF app using XAML Islands.

Observação

Só há suporte ao uso do controle WindowsXamlHost para hospedar controles UWP personalizados em aplicativos WPF e do Windows Forms direcionados ao .NET Core 3.Using the WindowsXamlHost control to host custom UWP controls is supported only in WPF and Windows Forms apps that target .NET Core 3. Há suporte à hospedagem de controles UWP internos fornecidos pelo SDK do Windows em aplicativos direcionados ao .NET Framework ou ao .NET Core 3.Hosting first-party UWP controls provided by the Windows SDK is supported in apps that target either the .NET Framework or .NET Core 3.

Configurar o projeto para usar os controles .NET da Ilha XAMLConfigure your project to use the XAML Island .NET controls

Os controles .NET da Ilha XAML exigem o Windows 10, versão 1903 ou uma versão posterior.The XAML Island .NET controls require Windows 10, version 1903, or a later version. Para usar esses controles, instale um dos pacotes NuGet listados abaixo.To use these controls, install one of the NuGet packages listed below. Esses pacotes fornecem tudo o que você precisa para usar os controles de host e os controles encapsulados da Ilha XAML e incluem outros pacotes NuGet relacionados que também são necessários.These packages provide everything you need to use the XAML Island wrapped controls and host controls, and they include other related NuGet packages that are also required.

Tipo de controleType of control Pacote NuGetNuGet package Artigos relacionadosRelated articles
Controles encapsuladosWrapped controls Versão 6.0.0 ou posterior destes pacotes:Version 6.0.0 or later of these packages: Hospedar um controle UWP padrão em um aplicativo WPFHost a standard UWP control in a WPF app
Controle de hostHost control Versão 6.0.0 ou posterior destes pacotes:Version 6.0.0 or later of these packages: Hospedar um controle UWP padrão em um aplicativo WPFHost a standard UWP control in a WPF app
Hospedar um controle UWP personalizado em um aplicativo WPFHost a custom UWP control in a WPF app

Esteja ciente dos seguintes detalhes:Be aware of the following details:

  • Os pacotes do controle de host também estão incluídos nos pacotes do controle encapsulado.The host control packages are also included in the wrapped control packages. Instale os pacotes do controle encapsulado caso deseje usar os dois conjuntos de controles.You can install the wrapped control packages if you want to use both sets of controls.

  • Se você estiver hospedando um controle UWP personalizado, o projeto do WPF ou do Windows Forms precisará ser direcionado ao .NET Core 3.If you're hosting a custom UWP control, your WPF or Windows Forms project must target .NET Core 3. Não há suporte à hospedagem de controles UWP personalizados em aplicativos direcionados ao .NET Framework.Hosting custom UWP controls is not supported in apps that target the .NET Framework. Você também precisará executar algumas etapas adicionais para referenciar o controle personalizado.You'll also need to perform some additional steps to reference the custom control. Para obter mais informações, confira Hospedar um controle UWP personalizado em um aplicativo WPF usando as Ilhas XAML.For more info, see Host a custom UWP control in a WPF app using XAML Islands.

Controles de exibição da WebWeb view controls

O Kit de Ferramentas da Comunidade do Windows também fornece os controles .NET a seguir para hospedar o conteúdo da Web em aplicativos WPF e do Windows Forms.The Windows Community Toolkit also provides the following .NET controls for hosting web content in WPF and Windows Forms applications. Esses controles costumam ser usados em cenários semelhantes de modernização de aplicativos da área de trabalho, como os controles da Ilha XAML, e são mantidos no mesmo repositório Microsoft.Toolkit.Win32 dos controles da Ilha XAML.These controls are often used in similar desktop app modernization scenarios as the XAML Island controls, and they are maintained in the same Microsoft.Toolkit.Win32 repo repo as the XAML Island controls.

ControlControl Sistema operacional mínimo compatívelMinimum supported OS DescriçãoDescription
WebViewWebView Windows 10, versão 1803Windows 10, version 1803 Usa o mecanismo de renderização do Microsoft Edge para mostrar o conteúdo da Web.Uses the Microsoft Edge rendering engine to show web content.
WebViewCompatibleWebViewCompatible Windows 7Windows 7 Fornece uma versão do WebView que é compatível com mais versões do sistema operacional.Provides a version of WebView that is compatible with more OS versions. Esse controle usa o mecanismo de renderização do Microsoft Edge para mostrar o conteúdo da Web no Windows 10 versão 1803 e posterior e o mecanismo de renderização do Internet Explorer para mostrar o conteúdo da Web em versões anteriores do Windows 10, Windows 8.x e Windows 7.This control uses the Microsoft Edge rendering engine to show web content on Windows 10 version 1803 and later, and the Internet Explorer rendering engine to show web content on earlier versions of Windows 10, Windows 8.x, and Windows 7.

Para usar esses controles, instale um destes pacotes NuGet:To use these controls, install one of these NuGet packages:

Aplicativos C++ Win32C++ Win32 applications

Não há suporte para os controles .NET da Ilha XAML em aplicativos C++ Win32.The XAML Island .NET controls are not supported in C++ Win32 applications. Esses aplicativos precisam usar a API de hospedagem XAML do UWP fornecida pelo SDK do Windows 10 (versão 1903 e posterior).These applications must instead use the UWP XAML hosting API provided by the Windows 10 SDK (version 1903 and later).

A API de hospedagem XAML do UWP consiste em várias classes do Windows Runtime e interfaces COM C++ que o aplicativo Win32 pode usar para hospedar qualquer controle UWP derivado de Windows.UI.Xaml.UIElement.The UWP XAML hosting API consists of several Windows Runtime classes and COM interfaces that your C++ Win32 application can use to host any UWP control that derives from Windows.UI.Xaml.UIElement. Você pode hospedar controles UWP em qualquer elemento de interface do usuário em seu aplicativo que tenha um identificador de janela associado (HWND).You can host UWP controls in any UI element in your application that has an associated window handle (HWND). Para obter mais informações sobre essa API, confira os artigos a seguir.For more information about this API, see the following articles.

Observação

Os controles encapsulados e os controles de host no Kit de Ferramentas da Comunidade do Windows usam a API de hospedagem XAML do UWP internamente e implementam todo o comportamento que, de outra forma, você precisará cuidar por conta própria se usar a API de hospedagem XAML do UWP diretamente, incluindo a navegação por teclado e as alterações de layout.The wrapped controls and host controls in the Windows Community Toolkit use the UWP XAML hosting API internally and implement all of the behavior you would otherwise need to handle yourself if you used the UWP XAML hosting API directly, including keyboard navigation and layout changes. Para aplicativos WPF e do Windows Forms, recomendamos expressamente que você use esses controles em vez da API de hospedagem XAML do UWP diretamente, porque eles abstraem muitos dos detalhes de implementação do uso da API.For WPF and Windows Forms applications, we strongly recommend that you use these controls instead of the UWP XAML hosting API directly because they abstract away many of the implementation details of using the API.

Arquitetura das Ilhas XAMLArchitecture of XAML Islands

Veja a seguir uma visão rápida de como os diferentes tipos de controles da Ilha XAML são organizados em termos de arquitetura na API de hospedagem XAML do UWP.Here's a quick look at how the different types of XAML Island controls are organized architecturally on top of the UWP XAML hosting API.

Arquitetura do controle de host

As APIs exibidas na parte inferior do diagrama são fornecidas com o SDK do Windows.The APIs that appear at the bottom of this diagram ship with the Windows SDK. Os controles encapsulados e os controles de host estão disponíveis por meio de pacotes NuGet no Kit de Ferramentas da Comunidade do Windows.The wrapped controls and host controls are available via NuGet packages in the Windows Community Toolkit.

Limitações e soluções alternativasLimitations and workarounds

As seções a seguir abordam limitações e soluções alternativas para alguns cenários de desenvolvimento em UWP em aplicativos da área de trabalho que usam as Ilhas XAML.The following sections discuss limitations and workarounds for certain UWP development scenarios in desktop apps that use XAML Islands.

Compatível apenas com soluções alternativasSupported only with workarounds

✔️ A hospedagem de controles da Biblioteca WinUI 2.x em uma Ilha XAML tem suporte condicional na versão atual das Ilhas XAML.Hosting controls from the WinUI 2.x Library in a XAML Island is supported conditionally in the current release of XAML Islands. Se o seu aplicativo da área de trabalho usar um pacote MSIX para implantação, você poderá hospedar controles WinUI de versões de pré-lançamento ou de lançamento do pacote NugGet Microsoft.UI.Xaml.If your desktop app uses an MSIX package for deployment, you can host WinUI controls from prerelease or release versions of the Microsoft.UI.Xaml NugGet package. Se o seu aplicativo da área de trabalho não for empacotado usando MSIX, você poderá hospedar controles de WinUI somente se instalar uma versão de pré-lançamento do pacote NuGet Microsoft.UI.Xaml.If your desktop app is not packaged using MSIX, you can host WinUI controls only if you install a prerelease version of the Microsoft.UI.Xaml NuGet package. O suporte para hospedagem de controles da Biblioteca WinUI 3.0 será disponibilizado em uma versão posterior.Support for hosting controls from the WinUI 3.0 Library is coming in a later release.

✔️ Para acessar o elemento raiz de uma árvore de conteúdo XAML em uma Ilha XAML e obter informações relacionadas sobre o contexto no qual ele está hospedado, não use as classes CoreWindow, ApplicationView e Window.To access the root element of a tree of XAML content in a XAML Island and get related information about the context in which it is hosted, do not use the CoreWindow, ApplicationView, and Window classes. Em vez disso, use a classe XamlRoot.Instead, use the XamlRoot class. Para obter mais informações, consulte esta seção.For more information, see this section.

✔️ Para dar suporte ao contrato de Compartilhamento de um aplicativo WPF, Windows Forms ou C++ Win32, o aplicativo precisará usar a interface IDataTransferManagerInterop para fazer com que o objeto DataTransferManager inicie a operação de compartilhamento em uma janela específica.To support the Share contract from a WPF, Windows Forms, or C++ Win32 app, your app must use the IDataTransferManagerInterop interface to get the DataTransferManager object to initiate the share operation for a specific window. Para obter uma amostra que descreve como usar essa interface em um aplicativo WPF, confira a amostra ShareSource.For a sample that demonstrates how to use this interface in a WPF app, see the ShareSource sample.

✔️ Não há suporte para o uso de x:Bind com os controles hospedados em Ilhas XAML.Using x:Bind with hosted controls in XAML Islands is not supported. É necessário declarar o modelo de dados em uma biblioteca .NET Standard.You'll have to declare the data model in a .NET Standard library.

Sem suporteNot supported

🚫 Uso do controle WindowsXamlHost para hospedar controles UWP de terceiros baseados em C# em aplicativos WPF e do Windows Forms direcionados ao .NET Framework.Using the WindowsXamlHost control to host C#-based third-party UWP controls in WPF and Windows Forms apps that target the .NET Framework. Só há suporte para esse cenário em aplicativos direcionados ao .NET Core 3.This scenario is only supported in apps that target .NET Core 3.

🚫 O conteúdo UWP XAML nas Ilhas XAML não responde às alterações de tema do Windows de escuro para claro ou vice-versa em runtime.UWP XAML content in XAML Islands doesn't respond to Windows theme changes from dark to light or vice versa at run time. O conteúdo responde a alterações de alto contraste em runtime.Content does respond to high contrast changes at run time.

🚫 A adição de um controle WebView a um controle de usuário personalizado, (no thread, fora do thread ou fora de processo).Adding a WebView control to a custom user control (either on-thread, off-thread, or out of process).

🚫 Não há suporte para o controle MediaPlayer e o controle de host MediaPlayerElement no modo de tela inteira.The MediaPlayer control and MediaPlayerElement host control are not supported in full screen mode.

🚫 Entrada de texto com a exibição de texto manuscrito.Text input with the handwriting view. Para obter mais informações sobre esse recurso, confira este artigo.For more information about this feature, see this article.

🚫 Controles de texto que usam links de conteúdo @Places e @People.Text controls that use @Places and @People content links. Para obter mais informações sobre esse recurso, confira este artigo.For more information about this feature, see this article.

🚫 Ilhas XAML não dão suporte à hospedagem de um ContentDialog que contenha um controle que aceita entrada de texto, como TextBox, RichEditBox ou AutoSuggestBox.XAML Islands do not support hosting a ContentDialog that contains a control that accepts text input, such as a TextBox, RichEditBox, or AutoSuggestBox. Se você fizer isso, o controle de entrada não responderá adequadamente aos pressionamentos de tecla.If you do this, the input control will not properly respond to key presses. Para obter funcionalidade semelhante usando uma Ilha XAML, recomendamos hospedar uma Pop-up que contenha o controle de entrada.To achieve similar functionality using a XAML Island, we recommend that you host a Popup that contains the input control.

🚫 Atualmente, as Ilhas XAML não dão suporte à exibição de arquivos SVG em um controle hospedado Windows.UI.Xaml.Controls.Image ou usando um objeto Windows.UI.Xaml.Media.Imaging.SvgImageSource.XAML Islands do not currently support displaying SVG files in a hosted Windows.UI.Xaml.Controls.Image control or by using an Windows.UI.Xaml.Media.Imaging.SvgImageSource object. Como alternativa, converta os arquivos de imagem que deseja exibir em formatos baseados em varredura, como JPG ou PNG.As a workaround, convert the image files you want to display to raster-based formats such as JPG or PNG.

Contexto do host de janela para Ilhas XAMLWindow host context for XAML Islands

Ao hospedar as Ilhas XAML em um aplicativo da área de trabalho, você pode ter várias árvores de conteúdo XAML em execução no mesmo thread simultaneamente.When you host XAML Islands in a desktop app, you can have multiple trees of XAML content running on the same thread at the same time. Para acessar o elemento raiz de uma árvore de conteúdo XAML em uma Ilha XAML e obter informações relacionadas sobre o contexto no qual ele está hospedado, use a classe XamlRoot.To access the root element of a tree of XAML content in a XAML Island and get related information about the context in which it is hosted, use the XamlRoot class. As classes CoreWindow, ApplicationView e Window não fornecerão as informações corretas para as Ilhas XAML.The CoreWindow, ApplicationView, and Window classes won't provide the correct information for XAML Islands. Objetos CoreWindow e Window existem no thread e podem ser acessados pelo seu aplicativo, mas eles não retornarão limites nem visibilidade significativos (eles são sempre invisíveis e têm um tamanho de 1x1).CoreWindow and Window objects do exist on the thread and are accessible to your app, but they won't return meaningful bounds or visibility (they are always invisible and have a size of 1x1). Para obter mais informações, confira Hosts de exibição em janelas.For more information, see Windowing hosts.

Por exemplo, para obter o retângulo delimitador da janela que contém um controle UWP hospedado em uma ilha XAML, use a propriedade XamlRoot.Size do controle.For example, to get the bounding rectangle of the window that contains a UWP control that is hosted in a XAML Island, use the XamlRoot.Size property of the control. Como todos os controles UWP que podem ser hospedados em uma ilha XAML derivam de Windows.UI.Xaml.UIElement, você pode usar a propriedade XamlRoot do controle para acessar o objeto XamlRoot.Because every UWP control that can be hosted in a XAML Island derives from Windows.UI.Xaml.UIElement, you can use the XamlRoot property of the control to access the XamlRoot object.

Size windowSize = myUWPControl.XamlRoot.Size;

Não use a propriedade CoreWindows.Bounds para obter o retângulo delimitador.Do not use the CoreWindows.Bounds property to get the bounding rectangle.

// This will return incorrect information for a UWP control that is hosted in a XAML Island.
Rect windowSize = CoreWindow.GetForCurrentThread().Bounds;

Para uma tabela de APIs relacionadas à janela comum que você deve evitar no contexto de Ilhas XAML e as substituições de XamlRoot recomendadas, confira a tabela nesta seção.For a table of common windowing-related APIs that you should avoid in the context of XAML Islands and the recommended XamlRoot replacements, see the table in this section.

Para obter uma amostra que descreve como usar essa interface em um aplicativo WPF, confira a amostra ShareSource.For a sample that demonstrates how to use this interface in a WPF app, see the ShareSource sample.

Roteiro do recursoFeature roadmap

Este é o estado atual dos recursos relacionados às Ilhas XAML:Here is the current state of XAML Islands-related features:

  • Aplicativos C++ Win32: a API de hospedagem XAML do UWP é considerada a versão 1.0 no Windows 10, versão 1903 em diante.C++ Win32 apps: The UWP XAML hosting API is considered version 1.0 as of Windows 10, version 1903.
  • Aplicativos gerenciados direcionados ao .NET Framework 4.6.2 e posterior: os controles da Ilha XAML que estão disponíveis nos pacotes NuGet da versão 6.0.0 são considerados a versão 1.0 nos aplicativos direcionados ao .NET Framework 4.6.2 e posterior.Managed apps that target .NET Framework 4.6.2 and later: The XAML Island controls that are available in the version 6.0.0 NuGet packages are considered version 1.0 for apps that target the .NET Framework 4.6.2 and later.
  • Aplicativos gerenciados direcionados ao .NET Core 3.0 e posterior: os controles que estão disponíveis nos pacotes NuGet da versão 6.0.0 ainda estão no Developer Preview para aplicativos direcionados ao .NET Core 3.0 e posterior.Managed apps that target .NET Core 3.0 and later: The controls that are available in the version 6.0.0 NuGet packages are still in developer preview for apps that target the .NET Core 3.0 and later. A versão 1.0 desses controles para o .NET Core 3.0 e posterior está planejada para uma versão posterior.The version 1.0 release of these controls for .NET Core 3.0 and later are planned for a later release.

Recursos adicionaisAdditional resources

Para obter mais informações básicas e tutoriais sobre como usar as Ilhas XAML, confira os seguintes artigos e recursos:For more background information and tutorials about using XAML Islands, see the following articles and resources:

  • Tutorial: modernizar um aplicativo WPF: esse tutorial fornece instruções passo a passo de uso dos controles encapsulados e dos controles de host no Kit de Ferramentas da Comunidade do Windows para adicionar controles UWP a um aplicativo WPF de linha de negócios existente.Modernize a WPF app tutorial: This tutorial provides step-by-step instructions for using the wrapped controls and host controls in the Windows Community Toolkit to add UWP controls to an existing WPF line-of-business application. Esse tutorial inclui o código completo para o aplicativo WPF, bem como instruções detalhadas de cada etapa do processo.This tutorial includes the complete code for the WPF application as well as detailed instructions for each step in the process.
  • Exemplos de código de Ilhas XAML: este repositório contém exemplos do Windows Forms, do WPF e do C++/Win32 que demonstram como usar as Ilhas XAML.XAML Islands code samples: This repo contains Windows Forms, WPF, and C++/Win32 samples that demonstrate how to use XAML Islands.
  • Ilhas XAML v1: atualizações e roteiro: Essa postagem no blog aborda muitas perguntas comuns sobre as Ilhas XAML e fornece um roteiro de desenvolvimento detalhado.XAML Islands v1 - Updates and Roadmap: This blog post discusses many common questions about XAML Islands and provides a detailed development roadmap.