Form.ShowAsync(IWin32Window) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
Visible プロパティを 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 Taskパラメーター
- owner
- IWin32Window
IWin32Windowを実装する省略可能な所有者ウィンドウ。
返品
フォームが閉じられたり破棄されたりしたときに完了する Task 。
- 属性
例外
フォームは既に表示されています。
-又は-
フォームは無効になっています。
-又は-
フォームは最上位レベルのフォームではありません。
-又は-
フォーム自体を独自の所有者として設定しようとしています。
-又は-
フォームは既に非同期的に表示されています。
-又は-
WindowsFormsSynchronizationContextを取得またはインストールできませんでした。
-又は-
オペレーティング システムは非対話型モードです。
所有者ウィンドウは、自身を独自の所有者として設定しようとしています。
注釈
このメソッドは、 Visible プロパティを true に設定してフォームを表示します。
フォームが大きく、設定に時間がかかる場合でも、このメソッドは直ちに戻ります。
フォームが閉じられたり破棄されたりすると、タスクは完了します。
所有者ウィンドウが指定されている場合は、所有者が最上位であることを確認し、フォームの所有者を設定します。
このメソッドは、無効なフォームの表示、最上位のウィンドウでない場合のフォームの表示の試行、フォームを独自の所有者として設定するなど、無効な操作を防ぐためのいくつかのチェックも実行します。
オペレーティング システムが非対話型モードの場合、このメソッドは InvalidOperationExceptionをスローします。
フォームが既に非同期的に表示されている場合は、 InvalidOperationException がスローされます。
WindowsFormsSynchronizationContextを取得またはインストールできない場合も、InvalidOperationExceptionが発生します。
UI スレッドとは別のスレッドから呼び出しが発生した場合、UI スレッドへの呼び出しを手動でマーシャリングする必要はありません。 これは自動的に処理されます。
