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 양식을 닫거나 삭제할 때 완료되는 A입니다.
- 특성
예외
양식이 이미 표시됩니다.
-또는-
양식을 사용할 수 없습니다.
-또는-
양식이 최상위 폼이 아닙니다.
-또는-
양식이 자체 소유자로 설정하려고 합니다.
-또는-
양식이 이미 비동기적으로 표시됩니다.
-또는-
검색하거나 설치할 수 없습니다 WindowsFormsSynchronizationContext .
-또는-
운영 체제가 비대화형 모드에 있습니다.
소유자 창이 자체 소유자로 설정하려고 합니다.
설명
이 메서드는 속성을 .로 설정하여 폼을 Visible 표시합니다 true.
이 메서드는 폼이 크고 설정하는 데 시간이 오래 걸리는 경우에도 즉시 반환됩니다.
양식이 닫혀 있거나 삭제되면 작업이 완료됩니다.
소유자 창이 제공되면 소유자가 맨 위에 있는지 확인하고 양식의 소유자를 설정합니다.
또한 이 메서드는 사용 안 함 폼을 표시하거나 최상위 창이 아닐 때 폼을 표시하려고 시도하거나 양식을 자체 소유자로 설정하는 등 잘못된 작업을 방지하기 위해 여러 검사를 수행합니다.
운영 체제가 비대화형 모드인 경우 이 메서드는 을 throw합니다 InvalidOperationException.
양식이 이미 비동기적으로 InvalidOperationException 표시되는 경우 throw됩니다.
InvalidOperationException 검색하거나 설치할 수 없는 WindowsFormsSynchronizationContext 경우에도 발생합니다.
호출이 UI-스레드와 다른 스레드에서 발생하는 경우 UI 스레드에 대한 호출을 수동으로 마샬링할 필요가 없습니다. 이 작업은 자동으로 처리됩니다.
