Form.ShowDialogAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| Имя. | Описание |
|---|---|
| ShowDialogAsync(IWin32Window) |
Отображает форму как модальное диалоговое окно с указанным владельцем асинхронно. |
| ShowDialogAsync() |
Отображает форму как модальное диалоговое окно асинхронно. |
ShowDialogAsync(IWin32Window)
- Исходный код:
- Form.cs
- Исходный код:
- Form.cs
- Исходный код:
- Form.cs
Отображает форму как модальное диалоговое окно с указанным владельцем асинхронно.
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)Параметры
- owner
- IWin32Window
Любой объект, реализующий IWin32Window окно верхнего уровня, которое будет принадлежать модальному диалоговому окну.
Возвращаемое значение
Представляет Task<TResult> результат диалогового окна. Задача завершается при закрытии или удалении формы.
- Атрибуты
Исключения
Форма уже отображается асинхронно.
–или–
Невозможно WindowsFormsSynchronizationContext получить или установить.
Комментарии
Задача завершится, когда форма закрыта или удалена.
Этот метод немедленно возвращается, даже если форма большая и занимает много времени.
Если форма уже отображается асинхронно ShowAsync(IWin32Window), InvalidOperationException создается исключение.
Также возникает, InvalidOperationException если не WindowsFormsSynchronizationContext удалось получить или установить его.
Нет необходимости маршалировать вызов потока пользовательского интерфейса вручную, если вызов происходит из другого потока. Это обрабатывается автоматически.
Все исключения, которые возникают, будут автоматически распространяться в вызывающий поток.
Применяется к
ShowDialogAsync()
- Исходный код:
- Form.cs
- Исходный код:
- Form.cs
- Исходный код:
- Form.cs
Отображает форму как модальное диалоговое окно асинхронно.
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)Возвращаемое значение
Представляет Task<TResult> результат диалогового окна. Задача завершается при закрытии или удалении формы.
- Атрибуты
Исключения
Форма уже отображается асинхронно.
–или–
Невозможно WindowsFormsSynchronizationContext получить или установить.
Комментарии
Задача завершится, когда форма закрыта или удалена.
Этот метод немедленно возвращается, даже если форма большая и занимает много времени.
Если форма уже отображается асинхронно ShowAsync(IWin32Window), InvalidOperationException создается исключение.
Также возникает, InvalidOperationException если не WindowsFormsSynchronizationContext удалось получить или установить его.
Нет необходимости маршалировать вызов потока пользовательского интерфейса вручную, если вызов происходит из другого потока. Это обрабатывается автоматически.
Все исключения, которые возникают, будут автоматически распространяться в вызывающий поток.
