WindowsXamlManager.InitializeForCurrentThread 方法

定義

命名空間:

Microsoft.UI.Xaml.Hosting

初始化非 Windows 應用程式 SDK (WASDK) 傳統型 (應用程式中的 WinUI XAML 架構，例如，目前線程上的 WPF 或 Windows Forms 應用程式) 。

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 中的 [ 處置] () 物件，以確保最終會釋放 XAML 資源。

注意

在 Windows 應用程式 SDK 1.4 中，InitializeForCurrentThread每次呼叫物件時都會傳回新的 物件。

在 Windows 應用程式 SDK 1.5 或更新版本中，會傳回相同的WindowsXamlManager實例，InitializeForCurrentThread直到線程上的 DispatcherQueue 關閉為止。