SystemEvents.SessionEnding Olay

Tanım

Ad Alanı:

Microsoft.Win32

Bütünleştirilmiş Kod:

Microsoft.Win32.SystemEvents.dll

Paket:

Microsoft.Win32.SystemEvents v8.0.0

Kaynak:

SystemEvents.cs

Kullanıcı sistemi kapatmaya veya kapatmaya çalıştığında gerçekleşir.

public:
 static event Microsoft::Win32::SessionEndingEventHandler ^ SessionEnding;

public static event Microsoft.Win32.SessionEndingEventHandler? SessionEnding;

member this.SessionEnding : Microsoft.Win32.SessionEndingEventHandler 

Public Shared Custom Event SessionEnding As SessionEndingEventHandler 

Olay Türü

SessionEndingEventHandler

Özel durumlar

InvalidOperationException

Sistem olayı bildirimleri geçerli bağlam altında desteklenmiyor. Örneğin sunucu işlemleri genel sistem olay bildirimlerini desteklemeyebilir.

ExternalException

Sistem olayları penceresi iş parçacığı oluşturma girişimi başarısız oldu.

Açıklamalar

Bu iptal edilebilir bir olaydır. özelliğinin Canceltrue olarak ayarlanması, oturumun çalışmaya devam etmesi isteğinde bulunur. Oturumun bitmeyeceğini garanti etmemektedir.

Sistem oturumunu kapatma veya yeniden başlatma algılamak için bir Windows formunda kullanıyorsanız SessionEnding , olayın bu olaydan önce tetiklenip tetiklenmeyeceğini belirlemenin Closing belirleyici bir yolu yoktur.

Tetiklenmeden önce Closing bazı özel görevleri gerçekleştirmek istiyorsanız, önce Closingtetiklendiğinden SessionEnding emin olmanız gerekir. Bunu yapmak için işlevini geçersiz kılarak WndProc formda yakalamanız gerekirWM_QUERYENDSESSION. Bu örnek, bunun nasıl yapılacağını gösterir.

Private Shared WM_QUERYENDSESSION As Integer = &H11  
 Private Shared systemShutdown As Boolean = False  
 Protected Overrides Sub WndProc(ByRef m As System.Windows.Forms.Message)  
     If m.Msg = WM_QUERYENDSESSION Then  
         MessageBox.Show("queryendsession: this is a logoff, shutdown, or reboot")  
         systemShutdown = True  
     End If  
     ' If this is WM_QUERYENDSESSION, the closing event should be raised in the base WndProc.  
     MyBase.WndProc(m)  
 End Sub 'WndProc   
 Private Sub Form1_Closing(ByVal sender As System.Object, ByVal e As System.ComponentModel.CancelEventArgs) Handles MyBase.Closing  
     If (systemShutdown) Then  
     ' Reset the variable because the user might cancel the shutdown.  
         systemShutdown = False  
         If (System.Windows.Forms.DialogResult.Yes = _  
                 MessageBox.Show("My application", "Do you want to save your work before logging off?", MessageBoxButtons.YesNo)) Then  
                 e.Cancel = True  
         Else  
                 e.Cancel = False  
         End If  
     End If  
 End Sub  

private static int WM_QUERYENDSESSION = 0x11;  
private static bool systemShutdown = false;  
protected override void WndProc(ref System.Windows.Forms.Message m)  
{  
    if (m.Msg==WM_QUERYENDSESSION)  
    {  
        MessageBox.Show("queryendsession: this is a logoff, shutdown, or reboot");  
        systemShutdown = true;  
    }  

    // If this is WM_QUERYENDSESSION, the closing event should be  
    // raised in the base WndProc.  
    base.WndProc(ref m);  

} //WndProc   

private void Form1_Closing(  
    System.Object sender,   
    System.ComponentModel.CancelEventArgs e)  
{  
    if (systemShutdown)  
        // Reset the variable because the user might cancel the   
        // shutdown.  
    {  
        systemShutdown = false;  
        if (DialogResult.Yes==MessageBox.Show("My application",   
            "Do you want to save your work before logging off?",   
            MessageBoxButtons.YesNo))  
        {  
            e.Cancel = true;  
        }  
        else  
        {  
            e.Cancel = false;  
        }  
    }  
}  

Önemli

Konsol uygulamaları olayı tetiklemiyor SessionEnding .

Not

Bu olay yalnızca ileti pompası çalışıyorsa oluşturulur. Bir Windows hizmetinde, gizli bir form kullanılmadığı veya ileti pompası el ile başlatılmadığı sürece, bu olay tetiklenmez. Windows hizmetinde gizli bir form kullanarak sistem olaylarının nasıl işlendiğini gösteren bir kod örneği için sınıfına SystemEvents bakın.

Dikkat

Bu statik bir olay olduğundan, uygulamanız atıldığında olay işleyicilerinizi ayırmanız gerekir, aksi takdirde bellek sızıntıları ortaya çıkar.

Ayrıca bkz.

• SessionEndingEventArgs
• SessionEndingEventHandler
• SessionEndReasons