SystemEvents Klasse

Definition

Namespace:

Microsoft.Win32

Assembly:

Microsoft.Win32.SystemEvents.dll

Paket:

Microsoft.Win32.SystemEvents v8.0.0

Quelle:

SystemEvents.cs

Ermöglicht den Zugriff auf Systemereignisbenachrichtigungen. Diese Klasse kann nicht vererbt werden.

public ref class SystemEvents sealed

public sealed class SystemEvents

type SystemEvents = class

Public NotInheritable Class SystemEvents

Vererbung

Object

SystemEvents

Beispiele

Dieser Abschnitt enthält zwei Beispiele. Das erste Beispiel zeigt, wie Systemereignisse in einer gewöhnlichen Anwendung verwendet werden, und das zweite Beispiel zeigt, wie Systemereignisse in einem Windows-Dienst verwendet werden.

Beispiel 1

Im folgenden Codebeispiel wird das Interesse an einigen Systemereignissen registriert und dann darauf gewartet, dass eines dieser Ereignisse eintritt. Die angezeigte Ausgabe tritt auf, wenn der Benutzer die Anzeigeauflösung ändert.

#using <System.dll>

using namespace System;
using namespace Microsoft::Win32;

// This method is called when a user preference changes.
void SystemEvents_UserPreferenceChanging(Object^ sender,
     UserPreferenceChangingEventArgs^ e)
 {
     Console::WriteLine("The user preference is changing. Category={0}",
         e->Category);
 }

// This method is called when the palette changes.
void SystemEvents_PaletteChanged(Object^ sender, EventArgs^ e)
{
    Console::WriteLine("The palette changed.");
}

// This method is called when the display settings change.
void SystemEvents_DisplaySettingsChanged(Object^ sender,
    EventArgs^ e)
{
    Console::WriteLine("The display settings changed.");
}

int main()
{
    // Set the SystemEvents class to receive event notification
    // when a user preference changes, the palette changes, or
    // when display settings change.
    SystemEvents::UserPreferenceChanging += gcnew
        UserPreferenceChangingEventHandler(
        SystemEvents_UserPreferenceChanging);
    SystemEvents::PaletteChanged += gcnew
        EventHandler(SystemEvents_PaletteChanged);
    SystemEvents::DisplaySettingsChanged += gcnew
        EventHandler(SystemEvents_DisplaySettingsChanged);

    // For demonstration purposes, this application sits idle
    // waiting for events.
    Console::WriteLine("This application is waiting for system events.");
    Console::WriteLine("Press <Enter> to terminate this application.");
    Console::ReadLine();
}

// This code produces the following output.
//
//  This app is waiting for system events.
//  Press <Enter> to terminate this application.
//  Display Settings changed.
//  User preference is changing. Category=General

using System;
using Microsoft.Win32;

public sealed class App 
{
    static void Main() 
    {         
        // Set the SystemEvents class to receive event notification when a user 
        // preference changes, the palette changes, or when display settings change.
        SystemEvents.UserPreferenceChanging += new 
            UserPreferenceChangingEventHandler(SystemEvents_UserPreferenceChanging);
        SystemEvents.PaletteChanged += new 
            EventHandler(SystemEvents_PaletteChanged);
        SystemEvents.DisplaySettingsChanged += new 
            EventHandler(SystemEvents_DisplaySettingsChanged);        

        // For demonstration purposes, this application sits idle waiting for events.
        Console.WriteLine("This application is waiting for system events.");
        Console.WriteLine("Press <Enter> to terminate this application.");
        Console.ReadLine();
    }

    // This method is called when a user preference changes.
    static void SystemEvents_UserPreferenceChanging(object sender, UserPreferenceChangingEventArgs e) 
    {
        Console.WriteLine("The user preference is changing. Category={0}", e.Category);
    }

    // This method is called when the palette changes.
    static void SystemEvents_PaletteChanged(object sender, EventArgs e)
    {
        Console.WriteLine("The palette changed.");
    }

    // This method is called when the display settings change.
    static void SystemEvents_DisplaySettingsChanged(object sender, EventArgs e)
    {
        Console.WriteLine("The display settings changed.");
    }
}

// This code produces the following output.
// 
//  This app is waiting for system events.
//  Press <Enter> to terminate this application.
//  Display Settings changed.
//  User preference is changing. Category=General

Imports Microsoft.Win32
Imports System.Windows.Forms

Friend Class Form1
    Inherits System.Windows.Forms.Form


    Public Sub New()
        MyBase.New()

        'This call is required by the Windows Form Designer.
        InitializeComponent()

        'Set the SystemEvents class to receive event notification 
        'when a user preference changes, the palette changes, or 
        'when display settings change.
        AddHandler SystemEvents.UserPreferenceChanging, _
        AddressOf SystemEvents_UserPreferenceChanging

        AddHandler SystemEvents.PaletteChanged, _
        AddressOf SystemEvents_PaletteChanged

        AddHandler SystemEvents.DisplaySettingsChanged, _
        AddressOf SystemEvents_DisplaySettingsChanged

    End Sub

    'Form overrides dispose to clean up the component list.
    Protected Overloads Overrides Sub Dispose(ByVal disposing As Boolean)
        If disposing Then
            If (components IsNot Nothing) Then
                components.Dispose()
            End If
        End If
        MyBase.Dispose(disposing)
    End Sub


    Private components As System.ComponentModel.IContainer

    <System.Diagnostics.DebuggerStepThrough()> Private Sub InitializeComponent()

        Me.SuspendLayout()

        '
        'Form1
        '
        Me.ClientSize = New System.Drawing.Size(648, 398)
        Me.Name = "Form1"
        Me.Text = "Form1"
        Me.ResumeLayout(False)

    End Sub


    ' This method is called when a user preference changes.
    Private Sub SystemEvents_UserPreferenceChanging( _
    ByVal sender As Object, _
    ByVal e As UserPreferenceChangingEventArgs)

        MessageBox.Show("UserPreferenceChanging: " & _
        e.Category.ToString())
    End Sub


    ' This method is called when the palette changes.
    Private Sub SystemEvents_PaletteChanged( _
    ByVal sender As Object, _
    ByVal e As EventArgs)

        MessageBox.Show("PaletteChanged")

    End Sub


    ' This method is called when the display settings change.
    Private Sub SystemEvents_DisplaySettingsChanged( _
    ByVal sender As Object, _
    ByVal e As EventArgs)

        MessageBox.Show("The display settings changed.")

    End Sub

End Class

Beispiel 2

Das folgende Codebeispiel veranschaulicht einen sehr einfachen Windows-Dienst, der die TimeChanged Ereignisse und UserPreferenceChanged verarbeitet. Das Beispiel enthält einen Dienst namens SimpleService, ein Formular namens HiddenFormund ein Installationsprogramm. Das Formular stellt die Nachrichtenschleife bereit, die für Systemereignisse erforderlich ist.

Hinweis

Dienste verfügen nicht über Nachrichtenschleifen, es sei denn, sie dürfen mit dem Desktop interagieren. Wenn die Nachrichtenschleife nicht von einem ausgeblendeten Formular bereitgestellt wird, wie in diesem Beispiel, muss der Dienst unter dem lokalen Systemkonto ausgeführt werden, und es ist ein manueller Eingriff erforderlich, um die Interaktion mit dem Desktop zu ermöglichen. Das heißt, der Administrator muss das Kontrollkästchen Dienstinteraktionen mit Desktop zulassen auf der Registerkarte Anmelden des Dialogfelds Diensteigenschaften manuell aktivieren. In diesem Fall wird automatisch eine Nachrichtenschleife bereitgestellt. Diese Option ist nur verfügbar, wenn der Dienst unter dem lokalen Systemkonto ausgeführt wird. Die Interaktion mit dem Desktop kann nicht programmgesteuert aktiviert werden.

Der Dienst in diesem Beispiel startet einen Thread, der eine instance von HiddenFormausführt. Die Ereignisse werden im Formular eingebunden und behandelt. Die Ereignisse müssen im Ladeereignis des Formulars eingebunden werden, um sicherzustellen, dass das Formular zuerst vollständig geladen wird. Andernfalls werden die Ereignisse nicht ausgelöst.

Hinweis

Das Beispiel enthält den gesamten erforderlichen Code, einschließlich des Formularinitialisierungscodes, der in der Regel von Visual Studio-Designern generiert wird. Wenn Sie Ihren Dienst in Visual Studio entwickeln, können Sie die zweite partielle Klasse weglassen und das Eigenschaftenfenster verwenden, um die Höhe und Breite des ausgeblendeten Formulars auf Null, die Rahmenart auf FormBorderStyle.Noneund den Fensterzustand auf festzulegen FormWindowState.Minimized.

So führen Sie das Beispiel aus

1. Kompilieren Sie den Code über die Befehlszeile. Der Name, den Sie für die Quelldatei verwenden, ist nicht wichtig.

2. Installieren Sie den Dienst über die Befehlszeile, indem Sie das HilfsprogrammInstallutil.exe (Installer Tool) verwenden. Beispielsweise, InstallUtil example.exe wenn der Name der Quelldatei oder example.vblautetexample.cs. Sie müssen ein Administrator sein, um den Dienst installieren zu können.

3. Verwenden Sie die Dienstkonsole, um den Dienst zu starten.

4. Ändern Sie die Systemzeit, oder ändern Sie Benutzereinstellungen, z. B. Mauseigenschaften.

5. Zeigen Sie die Nachrichten in der Kategorie Anwendung von Ereignisanzeige an.

6. Verwenden Sie die Dienstkonsole, um den Dienst zu beenden.

7. Deinstallieren Sie den Dienst über die Befehlszeile, indem Sie die /u Option verwenden. Beispiel: InstallUtil /u example.exe.

using System;
using System.ServiceProcess;
using System.Threading;
using System.Windows.Forms;
using System.Diagnostics;
using Microsoft.Win32;
using System.ComponentModel;
using System.Configuration.Install;

namespace SimpleServiceCs
{
    public class SimpleService : ServiceBase
    {
        static void Main(string[] args)
        {
            ServiceBase.Run(new SimpleService());
        }

        protected override void OnStart(string[] args)
        {
            EventLog.WriteEntry("SimpleService", "Starting SimpleService");
            new Thread(RunMessagePump).Start();
        }

        void RunMessagePump()
        {
            EventLog.WriteEntry("SimpleService.MessagePump", "Starting SimpleService Message Pump");
            Application.Run(new HiddenForm());
        }

        protected override void OnStop()
        {
            Application.Exit();
        }
    }

    public partial class HiddenForm : Form
    {
        public HiddenForm()
        {
            InitializeComponent();
        }

        private void HiddenForm_Load(object sender, EventArgs e)
        {
            SystemEvents.TimeChanged += new EventHandler(SystemEvents_TimeChanged);
            SystemEvents.UserPreferenceChanged += new UserPreferenceChangedEventHandler(SystemEvents_UPCChanged);
        }

        private void HiddenForm_FormClosing(object sender, FormClosingEventArgs e)
        {
            SystemEvents.TimeChanged -= new EventHandler(SystemEvents_TimeChanged);
            SystemEvents.UserPreferenceChanged -= new UserPreferenceChangedEventHandler(SystemEvents_UPCChanged);
        }

        private void SystemEvents_TimeChanged(object sender, EventArgs e)
        {
            EventLog.WriteEntry("SimpleService.TimeChanged", "Time changed; it is now " +
                DateTime.Now.ToLongTimeString());
        }

        private void SystemEvents_UPCChanged(object sender, UserPreferenceChangedEventArgs e)
        {
            EventLog.WriteEntry("SimpleService.UserPreferenceChanged", e.Category.ToString());
        }
    }

    partial class HiddenForm
    {
        private System.ComponentModel.IContainer components = null;

        protected override void Dispose(bool disposing)
        {
            if (disposing && (components != null))
            {
                components.Dispose();
            }
            base.Dispose(disposing);
        }

        private void InitializeComponent()
        {
            this.SuspendLayout();
            this.AutoScaleDimensions = new System.Drawing.SizeF(6F, 13F);
            this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font;
            this.ClientSize = new System.Drawing.Size(0, 0);
            this.FormBorderStyle = System.Windows.Forms.FormBorderStyle.None;
            this.Name = "HiddenForm";
            this.Text = "HiddenForm";
            this.WindowState = System.Windows.Forms.FormWindowState.Minimized;
            this.Load += new System.EventHandler(this.HiddenForm_Load);
            this.FormClosing += new System.Windows.Forms.FormClosingEventHandler(this.HiddenForm_FormClosing);
            this.ResumeLayout(false);
        }
    }

    [RunInstaller(true)]
    public class SimpleInstaller : Installer
    {
        private ServiceInstaller serviceInstaller;
        private ServiceProcessInstaller processInstaller;

        public SimpleInstaller()
        {
            processInstaller = new ServiceProcessInstaller();
            serviceInstaller = new ServiceInstaller();

            // Service will run under system account
            processInstaller.Account = ServiceAccount.LocalSystem;

            // Service will have Start Type of Manual
            serviceInstaller.StartType = ServiceStartMode.Automatic;

            serviceInstaller.ServiceName = "Simple Service";

            Installers.Add(serviceInstaller);
            Installers.Add(processInstaller);
        }
    }
}

Imports System.ServiceProcess
Imports System.Threading
Imports System.Windows.Forms
Imports System.Diagnostics
Imports Microsoft.Win32
Imports System.ComponentModel
Imports System.Configuration.Install

Namespace SimpleServiceVb
    Public Class SimpleService
        Inherits ServiceBase
    
        Shared Sub Main(ByVal args() As String) 
            ServiceBase.Run(New SimpleService())
        End Sub
    
        Protected Overrides Sub OnStart(ByVal args() As String) 
            EventLog.WriteEntry("SimpleService", "Starting SimpleService")
            Dim t As New Thread(AddressOf RunMessagePump)
            t.Start()    
        End Sub
    
        Sub RunMessagePump() 
            EventLog.WriteEntry("SimpleService.MessagePump", _
                "Starting SimpleService Message Pump")
            Application.Run(New HiddenForm())
        End Sub
    
        Protected Overrides Sub OnStop() 
            Application.Exit()
        End Sub
    End Class 

    Partial Class HiddenForm
        Inherits Form

        Public Sub New() 
            InitializeComponent()
        End Sub
    
        Private Sub HiddenForm_Load(ByVal sender As Object, ByVal e As EventArgs) 
            AddHandler SystemEvents.TimeChanged, AddressOf SystemEvents_TimeChanged
            AddHandler SystemEvents.UserPreferenceChanged, AddressOf SystemEvents_UPCChanged
        End Sub 
    
        Private Sub HiddenForm_FormClosing(ByVal sender As Object, ByVal e As FormClosingEventArgs) 
            RemoveHandler SystemEvents.TimeChanged, New EventHandler(AddressOf SystemEvents_TimeChanged)
            RemoveHandler SystemEvents.UserPreferenceChanged, _
                New UserPreferenceChangedEventHandler(AddressOf SystemEvents_UPCChanged)
        End Sub 
    
        Private Sub SystemEvents_TimeChanged(ByVal sender As Object, ByVal e As EventArgs) 
            EventLog.WriteEntry("SimpleService.TimeChanged", _
                "Time changed; it is now " & DateTime.Now.ToLongTimeString())
        End Sub 
    
        Private Sub SystemEvents_UPCChanged(ByVal sender As Object, ByVal e As UserPreferenceChangedEventArgs) 
            EventLog.WriteEntry("SimpleService.UserPreferenceChanged", e.Category.ToString())
        End Sub 
    End Class

    Partial Class HiddenForm

        Private components As System.ComponentModel.IContainer = Nothing
    
        Protected Overrides Sub Dispose(ByVal disposing As Boolean) 
            If disposing AndAlso Not (components Is Nothing) Then
                components.Dispose()
            End If
            MyBase.Dispose(disposing)
        End Sub
  
        Private Sub InitializeComponent() 
            Me.SuspendLayout()
            Me.AutoScaleDimensions = New System.Drawing.SizeF(6F, 13F)
            Me.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font
            Me.ClientSize = New System.Drawing.Size(0, 0)
            Me.FormBorderStyle = System.Windows.Forms.FormBorderStyle.None
            Me.Name = "HiddenForm"
            Me.Text = "HiddenForm"
            Me.WindowState = System.Windows.Forms.FormWindowState.Minimized
            AddHandler Me.Load, AddressOf Me.HiddenForm_Load
            AddHandler Me.FormClosing, AddressOf Me.HiddenForm_FormClosing
            Me.ResumeLayout(False)
        End Sub 
    End Class 

    <RunInstaller(True)> _
    Public Class SimpleInstaller
        Inherits Installer

        Private serviceInstaller As ServiceInstaller
        Private processInstaller As ServiceProcessInstaller
    
        Public Sub New() 
            processInstaller = New ServiceProcessInstaller()
            serviceInstaller = New ServiceInstaller()
        
            ' Service will run under system account
            processInstaller.Account = ServiceAccount.LocalSystem
        
            ' Service will have Start Type of Manual
            serviceInstaller.StartType = ServiceStartMode.Automatic
        
            serviceInstaller.ServiceName = "Simple Service"
        
            Installers.Add(serviceInstaller)
            Installers.Add(processInstaller)
        End Sub
    End Class 
End Namespace

Hinweise

Die SystemEvents -Klasse bietet die Möglichkeit, auf bestimmte Arten von Systemereignissen zu reagieren.

Wenn ein Systemereignis ausgelöst wird, werden alle an das Ereignis angefügten Delegaten mithilfe des Threads aufgerufen, der auf Systemereignisse überwacht. Daher sollten Sie alle Aufrufe von Ihren Ereignishandlern threadsicher ausführen. Wenn Sie ein Systemereignis aufrufen müssen, das nicht als Member dieser Klasse verfügbar gemacht wird, können Sie die InvokeOnEventsThread -Methode verwenden.

Achtung

Führen Sie keine zeitaufwändige Verarbeitung für den Thread durch, der einen Systemereignishandler auslöst, da dies möglicherweise andere Anwendungen daran hindert, zu funktionieren.

Hinweis

Einige Systemereignisse werden unter Windows Vista möglicherweise nicht ausgelöst. Vergewissern Sie sich, dass Ihre Anwendung unter Windows Vista wie erwartet funktioniert.

Methoden

CreateTimer(Int32)	Erstellt einen neuen Fensterzeitgeber, der dem Systemereignisfenster zugeordnet ist.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
InvokeOnEventsThread(Delegate)	Ruft den angegebenen Delegaten mit dem Thread auf, der auf Systemereignisse lauscht.
KillTimer(IntPtr)	Beendet den Zeitgeber mit der angegebenen ID.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Ereignisse

DisplaySettingsChanged	Tritt ein, wenn ein Benutzer die Anzeigeeinstellungen ändert.
DisplaySettingsChanging	Tritt ein, wenn sich die Anzeigeeinstellungen ändern.
EventsThreadShutdown	Tritt ein, bevor der auf Systemereignisse lauschende Thread beendet wird.
InstalledFontsChanged	Tritt ein, wenn ein Benutzer Schriftarten zum System hinzufügt oder daraus entfernt.
LowMemory	Veraltet. Tritt ein, wenn im System nicht genügend RAM verfügbar ist.
PaletteChanged	Tritt ein, wenn ein Benutzer zu einer Anwendung wechselt, die eine andere Palette verwendet.
PowerModeChanged	Tritt ein, wenn ein Benutzer den Betrieb des Systems unterbricht bzw. fortsetzt.
SessionEnded	Tritt ein, wenn ein Benutzer sich abmeldet oder das System herunterfährt.
SessionEnding	Tritt ein, wenn ein Benutzer versucht, sich abzumelden oder das System herunterzufahren.
SessionSwitch	Tritt ein, wenn sich der derzeit angemeldete Benutzer geändert hat.
TimeChanged	Tritt ein, wenn ein Benutzer die Systemzeit ändert.
TimerElapsed	Tritt ein, wenn das Intervall eines Fensterzeitgebers abgelaufen ist.
UserPreferenceChanged	Tritt ein, wenn eine Benutzereinstellung geändert wurde.
UserPreferenceChanging	Tritt ein, wenn sich eine Benutzereinstellung ändert.

Weitere Informationen

• PowerModeChangedEventHandler
• SessionEndedEventHandler
• SessionEndingEventHandler
• SessionSwitchEventHandler
• TimerElapsedEventHandler
• UserPreferenceChangedEventHandler
• UserPreferenceChangingEventHandler