デスクトップ アプリで UWP XAML コントロールをホストする (XAML Islands)Host UWP XAML controls in desktop apps (XAML Islands)

Windows 10 バージョン 1903 以降では、"XAML Islands" という機能を使用して、UWP 以外のデスクトップ アプリケーションで UWP コントロールをホストできるようになりました。Starting in Windows 10, version 1903, you can host UWP controls in non-UWP desktop applications using a feature called XAML Islands. この機能を使用すると、既存の WPF、Windows フォーム、およびC++ Win32 アプリケーションの外観、操作性、および機能を、UWP コントロールでのみ使用できる最新の Windows 10 UI 機能を使用して強化することができます。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. つまり、既存の WPF、Windows フォーム、C++ Win32 アプリケーションで Fluent Design System をサポートする Windows Ink やコントロールなどの UWP 機能を使用できます。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.

次のような Windows.UI.Xaml.UIElement から派生した任意の UWP コントロールをホストできます。You can host any UWP control that derives from Windows.UI.Xaml.UIElement, including:

  • Windows SDK で提供されるファーストパーティ UWP コントロール。Any first-party UWP control provided by the Windows SDK.
  • 任意のカスタム UWP コントロール (たとえば、連携して動作する複数の UWP コントロールで構成されるユーザー コントロール)。Any custom UWP control (for example, a user control that consists of several UWP controls that work together). アプリケーションと共にコンパイルできるように、カスタム コントロールのソース コードを用意する必要があります。You must have the source code for the custom control so you can compile it with your application.

基本的に、XAML Islands は UWP XAML ホスティング API を使用して作成されています。Fundamentally, XAML Islands are created by using the UWP XAML hosting API. この API は、Windows 10 バージョン 1903 SDK で導入されたいくつかの Windows ランタイム クラスと COM インターフェイスで構成されています。This API consists of several Windows Runtime classes and COM interfaces that were introduced in the Windows 10, version 1903 SDK. また、Windows Community Toolkit には、UWP XAML ホスティング API を内部的に使用する一連の XAML Island .NET コントロールも用意されており、WPF と Windows フォーム アプリの開発環境がより便利になります。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.

XAML Island の使用方法は、アプリケーションの種類と、ホストする UWP コントロールの種類によって異なります。The way you use XAML Islands depends on your application type and the types of UWP controls you want to host.

注意

XAML Islands に関するフィードバックがある場合は、Microsoft.Toolkit.Win32 リポジトリに新しい問題を作成し、そこにコメントを残してください。If you have feedback about XAML Islands, create a new issue in the Microsoft.Toolkit.Win32 repo and leave your comments there. 個人的にフィードバックを送信したい場合は、XamlIslandsFeedback@microsoft.com に送信できます。If you prefer to submit your feedback privately, you can send it to XamlIslandsFeedback@microsoft.com. お客様の洞察とシナリオは弊社にとって非常に重要です。Your insights and scenarios are critically important to us.

要件Requirements

XAML Islands には、次のような実行時の要件があります。XAML Islands have these run time requirements:

  • Windows 10 バージョン 1903 以降のリリース。Windows 10, version 1903, or a later release.
  • 展開用に MSIX パッケージにアプリケーションをパッケージ化しない場合は、コンピューターに Visual C++ ランタイムがインストールされている必要があります。If your application is not packaged in an MSIX package for deployment, the computer must have the Visual C++ Runtime installed.

WPF と Windows フォーム アプリケーションWPF and Windows Forms applications

WPF および Windows フォーム アプリケーションでは、Windows Community Toolkit で利用できる XAML Island .NET コントロールを使用することをお勧めします。We recommend that WPF and Windows Forms applications use the XAML Island .NET controls that are available in the Windows Community Toolkit. これらのコントロールには、対応する UWP コントロールのプロパティ、メソッド、およびイベントを模倣する (またはそれにアクセスできるようになる) オブジェクト モデルが用意されています。These controls provide an object model that mimics (or provides access to) the properties, methods, and events of the corresponding UWP controls. また、キーボード ナビゲーションやレイアウトの変更などの動作も処理されます。They also handle behavior such as keyboard navigation and layout changes.

WPF および Windows フォーム アプリケーション用の XAML Island コントロールには、"ラップされたコントロール" と"ホスト コントロール" という 2 つのセットがあります。There are two sets of XAML Island controls for WPF and Windows Forms applications: wrapped controls and host controls.

ラップされたコントロールWrapped controls

WPF および Windows フォーム アプリケーションには、特定の UWP コントロールのインターフェイスと機能をラップする XAML Island コントロールの一部を使用できます。WPF and Windows Forms applications can use a selection of XAML Island controls that wrap the interface and functionality of a specific UWP control. これらのコントロールを WPF または Windows フォーム プロジェクトのデザイン サーフェイスに直接追加し、デザイナーの他の WPF や Windows フォーム コントロールと同様に使用できます。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.

現在、次のラップされた UWP コントロールを Windows Community Toolkit で使用できます。The following wrapped UWP controls are currently available in the Windows Community Toolkit.

ControlControl サポートされる最小 OSMinimum supported OS 説明Description
InkCanvasInkCanvas
InkToolbarInkToolbar
Windows 10 バージョン 1903Windows 10, version 1903 Windows フォームまたは WPF デスクトップ アプリケーションで Windows Ink ベースのユーザーとの対話に使用する、画面と関連するツールバーを提供します。Provide a surface and related toolbars for Windows Ink-based user interaction in your Windows Forms or WPF desktop application.
MediaPlayerElementMediaPlayerElement Windows 10 バージョン 1903Windows 10, version 1903 Windows フォームまたは WPF デスクトップ アプリケーションでビデオなどのメディア コンテンツをストリーミングおよびレンダリングするビューを埋め込みます。Embeds a view that streams and renders media content such as video in your Windows Forms or WPF desktop application.
MapControlMapControl Windows 10 バージョン 1903Windows 10, version 1903 Windows フォームまたは WPF デスクトップ アプリケーションで、シンボリックまたはフォト マップを表示できるようにします。Enables you to display a symbolic or photorealistic map in your Windows Forms or WPF desktop application.

ラップされた UWP コントロールの使用方法を示すチュートリアルについては、WPF アプリでの標準 UWP コントロールのホストに関する記事を参照してください。For a walkthrough that demonstrates how to use the wrapped UWP controls, see Host a standard UWP control in a WPF app.

ホスト コントロールHost controls

使用できるラップされたコントロールに含まれていないカスタム コントロールやその他のシナリオでは、Windows Community Toolkit で使用できる WindowsXamlHost コントロールを WPF および 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 サポートされる最小 OSMinimum supported OS 説明Description
WindowsXamlHostWindowsXamlHost Windows 10 バージョン 1903Windows 10, version 1903 Windows.UI.Xaml.UIElement から派生した UWP コントロールをホストできます。たとえば、Windows SDK で提供されるファーストパーティ UWP コントロールや、カスタム コントロールなどです。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.

WindowsXamlHost コントロールの使用方法を示すチュートリアルについては、WPF アプリでの標準 UWP コントロールのホストに関する記事と「XAML アイランドを使用した WPF アプリでのカスタム UWP コントロールのホスト」を参照してください。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.

注意

WindowsXamlHost コントロールを使用したカスタム UWP コントロールのホストは、.NET Core 3 をターゲットとする WPF および Windows フォーム アプリでのみサポートされています。Using the WindowsXamlHost control to host custom UWP controls is supported only in WPF and Windows Forms apps that target .NET Core 3. Windows SDK で提供されるファーストパーティ UWP コントロールのホストは、.NET Framework または .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.

XAML Island .NET コントロールを使用するようにプロジェクトを構成するConfigure your project to use the XAML Island .NET controls

XAML Island .NET コントロールには、Windows 10 バージョン 1903 以降が必要です。The XAML Island .NET controls require Windows 10, version 1903, or a later version. これらのコントロールを使用するには、次に示す NuGet パッケージのいずれかをインストールします。To use these controls, install one of the NuGet packages listed below. これらのパッケージには、XAML Island のラップされたコントロールとホスト コントロールを使用するために必要なすべてのものが用意され、必要な他の関連する NuGet パッケージも含まれています。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.

コントロールの種類Type of control NuGet パッケージNuGet package 関連記事Related articles
ラップされたコントロールWrapped controls バージョン 6.0.0 以降のパッケージ:Version 6.0.0 or later of these packages: WPF アプリでの標準 UWP コントロールのホストHost a standard UWP control in a WPF app
ホスト コントロールHost control バージョン 6.0.0 以降のパッケージ:Version 6.0.0 or later of these packages: WPF アプリでの標準 UWP コントロールのホストHost a standard UWP control in a WPF app
WPF アプリでのカスタム UWP コントロールのホストHost a custom UWP control in a WPF app

次の詳細に注意してください。Be aware of the following details:

  • ホスト コントロール パッケージは、ラップされたコントロール パッケージにも含まれています。The host control packages are also included in the wrapped control packages. ラップされたコントロール パッケージをインストールすると、両方のコントロール セットを使用できます。You can install the wrapped control packages if you want to use both sets of controls.

  • カスタム UWP コントロールをホストしている場合、WPF または Windows フォーム プロジェクトは .NET Core 3 をターゲットにする必要があります。If you're hosting a custom UWP control, your WPF or Windows Forms project must target .NET Core 3. .NET Framework をターゲットとするアプリでは、カスタム UWP コントロールのホストはサポートされません。Hosting custom UWP controls is not supported in apps that target the .NET Framework. また、カスタム コントロールを参照するには、いくつかの追加の手順を実行する必要があります。You'll also need to perform some additional steps to reference the custom control. 詳細については、「XAML アイランドを使用した WPF アプリでのカスタム UWP コントロールのホスト」を参照してください。For more info, see Host a custom UWP control in a WPF app using XAML Islands.

Web ビュー コントロールWeb view controls

Windows Community Toolkit には、WPF および Windows フォーム アプリケーションで Web コンテンツをホストするための次の .NET コントロールも用意されています。The Windows Community Toolkit also provides the following .NET controls for hosting web content in WPF and Windows Forms applications. これらのコントロールは、XAML Island コントロールと同様のデスクトップ アプリの最新化シナリオでよく使用され、XAML Island コントロールと同じ Microsoft.Toolkit.Win32 リポジトリ リポジトリで保守されています。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 サポートされる最小 OSMinimum supported OS 説明Description
WebViewWebView Windows 10 バージョン 1803Windows 10, version 1803 Microsoft Edge レンダリング エンジンを使用して、Web コンテンツを表示します。Uses the Microsoft Edge rendering engine to show web content.
WebViewCompatibleWebViewCompatible Windows 7Windows 7 より多くの OS バージョンと互換性がある WebView のバージョンが用意されています。Provides a version of WebView that is compatible with more OS versions. このコントロールには、Windows 10 バージョン 1803 以降で Web コンテンツを表示するために Microsoft Edge レンダリング エンジンが使用され、Windows 10、Windows 8.x、および Windows 7 の以前のバージョンで Web コンテンツを表示するために Internet Explorer レンダリング エンジンが使用されます。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.

これらのコントロールを使用するには、次のいずれかの NuGet パッケージをインストールします。To use these controls, install one of these NuGet packages:

C++ Win32 アプリケーションC++ Win32 applications

XAML Island .NET コントロールは、C++ Win32 アプリケーションではサポートされていません。The XAML Island .NET controls are not supported in C++ Win32 applications. これらのアプリケーションでは、Windows 10 SDK (バージョン 1903 以降) で提供される UWP XAML ホスティング API を代わりに使用する必要があります。These applications must instead use the UWP XAML hosting API provided by the Windows 10 SDK (version 1903 and later).

UWP XAML ホスティング API は、いくつかの Windows ランタイム クラスと COM インターフェイスで構成されています。C++ Win32 アプリケーションではこれらを使用して Windows.UI.Xaml.UIElement から派生した任意の UWP コントロールをホストできます。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. 関連するウィンドウ ハンドル (HWND) を持つアプリケーションの任意の UI 要素で UWP コントロールをホストできます。You can host UWP controls in any UI element in your application that has an associated window handle (HWND). この API の詳細については、次の記事を参照してください。For more information about this API, see the following articles.

注意

Windows Community Toolkit のラップされたコントロールとホスト コントロールには、UWP XAML ホスティング API が内部的に使用され、キーボード ナビゲーションやレイアウトの変更など、UWP XAML ホスティング API を直接使用した場合には独自に処理する必要があるすべての動作が実装されています。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. WPF および Windows フォーム アプリケーションの場合、UWP XAML ホスティング API ではなく、これらのコントロールを使用することを強くお勧めします。これは、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.

XAML Islands のアーキテクチャArchitecture of XAML Islands

ここでは、UWP XAML ホスティング API の上に、どのような種類の XAML Island コントロールが構造的に構成されているかを簡単に説明します。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.

ホスト コントロール アーキテクチャ

この図の下部に表示されている API は、Windows SDK に付属しています。The APIs that appear at the bottom of this diagram ship with the Windows SDK. ラップされたコントロールとホスト コントロールは、Windows Community Toolkit の NuGet パッケージを介して使用できます。The wrapped controls and host controls are available via NuGet packages in the Windows Community Toolkit.

制限事項と回避策Limitations and workarounds

以下のセクションでは、XAML Islands を使用するデスクトップ アプリでの特定の UWP 開発シナリオにおける制限事項と回避策について説明します。The following sections discuss limitations and workarounds for certain UWP development scenarios in desktop apps that use XAML Islands.

回避策を使用した場合にのみサポートされるSupported only with workarounds

✔️XAML Island の WinUI 2.x ライブラリのコントロールをホストすることは、XAML Island の現在のリリースで条件付きでサポートされています。Hosting controls from the WinUI 2.x Library in a XAML Island is supported conditionally in the current release of XAML Islands. デスクトップ アプリで MSIX パッケージを使用して展開している場合は、Microsoft.UI.Xaml NugGet パッケージのプレリリースまたはリリース バージョンからの WinUI コントロールをホスティングできます。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. お使いのデスクトップ アプリが MSIX を使用してパッケージ化されていない場合は、プレリリース バージョンの Microsoft.UI.Xaml NuGet パッケージをインストールしている場合にのみ、WinUI コントロールをホスティングできます。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. WinUI 3.0 ライブラリのコントロールのホストは、今後のリリースでサポートされる予定です。Support for hosting controls from the WinUI 3.0 Library is coming in a later release.

✔️XAML Island で XAML コンテンツのツリーのルート要素にアクセスし、それがホストされているコンテキストに関する関連情報を取得するために、CoreWindowApplicationViewWindow クラスを使用しないでください。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. 代わりに、XamlRoot クラスを使用します。Instead, use the XamlRoot class. 詳しくは、このセクションをご覧ください。For more information, see this section.

✔️WPF、Windows フォーム、または C++ Win32 アプリからの共有コントラクトをサポートするには、アプリで IDataTransferManagerInterop インターフェイスを使用して、特定のウィンドウの共有操作を開始するために DataTransferManager オブジェクトを取得する必要があります。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. このインターフェイスを WPF アプリで使用する方法を示すサンプルについては、ShareSource サンプルを参照してください。For a sample that demonstrates how to use this interface in a WPF app, see the ShareSource sample.

✔️XAML Islands でホストされたコントロールと共に x:Bind を使用することは、サポートされていません。Using x:Bind with hosted controls in XAML Islands is not supported. .NET Standard ライブラリ内でデータ モデルを宣言する必要があります。You'll have to declare the data model in a .NET Standard library.

サポートされていません。Not supported

🚫 .NET Framework をターゲットとする WPF および Windows フォーム アプリで C# ベースのサード パーティ UWP コントロールをホストするための、WindowsXamlHost コントロールの使用。Using the WindowsXamlHost control to host C#-based third-party UWP controls in WPF and Windows Forms apps that target the .NET Framework. .NET Core 3 をターゲットとするアプリでのみ、このシナリオはサポートされています。This scenario is only supported in apps that target .NET Core 3.

🚫 XAML Islands の UWP XAML コンテンツは、実行時の濃いから薄い、またはその逆の Windows テーマの変更には対応していません。UWP XAML content in XAML Islands doesn't respond to Windows theme changes from dark to light or vice versa at run time. コンテンツは実行時にハイ コントラストの変更に対応します。Content does respond to high contrast changes at run time.

🚫 カスタム ユーザー コントロールへの WebView コントロールの追加 (スレッド上、オフ スレッド、プロセス外のいずれか)。Adding a WebView control to a custom user control (either on-thread, off-thread, or out of process).

🚫 MediaPlayer コントロールと MediaPlayerElement ホスト コントロールは、全画面表示モードではサポートされていません。The MediaPlayer control and MediaPlayerElement host control are not supported in full screen mode.

🚫 手書きビューでのテキスト入力。Text input with the handwriting view. この機能について詳しくは、この記事をご覧ください。For more information about this feature, see this article.

🚫 @Places および @People コンテンツ リンクを使用するテキスト コントロール。Text controls that use @Places and @People content links. この機能について詳しくは、この記事をご覧ください。For more information about this feature, see this article.

🚫 XAML Islands では、TextBoxRichEditBoxAutoSuggestBox などのテキスト入力を受け入れるコントロールを含む ContentDialog のホストはサポートされていません。XAML Islands do not support hosting a ContentDialog that contains a control that accepts text input, such as a TextBox, RichEditBox, or AutoSuggestBox. これを行うと、入力コントロールはキーが押されても適切に応答しません。If you do this, the input control will not properly respond to key presses. XAML Island を使用して同様の機能を実現するには、入力コントロールを含む Popup をホストすることをお勧めします。To achieve similar functionality using a XAML Island, we recommend that you host a Popup that contains the input control.

🚫 現在、XAML Island では、ホストされた Windows.UI.Xaml.Controls.Image コントロール内、または Windows.UI.Xaml.Media.Imaging.SvgImageSource オブジェクトを使用した SVG ファイルの表示はサポートされていません。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. 回避策として、表示したい画像ファイルを、JPG や PNG などのラスターベース形式に変換してください。As a workaround, convert the image files you want to display to raster-based formats such as JPG or PNG.

XAML Islands のウィンドウ ホスト コンテキストWindow host context for XAML Islands

デスクトップ アプリで XAML Islands をホストすると、XAML コンテンツの複数のツリーを同じスレッド上で同時に実行できます。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. XAML Island で XAML コンテンツのツリーのルート要素にアクセスし、それがホストされているコンテキストに関する関連情報を取得するには、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. CoreWindowApplicationView、および Window クラスでは、XAML Islands に関する正しい情報が提供されません。The CoreWindow, ApplicationView, and Window classes won't provide the correct information for XAML Islands. CoreWindow オブジェクトおよび Window オブジェクトはスレッドに存在し、アプリからアクセスできますが、意味のある境界と表示は返されません (常に非表示で、サイズは 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). 詳細については、ウィンドウ化ホストに関するページを参照してください。For more information, see Windowing hosts.

たとえば、XAML Island でホストされている UWP コントロールが含まれるウィンドウの境界を示す四角形を取得するには、コントロールの XamlRoot.Size プロパティを使用します。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. XAML Island でホストできるすべての UWP コントロールは、Windows.UI.Xaml.UIElement から派生するため、コントロールの XamlRoot プロパティを使用して、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;

境界を示す四角形を取得するために CoreWindows.Bounds プロパティを使用しないでください。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;

XAML Islands のコンテキストで避ける必要がある一般的なウィンドウ関連 API の表と、推奨される XamlRoot の置換については、こちらのセクションの表を参照してください。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.

このインターフェイスを WPF アプリで使用する方法を示すサンプルについては、ShareSource サンプルを参照してください。For a sample that demonstrates how to use this interface in a WPF app, see the ShareSource sample.

機能ロードマップFeature roadmap

XAML Islands に関連する機能の現在の状態を次に示します。Here is the current state of XAML Islands-related features:

  • C++ Win32 アプリ: Windows 10 バージョン 1903 時点の UWP XAML ホスティング API はバージョン 1.0 と見なされます。C++ Win32 apps: The UWP XAML hosting API is considered version 1.0 as of Windows 10, version 1903.
  • .NET Framework 4.6.2 以降をターゲットとするマネージド アプリ: .NET Framework 4.6.2 以降をターゲットとするアプリ用のバージョン 6.0.0 NuGet パッケージで使用できる XAML Island コントロールはバージョン 1.0 と見なされます。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.
  • .NET Core 3.0 以降をターゲットとするマネージド アプリ: .NET Core 3.0 以降をターゲットとするアプリ用のバージョン 6.0.0 NuGet パッケージで使用できるコントロールは、まだ開発者プレビュー段階です。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. .NET Core 3.0 以降のこれらのコントロールのバージョン 1.0 リリースは、今後のリリースで予定されています。The version 1.0 release of these controls for .NET Core 3.0 and later are planned for a later release.

その他の資料Additional resources

XAML Islands の使用に関する背景情報とチュートリアルの詳細については、次の記事とリソースを参照してください。For more background information and tutorials about using XAML Islands, see the following articles and resources:

  • WPF アプリの最新化のチュートリアル:このチュートリアルでは、Windows Community Toolkit でラップされたコントロールとホスト コントロールを使用して、UWP コントロールを既存の WPF 基幹業務アプリケーションに追加する手順が説明されています。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. このチュートリアルには、WPF アプリケーションの完全なコードと、プロセスの各手順の詳細な手順も含まれています。This tutorial includes the complete code for the WPF application as well as detailed instructions for each step in the process.
  • XAML Islands コード サンプル:このリポジトリには、XAML Islands の使用方法を示す Windows フォーム、WPF、C++/Win32 のサンプルが含まれています。XAML Islands code samples: This repo contains Windows Forms, WPF, and C++/Win32 samples that demonstrate how to use XAML Islands.
  • XAML Islandss v1 - 更新プログラムとロードマップ:このブログ投稿では、XAML Islands についてよく寄せられる質問が説明され、詳細な開発ロードマップが掲載されています。XAML Islands v1 - Updates and Roadmap: This blog post discusses many common questions about XAML Islands and provides a detailed development roadmap.