AccountsSettingsPane Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.UI.ApplicationSettings

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Fornisce metodi per visualizzare il riquadro degli account e anche per consentire all'app di registrare i callback quando l'area a comparsa degli account sta per essere visualizzata.

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

Ereditarietà: Object Platform::Object IInspectable AccountsSettingsPane

Attributi: ContractVersionAttribute MarshalingBehaviorAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

L'app fornisce i callback con metadati dell'account per tutti i provider di account Web, gli account Web, i comandi dell'account globale e le credenziali che l'app visualizza. Esempi di provider di account sono Facebook, LinkedIn e Twitter.

Le classi di comando account e credenziali nello spazio dei nomi Windows.UI.ApplicationSettings corrispondono agli oggetti dati nello spazio dei nomi Windows.UI.ApplicationSettings :

Oggetto dati (Windows.Security.Credentials)	Oggetto ui (Windows.UI.ApplicationSettings)
WebAccount	WebAccountCommand
WebAccountProvider	WebAccountProviderCommand
PasswordCredential	CredentialCommand

Applicazioni desktop

Per un'app desktop, anziché usare la classe AccountSettingsPane, è necessario usare l'API di interoperabilità come descritto di seguito.

Recuperare prima di tutto un handle di finestra (HWND). Questo argomento contiene esempi di codice per Windows UI Library (WinUI) 3, Windows Presentation Foundation (WPF) e Windows Forms (WinForms). Collegare tale codice all'elenco di codice riportato di seguito.
È consigliabile usare l'interfaccia IAccountSettingsPaneInterop nell'app desktop. Per le app C# che usano .NET 6 o versioni successive, la classe AccountSettingsPaneInterop è disponibile. Per altre informazioni sulle classi di interoperabilità C#, vedere Chiamare API di interoperabilità da un'app .NET 5+ . Vedere Anche visualizzare oggetti dell'interfaccia utente WinRT che dipendono da CoreWindow.

Di seguito è riportato un esempio su come usare la classe AccountSettingsPaneInterop in C# (.NET 6 o versione successiva):

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

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1607	14393	ShowAddAccountAsync
1607	14393	ShowManageAccountsAsync
1803	17134	ShowAddAccountForUserAsync
1803	17134	ShowManageAccountsForUserAsync

Metodi

GetForCurrentView()	Ottiene un oggetto AccountsSettingsPane associato alla visualizzazione dell'app corrente, ovvero con CoreWindow.
Show()	Visualizza il riquadro delle impostazioni dell'account.
ShowAddAccountAsync()	Visualizza la schermata Aggiungi account.
ShowAddAccountForUserAsync(User)	Visualizza la schermata Aggiungi account per l'utente specificato.
ShowManageAccountsAsync()	Visualizza la schermata Gestisci account.
ShowManageAccountsForUserAsync(User)	Visualizza la schermata Gestisci account per l'utente specificato.

Eventi

AccountCommandsRequested

Si verifica quando l'utente apre il riquadro account. La gestione di questo evento consente all'app di inizializzare i comandi degli account e sospendere l'interfaccia utente fino a quando l'utente chiude il riquadro.

Si applica a

Condividi tramite