Form.ShowDialogAsync Método

Definição

Espaço de Nomes:: System.Windows.Forms

Assemblagem:: System.Windows.Forms.dll

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.

Sobrecargas

Name	Description
ShowDialogAsync(IWin32Window)	Mostra o formulário como uma caixa de diálogo modal com o proprietário especificado de forma assíncrona.
ShowDialogAsync()	Mostra o formulário como uma caixa de diálogo modal de forma assíncrona.

ShowDialogAsync(IWin32Window)

Origem:: Form.cs

Origem:: Form.cs

Origem:: Form.cs

Mostra o formulário como uma caixa de diálogo modal com o proprietário especificado de forma assíncrona.

public:
 System::Threading::Tasks::Task<System::Windows::Forms::DialogResult> ^ ShowDialogAsync(System::Windows::Forms::IWin32Window ^ owner);

public System.Threading.Tasks.Task<System.Windows.Forms.DialogResult> ShowDialogAsync(System.Windows.Forms.IWin32Window owner);

[System.Diagnostics.CodeAnalysis.Experimental("WFO5002", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public System.Threading.Tasks.Task<System.Windows.Forms.DialogResult> ShowDialogAsync(System.Windows.Forms.IWin32Window owner);

member this.ShowDialogAsync : System.Windows.Forms.IWin32Window -> System.Threading.Tasks.Task<System.Windows.Forms.DialogResult>

[<System.Diagnostics.CodeAnalysis.Experimental("WFO5002", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
member this.ShowDialogAsync : System.Windows.Forms.IWin32Window -> System.Threading.Tasks.Task<System.Windows.Forms.DialogResult>

Public Function ShowDialogAsync (owner As IWin32Window) As Task(Of DialogResult)

Parâmetros

owner: IWin32Window

Qualquer objeto que implemente IWin32Window isso representa a janela de topo que irá possuir a caixa de diálogo modal.

Devoluções

Task<DialogResult>

A Task<TResult> representa o resultado do diálogo. A tarefa é concluída quando o formulário é encerrado ou descartado.

Atributos: ExperimentalAttribute

Exceções

InvalidOperationException

O formulário já está apresentado de forma assíncrona.

-ou-

Nenhum WindowsFormsSynchronizationContext podia ser recuperado ou instalado.

Observações

A tarefa será concluída quando o formulário for encerrado ou descartado.

Este método regressa imediatamente, mesmo que a forma seja grande e demore muito tempo a ser configurada.

Se a forma já for apresentada assíncrona por ShowAsync(IWin32Window), e 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 o thread UI se a chamada tiver origem noutro thread. Isto é tratado automaticamente.

Quaisquer exceções que ocorram serão automaticamente propagadas para a thread que chama.

Aplica-se a

ShowDialogAsync()

Origem:: Form.cs

Origem:: Form.cs

Origem:: Form.cs

Mostra o formulário como uma caixa de diálogo modal de forma assíncrona.

public:
 System::Threading::Tasks::Task<System::Windows::Forms::DialogResult> ^ ShowDialogAsync();

public System.Threading.Tasks.Task<System.Windows.Forms.DialogResult> ShowDialogAsync();

[System.Diagnostics.CodeAnalysis.Experimental("WFO5002", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public System.Threading.Tasks.Task<System.Windows.Forms.DialogResult> ShowDialogAsync();

member this.ShowDialogAsync : unit -> System.Threading.Tasks.Task<System.Windows.Forms.DialogResult>

[<System.Diagnostics.CodeAnalysis.Experimental("WFO5002", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
member this.ShowDialogAsync : unit -> System.Threading.Tasks.Task<System.Windows.Forms.DialogResult>

Public Function ShowDialogAsync () As Task(Of DialogResult)