AccountsSettingsPane 类

定义

命名空间:

Windows.UI.ApplicationSettings

提供用于显示“帐户”窗格以及使应用能够在即将显示帐户浮出控件时注册回调的方法。

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

继承

Object Platform::Object IInspectable AccountsSettingsPane

属性

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

应用为应用显示的所有 Web 帐户提供程序、Web 帐户、全局帐户命令和凭据保险箱凭据提供包含帐户元数据的回调。 帐户提供商的示例包括 Facebook、LinkedIn 和 Twitter。

Windows.UI.ApplicationSettings 命名空间中的帐户和凭据命令类对应于 Windows.UI.ApplicationSettings 命名空间中的数据对象：

数据对象 (Windows.Security.Credentials)	ui 对象 (Windows.UI.ApplicationSettings)
WebAccount	WebAccountCommand
WebAccountProvider	WebAccountProviderCommand
PasswordCredential	CredentialCommand

桌面应用程序

对于桌面应用，你需要使用互操作 API，而不是使用 AccountSettingsPane 类，如下所述。

• 首先 (HWND) 检索窗口句柄 。 该主题包含 Windows UI 库 (WinUI) 3、Windows Presentation Foundation (WPF) 和 Windows 窗体 (WinForms) 的代码示例。 将该代码插入以下代码列表。
• 应在桌面应用中使用 IAccountSettingsPaneInterop 接口。 对于使用 .NET 6 或更高版本的 C# 应用， 可以使用 AccountSettingsPaneInterop 类。 有关 C# 互操作类的详细信息，请参阅 从 .NET 5+ 应用调用互操作 API。 另请参阅 显示依赖于 CoreWindow 的 WinRT UI 对象。

下面是有关如何在 C# (.NET 6 或更高版本中使用 AccountSettingsPaneInterop 类的示例) ：

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);
}

版本历史记录

Windows 版本	SDK 版本	已添加值
1607	14393	ShowAddAccountAsync
1607	14393	ShowManageAccountsAsync
1803	17134	ShowAddAccountForUserAsync
1803	17134	ShowManageAccountsForUserAsync

方法

GetForCurrentView()	获取与当前应用视图关联的 AccountsSettingsPane 对象 (即 CoreWindow) 。
Show()	显示“帐户设置”窗格。
ShowAddAccountAsync()	显示“添加帐户”屏幕。
ShowAddAccountForUserAsync(User)	显示指定用户的“添加帐户”屏幕。
ShowManageAccountsAsync()	显示“管理帐户”屏幕。
ShowManageAccountsForUserAsync(User)	显示指定用户的“管理帐户”屏幕。

事件

AccountCommandsRequested

当用户打开“帐户”窗格时发生。 处理此事件可让应用初始化帐户命令并暂停其 UI，直到用户关闭窗格。

另请参阅

• PasswordCredential
• WebAccountProvider
• WebAccount