Form.ShowAsync(IWin32Window) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Visar formuläret asynkront genom att ange dess Visible egenskap till 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 TaskParametrar
- owner
- IWin32Window
Det valfria ägarfönstret som implementerar IWin32Window.
Returer
En Task som fylls i när formuläret stängs eller tas bort.
- Attribut
Undantag
Formuläret är redan synligt.
-eller-
Formuläret är inaktiverat.
-eller-
Formuläret är inte ett formulär på den översta nivån.
-eller-
Formuläret försöker ange sig själv som sin egen ägare.
-eller-
Formuläret visas redan asynkront.
-eller-
Nej WindowsFormsSynchronizationContext kunde hämtas eller installeras.
-eller-
Operativsystemet är i ett icke-interaktivt läge.
Ägarfönstret försöker ange sig själv som sin egen ägare.
Kommentarer
Den här metoden gör formuläret synligt genom att ställa in egenskapen på Visibletrue.
Den här metoden returnerar omedelbart, även om formuläret är stort och tar lång tid att konfigurera.
Uppgiften slutförs när formuläret stängs eller tas bort.
Om ägarfönstret anges ser det till att ägaren är längst upp och anger ägaren för formuläret.
Den här metoden utför också flera kontroller för att förhindra ogiltiga åtgärder, till exempel att försöka visa ett inaktiverat formulär, försöka visa formuläret när det inte är ett fönster på den översta nivån eller ange formuläret som sin egen ägare.
Om operativsystemet är i ett icke-interaktivt läge genererar den här metoden en InvalidOperationException.
Om formuläret redan visas asynkront utlöses ett InvalidOperationException .
Ett InvalidOperationException inträffar också om det inte går att hämta eller installera något WindowsFormsSynchronizationContext .
Du behöver inte konvertera anropet till användargränssnittstråden manuellt om anropet kommer från en annan tråd än UI-Thread. Detta hanteras automatiskt.
