다음을 통해 공유


WindowsFormsApplicationBase.StartupNextInstance 이벤트

정의

단일 인스턴스 애플리케이션을 시작하려고 할 때 해당 애플리케이션이 이미 활성 상태이면 이 이벤트가 발생합니다.

public:
 event Microsoft::VisualBasic::ApplicationServices::StartupNextInstanceEventHandler ^ StartupNextInstance;
public event Microsoft.VisualBasic.ApplicationServices.StartupNextInstanceEventHandler StartupNextInstance;
member this.StartupNextInstance : Microsoft.VisualBasic.ApplicationServices.StartupNextInstanceEventHandler 
Public Custom Event StartupNextInstance As StartupNextInstanceEventHandler 
Public Event StartupNextInstance As StartupNextInstanceEventHandler 

이벤트 유형

예제

이 예제에서는 합니다 e 의 매개 변수는 StartupNextInstance 애플리케이션의 명령줄 인수를 검사 하는 이벤트 처리기입니다. 로 시작 하는 인수가 있으면 /input=, 인수에 지정 된 나머지 표시 됩니다.

Private Sub MyApplication_StartupNextInstance(
    sender As Object,
    e As Microsoft.VisualBasic.ApplicationServices.StartupNextInstanceEventArgs
) Handles Me.StartupNextInstance
    Dim inputArgument As String = "/input="
    Dim inputName As String = ""

    For Each s As String In e.CommandLine
        If s.ToLower.StartsWith(inputArgument) Then
            inputName = s.Remove(0, inputArgument.Length)
        End If
    Next

    If inputName = "" Then
        MsgBox("No input name")
    Else
        MsgBox("Input name: " & inputName)
    End If
End Sub

애플리케이션 이벤트에 대 한 코드 편집기 창의 코드를 입력 해야 합니다. 이 창에 액세스하려면 이 항목의 설명 섹션의 지침을 따릅니다. 자세한 내용은 Application Page, Project Designer (Visual Basic)을 참조하세요.

설명

단일 인스턴스 애플리케이션에서 발생 된 StartupNextInstance 이미 활성화 된 경우 애플리케이션을 다시 시작 하려고 할 때 이벤트입니다. 단일 인스턴스 애플리케이션을 처음으로 시작 되 면 발생 합니다 Startup 이벤트입니다. 자세한 내용은 Startup를 참조하세요.

이 이벤트는 Visual Basic 애플리케이션 모델의 일부입니다. 자세한 내용은 Visual Basic 애플리케이션 모델 개요합니다.

이 이벤트는 다른 사용자 인터페이스 이벤트를 사용 하 여 애플리케이션의 주 스레드에서 발생 합니다. 따라서 이벤트 처리기를 애플리케이션의 사용자 인터페이스에 직접 액세스할 수 있습니다. 그러나 애플리케이션을이 이벤트가 발생 하면 다른 사용자 인터페이스 이벤트를 처리 하는 경우이 이벤트를 처리할 수 다른 이벤트 처리기를 완료 하거나 호출 된 DoEvents 메서드.

참고

StartupNextInstance 단일 인스턴스 애플리케이션에만 이벤트가 발생 합니다. 애플리케이션에 대 한 단일 인스턴스 동작을 사용 하도록 설정 하려면 체크 인해야 합니다 단일 인스턴스 애플리케이션 프로젝트 디자이너에서 확인란 합니다.

단일 인스턴스 애플리케이션을 확인 하려면
1. 솔루션 탐색기에서 프로젝트를 선택한 상태에서 프로젝트 메뉴에서 속성을 클릭합니다.
2. 애플리케이션 탭을 클릭합니다.
3. 단일 인스턴스 애플리케이션 만들기 확인란을 선택합니다.

사용 해야 합니다는 CommandLine 의 속성은 e 매개 변수를 단일 인스턴스 애플리케이션을 시작을 시도 하기 위해 인수에 액세스 합니다. CommandLineArgs 속성은 단일 인스턴스 애플리케이션의 첫 번째 인스턴스를 시작 하는 데 사용 되는 인수를 제공 합니다.

이벤트 처리기의 코드 StartupNextInstance 는 기본적으로 숨겨져 있는 ApplicationEvents.vb 파일에 저장됩니다.

애플리케이션 이벤트에 대 한 코드 편집기 창에 액세스 하려면
1. 솔루션 탐색기에서 프로젝트를 선택한 상태에서 프로젝트 메뉴에서 속성을 클릭합니다.
2. 애플리케이션 탭을 클릭합니다.
3. 애플리케이션 이벤트 보기 단추를 클릭하여 코드 편집기를 엽니다.

자세한 내용은 Application Page, Project Designer (Visual Basic)을 참조하세요.

다음 표에는 이벤트와 관련된 작업의 예가 나와 있습니다 My.Application.StartupNextInstance .

대상 참조 항목
첫 번째 애플리케이션 인스턴스의 명령줄 인수를 확인 합니다. CommandLineArgs

프로젝트 형식에 따라 가용성

프로젝트 형식 사용 가능
Windows Forms 애플리케이션 Yes
클래스 라이브러리 No
콘솔 애플리케이션 No
Windows Forms 컨트롤 라이브러리 No
웹 컨트롤 라이브러리 No
Windows 서비스 No
웹 사이트 No

적용 대상

추가 정보