AccountsSettingsPane Klasse

Referenz

Definition

Namespace:: Windows.UI.ApplicationSettings

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Stellt Methoden zum Anzeigen des Kontobereichs und zum Registrieren von Rückrufen bereit, wenn das Konto-Flyout angezeigt wird.

public ref class AccountsSettingsPane sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
class AccountsSettingsPane final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
public sealed class AccountsSettingsPane

Public NotInheritable Class AccountsSettingsPane

Vererbung: Object Platform::Object IInspectable AccountsSettingsPane

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Die App stellt die Rückrufe mit Kontometadaten für alle Webkontoanbieter, Webkonten, globalen Kontobefehle und Anmeldeinformationen bereit, die von der App angezeigt werden. Beispiele für Kontoanbieter sind Facebook, LinkedIn und Twitter.

Die Befehlsklassen konto und credential im Windows.UI.ApplicationSettings-Namespace entsprechen Datenobjekten im Windows.UI.ApplicationSettings-Namespace :

Datenobjekt (Windows.Security.Credentials)	UI-Objekt (Windows.UI.ApplicationSettings)
WebAccount	WebAccountCommand
WebAccountProvider	WebAccountProviderCommand
PasswordCredential	CredentialCommand

Desktopanwendungen

Für eine Desktop-App müssen Sie anstelle der AccountSettingsPane-Klasse die Interop-API verwenden, wie unten beschrieben.

Rufen Sie zuerst ein Fensterhandle (HWND) ab. Dieses Thema enthält Codebeispiele für windows UI Library (WinUI) 3, Windows Presentation Foundation (WPF) und Windows Forms (WinForms). Fügen Sie diesen Code in die folgende Codeliste ein.
Sie sollten die IAccountSettingsPaneInterop-Schnittstelle in Ihrer Desktop-App verwenden. Für C#-Apps, die .NET 6 oder höher verwenden, ist die AccountSettingsPaneInterop-Klasse verfügbar. Weitere Informationen zu den C#-Interopklassen finden Sie unter Aufrufen von Interop-APIs aus einer .NET 5+-App. Weitere Informationen finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.

Im Folgenden finden Sie ein Beispiel für die Verwendung der AccountSettingsPaneInterop-Klasse in C# (.NET 6 oder höher):

private void LoginButton_Click(object sender, RoutedEventArgs e)
{
    // Retrieve the window handle for whichever UI framework being used (WinUI 3, WPF, WinForms)
    var hwnd = ...
    // Call methods from the interop class, passing in the window handle
    await AccountsSettingsPaneInterop.ShowManageAccountsForWindowAsync(hwnd);
}

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1607	14393	ShowAddAccountAsync
1607	14393	ShowManageAccountsAsync
1803	17134	ShowAddAccountForUserAsync
1803	17134	ShowManageAccountsForUserAsync

Methoden

GetForCurrentView()	Ruft ein AccountsSettingsPane-Objekt ab, das der aktuellen App-Ansicht (also mit CoreWindow) zugeordnet ist.
Show()	Zeigt den Bereich "Kontoeinstellungen" an.
ShowAddAccountAsync()	Zeigt den Bildschirm Konten hinzufügen an.
ShowAddAccountForUserAsync(User)	Zeigt den Bildschirm Zum Hinzufügen von Konten für den angegebenen Benutzer an.
ShowManageAccountsAsync()	Zeigt den Bildschirm "Konten verwalten" an.
ShowManageAccountsForUserAsync(User)	Zeigt den Bildschirm "Konten verwalten" für den angegebenen Benutzer an.

Ereignisse

AccountCommandsRequested

Tritt auf, wenn der Benutzer den Kontobereich öffnet. Die Behandlung dieses Ereignisses ermöglicht es der App, die Kontenbefehle zu initialisieren und die Benutzeroberfläche anzuhalten, bis der Benutzer den Bereich schließt.

Gilt für:

Freigeben über