WindowsFormsApplicationBase.StartupNextInstance Olay

  • Başvuru

Tanım

Ad Alanı:
Microsoft.VisualBasic.ApplicationServices
Bütünleştirilmiş Kod:
Microsoft.VisualBasic.dll
Bütünleştirilmiş Kod:
Microsoft.VisualBasic.Forms.dll

Tek örnekli bir uygulamayı başlatmaya çalışırken ve uygulama zaten etkin olduğunda gerçekleşir.

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

Olay Türü

StartupNextInstanceEventHandler

Örnekler

Bu örnek, uygulamanın komut satırı bağımsız değişkenlerini incelemek için olay işleyicisinin parametresini StartupNextInstance kullanıre. ile /input=başlayan bir bağımsız değişken bulunursa, bu bağımsız değişkenin geri kalanı görüntülenir.

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

Kodu uygulama olayları için Kod Düzenleyici penceresine girmeniz gerekir. Bu pencereye erişmek için bu konunun Açıklamalar bölümündeki yönergeleri izleyin. Daha fazla bilgi için bkz. Uygulama Sayfası, Project Designer (Visual Basic).

Açıklamalar

Tek örnekli bir uygulama, zaten etkin olduğunda uygulamayı yeniden başlatmayı denediğinizde olayı tetikler StartupNextInstance . Tek örnekli bir uygulama ilk kez başlatıldığında olayı tetikler Startup . Daha fazla bilgi için bkz. Startup.

Bu olay, Visual Basic Uygulama modelinin bir parçasıdır. Daha fazla bilgi için bkz. Visual Basic Uygulama Modeline Genel Bakış.

Bu olay, uygulamanın ana iş parçacığında diğer kullanıcı arabirimi olaylarıyla oluşturulur. Bu, olay işleyicisinin doğrudan uygulamanın kullanıcı arabirimine erişmesini sağlar. Ancak, bu olay tetiklendiğinde uygulama başka bir kullanıcı arabirimi olayını işlemekle meşgulse, diğer olay işleyicisi yöntemi bitirene veya çağırana DoEvents kadar bu olay işlenemez.

Not

Olay StartupNextInstance yalnızca tek örnekli uygulamalarda oluşturulur. Uygulamanız için tek örnekli davranışı etkinleştirmek için Project Designer'nde Tek örnekli uygulama yap onay kutusunu işaretlemeniz gerekir.
Bir uygulamayı tek örnek yapmak için
1. Çözüm Gezgini'de bir proje seçiliyken, Proje menüsünde Özellikler'e tıklayın.
2. Uygulama sekmesine tıklayın.
3. Tek örnekli uygulama yap onay kutusunu seçin.

Tek örnekli bir uygulamayı başlatmayı izleyen girişimler için bağımsız değişkenlere erişmek için parametresinin e özelliğini kullanmanız CommandLine gerekir. özelliği, CommandLineArgs tek örnekli bir uygulamanın ilk örneğini başlatmak için kullanılan bağımsız değişkenleri sağlar.

Olay işleyicisinin StartupNextInstance kodu, varsayılan olarak gizlenen ApplicationEvents.vb dosyasında depolanır.
Uygulama olaylarının Kod Düzenleyici penceresine erişmek için
1. Çözüm Gezgini'de bir proje seçiliyken, Proje menüsünde Özellikler'e tıklayın.
2. Uygulama sekmesine tıklayın.
3. Kod Düzenleyici açmak için Uygulama Olaylarını Görüntüle düğmesine tıklayın.

Daha fazla bilgi için bkz. Uygulama Sayfası, Project Designer (Visual Basic).

Aşağıdaki tabloda, olayla ilgili görev örnekleri liste verilmiştir My.Application.StartupNextInstance .

Amaç Bkz.
İlk uygulama örneğinin komut satırı bağımsız değişkenlerini denetleyin CommandLineArgs

Proje Türüne Göre Kullanılabilirlik

Proje türü Kullanılabilir
Windows Forms Uygulaması Yes
Sınıf Kitaplığı No
Konsol Uygulaması No
Windows Forms Denetim Kitaplığı No
Web Denetim Kitaplığı No
Windows Hizmeti No
Web Sitesi No

Şunlara uygulanır

Ayrıca bkz.