WindowsXamlManager.InitializeForCurrentThread 方法

定义

命名空间:

Microsoft.UI.Xaml.Hosting

在非Windows 应用 SDK (WASDK) 桌面应用程序 (初始化 WinUI XAML 框架，例如，当前线程上的 WPF 或 Windows 窗体 应用程序) 。

public:
 static WindowsXamlManager ^ InitializeForCurrentThread();

 static WindowsXamlManager InitializeForCurrentThread();

public static WindowsXamlManager InitializeForCurrentThread();

function initializeForCurrentThread()

Public Shared Function InitializeForCurrentThread () As WindowsXamlManager

返回

WindowsXamlManager

一个 对象，该对象包含对 WinUI XAML 框架的引用。

注解

调用此方法可初始化桌面应用程序中当前线程的内部 WinUI XAML 框架，你希望在 DesktopWindowXamlSource 中托管 Microsoft.UI.Xaml.UIElement 对象。 仅当应用程序创建 Windows.UI.Xaml.UIElement 对象之前，才需要显式调用此方法，然后再创建将承载这些对象的 DesktopWindowXamlSource 对象。 当托管 DesktopWindowXamlSource 的父 UI 对象实例化时，应用程序通常应调用此方法。

如果在创建将承载在该对象的 Windows.UI.Xaml.UIElement 对象之前创建 DesktopWindowXamlSource 对象，则无需调用此方法。 在此方案中，当你实例化 DesktopWindowXamlSource 对象时，将为你初始化 WinUI XAML 框架。

此方法返回一个 WindowsXamlManager 对象，该对象包含对 WinUI XAML 框架的引用。 可以根据需要在给定线程上创建任意数量的“WindowsXamlManager” 对象。 但是，由于每个对象都包含对 WinUI XAML 框架的引用，因此应在 .NET 中 关闭 (Dispose) 对象，以确保最终释放 XAML 资源。

注意

在 Windows 应用 SDK 1.4 中， InitializeForCurrentThread 每次调用对象时都会返回一个新对象。

在 Windows 应用 SDK 1.5 或更高版本中， 返回相同的WindowsXamlManager实例，InitializeForCurrentThread直到线程上的 DispatcherQueue 关闭。