WindowsFormsApplicationBase.StartupNextInstance Zdarzenie
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Występuje podczas próby uruchomienia aplikacji pojedynczego wystąpienia, a aplikacja jest już aktywna.
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
Typ zdarzenia
Przykłady
W tym przykładzie użyto e
parametru StartupNextInstance procedury obsługi zdarzeń do zbadania argumentów wiersza polecenia aplikacji. Jeśli zostanie znaleziony argument rozpoczynający się od /input=
, zostanie wyświetlona reszta tego argumentu.
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
Musisz wprowadzić kod w oknie Kod Redaktor dla zdarzeń aplikacji. Aby uzyskać dostęp do tego okna, postępuj zgodnie z instrukcjami w sekcji Uwagi w tym temacie. Aby uzyskać więcej informacji, zobacz Strona aplikacji, Projekt Designer (Visual Basic).
Uwagi
Aplikacja z jednym wystąpieniem zgłasza StartupNextInstance zdarzenie podczas próby ponownego uruchomienia aplikacji, gdy jest już aktywna. Gdy aplikacja z jednym wystąpieniem jest uruchamiana po raz pierwszy, zgłasza Startup zdarzenie. Aby uzyskać więcej informacji, zobacz Startup.
To zdarzenie jest częścią modelu aplikacji Visual Basic. Aby uzyskać więcej informacji, zobacz Omówienie modelu aplikacji Visual Basic.
To zdarzenie jest wywoływane w głównym wątku aplikacji z innymi zdarzeniami interfejsu użytkownika. Dzięki temu program obsługi zdarzeń może uzyskiwać dostęp bezpośrednio do interfejsu użytkownika aplikacji. Jeśli jednak aplikacja jest zajęta obsługą innego zdarzenia interfejsu użytkownika po wywołaniu tego zdarzenia, nie można przetworzyć tego zdarzenia do momentu zakończenia lub wywołania metody przez inną procedurę obsługi zdarzeń DoEvents .
Uwaga
Zdarzenie StartupNextInstance
jest wywoływane tylko w aplikacjach z jednym wystąpieniem. Aby włączyć zachowanie pojedynczego wystąpienia dla aplikacji, należy zaznaczyć pole wyboru Utwórz aplikację pojedynczego wystąpienia w Designer programu Project.
Aby tworzyć pojedyncze wystąpienie aplikacji |
1. Po wybraniu projektu w Eksplorator rozwiązań kliknij pozycję Właściwości w menu Projekt. 2. Kliknij kartę Aplikacja . 3. Zaznacz pole wyboru Utwórz aplikację pojedynczego wystąpienia . |
Aby uzyskać dostęp do argumentów kolejnych prób uruchomienia aplikacji z jednym wystąpieniem, należy użyć CommandLine właściwości parametru e
. Właściwość CommandLineArgs udostępnia argumenty używane do uruchamiania pierwszego wystąpienia aplikacji pojedynczego wystąpienia.
Kod programu obsługi zdarzeń StartupNextInstance jest przechowywany w pliku ApplicationEvents.vb, który jest domyślnie ukryty.
Aby uzyskać dostęp do okna kod Redaktor dla zdarzeń aplikacji |
1. Po wybraniu projektu w Eksplorator rozwiązań kliknij pozycję Właściwości w menu Projekt. 2. Kliknij kartę Aplikacja . 3. Kliknij przycisk Wyświetl zdarzenia aplikacji, aby otworzyć Redaktor kodu. Aby uzyskać więcej informacji, zobacz Strona aplikacji, Projekt Designer (Visual Basic). |
W poniższej tabeli wymieniono przykłady zadań obejmujących My.Application.StartupNextInstance
zdarzenie.
Działanie | Zobacz |
---|---|
Sprawdź argumenty wiersza polecenia pierwszego wystąpienia aplikacji | CommandLineArgs |
Dostępność według typu projektu
Project type (Typ projektu) | Dostępne |
---|---|
Aplikacja interfejsu Windows Forms | Tak |
Biblioteka klas | Nie |
Aplikacja konsoli | Nie |
Biblioteka formantów interfejsu Windows Forms | Nie |
Biblioteka formantów sieci Web | Nie |
Usługa systemu Windows | Nie |
Witryna sieci Web | Nie |
Dotyczy
Zobacz też
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla