Form.ShowAsync(IWin32Window) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Apresenta a forma de forma assíncrona, definindo a sua Visible propriedade para 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 TaskParâmetros
- owner
- IWin32Window
A janela opcional do proprietário que implementa IWin32Window.
Devoluções
A Task que se completa quando o formulário é encerrado ou descartado.
- Atributos
Exceções
A forma já é visível.
-ou-
O formulário está desativado.
-ou-
A forma não é uma forma de topo de nível.
-ou-
A forma está a tentar estabelecer-se como dona própria.
-ou-
O formulário já está apresentado de forma assíncrona.
-ou-
Nenhum WindowsFormsSynchronizationContext podia ser recuperado ou instalado.
-ou-
O sistema operativo está num modo não interativo.
A janela do dono está a tentar estabelecer-se como dona própria.
Observações
Este método torna a forma visível ao definir a Visible propriedade para true.
Este método regressa imediatamente, mesmo que a forma seja grande e demore muito tempo a ser configurada.
A tarefa será concluída quando o formulário for encerrado ou descartado.
Se a janela do proprietário for fornecida, garante que o proprietário está no topo e define o dono para o formulário.
Este método também realiza várias verificações para evitar operações inválidas, como tentar mostrar um formulário desativado, tentar mostrar o formulário quando não é uma janela de nível superior, ou definir o formulário como proprietário próprio.
Se o sistema operativo estiver em modo não interativo, este método irá lançar um InvalidOperationException.
Se o formulário já estiver apresentado assíncronamente, an InvalidOperationException será lançado.
InvalidOperationException Também ocorrerá um caso não WindowsFormsSynchronizationContext puder ser recuperado ou instalado.
Não é necessário fazer o marshal manual da chamada para a thread UI se a chamada tiver origem numa thread diferente da thread UI. Isto é tratado automaticamente.
