Form.ShowAsync(IWin32Window) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Zobrazí formulář asynchronně nastavením jeho Visible vlastnosti na 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 TaskParametry
- owner
- IWin32Window
Volitelné okno vlastníka, které implementuje IWin32Window.
Návraty
A Task , který se dokončí po zavření nebo odstranění formuláře.
- Atributy
Výjimky
Formulář je již viditelný.
nebo
Formulář je zakázaný.
nebo
Formulář není formulář nejvyšší úrovně.
nebo
Formulář se snaží nastavit jako vlastního vlastníka.
nebo
Formulář je již zobrazen asynchronně.
nebo
Nelze WindowsFormsSynchronizationContext načíst ani nainstalovat.
nebo
Operační systém je v neinteraktivním režimu.
Okno vlastníka se pokouší nastavit jako vlastního vlastníka.
Poznámky
Tato metoda zviditelní formulář nastavením Visible vlastnosti na true.
Tato metoda okamžitě vrátí, i když je formulář velký a trvá dlouhou dobu, než se nastaví.
Úkol se dokončí po zavření nebo odstranění formuláře.
Pokud je okno vlastníka k dispozici, zajistí, že je vlastník nejvíce nahoře a nastaví vlastníka formuláře.
Tato metoda také provádí několik kontrol, aby se zabránilo neplatným operacím, jako je například pokus o zobrazení zakázaného formuláře, pokus o zobrazení formuláře, pokud se nejedná o okno nejvyšší úrovně nebo nastavení formuláře jako vlastního vlastníka.
Pokud je operační systém v neinteraktivním režimu, tato metoda vyvolá InvalidOperationExceptionvýjimku .
Pokud je formulář již zobrazen asynchronně, vyvolá se vyvolá InvalidOperationException .
K InvalidOperationException chybě dojde také v případě, že není WindowsFormsSynchronizationContext možné načíst ani nainstalovat.
Volání vlákna uživatelského rozhraní není nutné zařadovat ručně, pokud volání pochází z jiného vlákna než vlákno uživatelského rozhraní. To se zpracovává automaticky.
