Form.ShowAsync(IWin32Window) Metodo
Definizione
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.
Visualizza il form in modo asincrono impostandone la Visible proprietà su true.
public System.Threading.Tasks.Task ShowAsync(System.Windows.Forms.IWin32Window? owner = default);[System.Diagnostics.CodeAnalysis.Experimental("WFO5002", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public System.Threading.Tasks.Task ShowAsync(System.Windows.Forms.IWin32Window? owner = default);member this.ShowAsync : System.Windows.Forms.IWin32Window -> System.Threading.Tasks.Task[<System.Diagnostics.CodeAnalysis.Experimental("WFO5002", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
member this.ShowAsync : System.Windows.Forms.IWin32Window -> System.Threading.Tasks.TaskPublic Function ShowAsync (Optional owner As IWin32Window = Nothing) As TaskParametri
- owner
- IWin32Window
Finestra del proprietario facoltativa che implementa IWin32Window.
Valori restituiti
Oggetto Task che viene completato quando il modulo viene chiuso o eliminato.
- Attributi
Eccezioni
Il modulo è già visibile.
oppure
Il modulo è disabilitato.
oppure
Il modulo non è un modulo di primo livello.
oppure
Il modulo sta tentando di impostarsi come proprietario.
oppure
Il modulo è già visualizzato in modo asincrono.
oppure
Non WindowsFormsSynchronizationContext è possibile recuperare o installare.
oppure
Il sistema operativo è in modalità non interattiva.
La finestra del proprietario sta tentando di impostarsi come proprietario.
Commenti
Questo metodo rende visibile il form impostando la Visible proprietà su true.
Questo metodo restituisce immediatamente, anche se la maschera è grande e richiede molto tempo per la configurazione.
L'attività verrà completata quando il modulo viene chiuso o eliminato.
Se viene specificata la finestra del proprietario, garantisce che il proprietario sia in primo piano e imposti il proprietario per il modulo.
Questo metodo esegue anche diversi controlli per impedire operazioni non valide, ad esempio il tentativo di visualizzare un modulo disabilitato, il tentativo di visualizzare il modulo quando non è una finestra di primo livello o impostando il modulo come proprietario.
Se il sistema operativo è in modalità non interattiva, questo metodo genererà un'eccezione InvalidOperationException.
Se il modulo è già visualizzato in modo asincrono, verrà generata un'eccezione InvalidOperationException .
Si InvalidOperationException verificherà anche se non WindowsFormsSynchronizationContext è possibile recuperare o installare .
Non è necessario effettuare manualmente il marshalling della chiamata al thread dell'interfaccia utente se la chiamata ha origine da un thread diverso rispetto a UI-Thread. Questa operazione viene gestita automaticamente.
