WindowsXamlManager.InitializeForCurrentThread Methode

Definition

Namespace:

Microsoft.UI.Xaml.Hosting

Initialisiert das WinUI-XAML-Framework in einer Nicht-Windows App SDK-Desktopanwendung (WASDK) (z. B. eine WPF- oder Windows Forms-Anwendung) im aktuellen Thread.

public:
 static WindowsXamlManager ^ InitializeForCurrentThread();

 static WindowsXamlManager InitializeForCurrentThread();

public static WindowsXamlManager InitializeForCurrentThread();

function initializeForCurrentThread()

Public Shared Function InitializeForCurrentThread () As WindowsXamlManager

Gibt zurück

WindowsXamlManager

Ein -Objekt, das einen Verweis auf das WinUI-XAML-Framework enthält.

Hinweise

Rufen Sie diese Methode auf, um das interne WinUI-XAML-Framework für den aktuellen Thread in einer Desktopanwendung zu initialisieren, in der Sie Microsoft.UI.Xaml.UIElement-Objekte in einer DesktopWindowXamlSource hosten möchten. Sie müssen diese Methode nur explizit aufrufen, wenn Ihre Anwendung die Windows.UI.Xaml.UIElement-Objekte erstellt, bevor sie das DesktopWindowXamlSource-Objekt erstellt, das sie hostet. Ihre Anwendung sollte diese Methode in der Regel aufrufen, wenn das übergeordnete UI-Objekt, das die DesktopWindowXamlSource hostet, instanziiert wird.

Wenn Sie ein DesktopWindowXamlSource-Objekt erstellen, bevor Sie die Windows.UI.Xaml.UIElement-Objekte erstellen, die darin gehostet werden, müssen Sie diese Methode nicht aufrufen. In diesem Szenario wird das WinUI-XAML-Framework für Sie initialisiert, wenn Sie das DesktopWindowXamlSource-Objekt instanziieren.

Diese Methode gibt ein WindowsXamlManager-Objekt zurück, das einen Verweis auf das WinUI-XAML-Framework enthält. Du kannst für einen bestimmten Thread beliebig viele WindowsXamlManager-Objekte erstellen. Da jedes Objekt jedoch einen Verweis auf das WinUI-XAML-Framework enthält, sollten Sie die Objekte schließen (in .NET entsorgen ), um sicherzustellen, dass XAML-Ressourcen schließlich freigegeben werden.

Hinweis

In Windows App SDK 1.4 gibt jedes Mal ein neues Objekt zurück, InitializeForCurrentThread wenn es aufgerufen wird.

Gibt in Windows App SDK Version 1.5 oder höher denselben WindowsXamlManager instance zurück, InitializeForCurrentThread bis dispatcherQueue für den Thread heruntergefahren wird.