SystemEvents Klasse

Definition

Ermöglicht den Zugriff auf Systemereignisbenachrichtigungen.Provides access to system event notifications. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

public ref class SystemEvents sealed
public sealed class SystemEvents
type SystemEvents = class
Public NotInheritable Class SystemEvents
Vererbung
SystemEvents

Beispiele

Dieser Abschnitt enthält zwei Beispiele.This section contains two examples. Im ersten Beispiel wird gezeigt, wie Systemereignisse in einer normalen Anwendung verwendet werden, und das zweite Beispiel zeigt, wie Systemereignisse in einem Windows-Dienst verwendet werden.The first example shows how to use system events in an ordinary application, and the second example shows how to use system events in a Windows service.

Beispiel 1Example 1

Im folgenden Codebeispiel wird das Interesse an einigen System Ereignissen registriert und dann darauf gewartet, dass alle Ereignisse eintreten.The following code example registers interest in some system events and then waits for any of those events to occur. Die angezeigte Ausgabe tritt auf, wenn der Benutzer die Bildschirmauflösung ändert.The output shown occurs if the user changes the display resolution.

#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 2Example 2

Im folgenden Codebeispiel wird ein sehr einfacher Windows-Dienst veranschaulicht, der die Ereignisse TimeChanged und UserPreferenceChanged behandelt.The following code example demonstrates a very simple Windows service that handles the TimeChanged and UserPreferenceChanged events. Das Beispiel enthält einen Dienst mit dem Namen SimpleService, ein Formular mit dem Namen HiddenFormund ein Installationsprogramm.The example includes a service named SimpleService, a form named HiddenForm, and an installer. Das Formular stellt die Nachrichten Schleife bereit, die von System Ereignissen benötigt wird.The form provides the message loop that is required by system events.

Hinweis

Dienste verfügen über keine Nachrichten Schleifen, es sei denn, Sie dürfen mit dem Desktop interagieren.Services do not have message loops, unless they are allowed to interact with the desktop. Wenn die Nachrichten Schleife nicht in einem verborgenen Formular, wie in diesem Beispiel, bereitgestellt wird, 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.If the message loop is not provided by a hidden form, as in this example, the service must be run under the local system account, and manual intervention is required to enable interaction with the desktop. Das heißt, dass der Administrator das Kontrollkästchen Dienst für die Interaktion mit dem Desktop zulassen auf der Registerkarte Anmelden im Dialogfeld Dienst Eigenschaften manuell aktivieren muss.That is, the administrator must manually check the Allow service to interact with desktop check box on the Log On tab of the service properties dialog box. In diesem Fall wird automatisch eine Nachrichten Schleife bereitgestellt.In that case, a message loop is automatically provided. Diese Option ist nur verfügbar, wenn der Dienst unter dem lokalen Systemkonto ausgeführt wird.This option is available only when the service is run under the local system account. Die Interaktion mit dem Desktop kann nicht Programm gesteuert aktiviert werden.Interaction with the desktop cannot be enabled programmatically.

Der Dienst in diesem Beispiel startet einen Thread, der eine Instanz von HiddenFormausführt.The service in this example starts a thread that runs an instance of HiddenForm. Die Ereignisse werden im Formular eingebunden und behandelt.The events are hooked up and handled in the form. Die Ereignisse müssen im Lade Ereignis des Formulars verknüpft werden, um sicherzustellen, dass das Formular zuerst vollständig geladen wird. Andernfalls werden die Ereignisse nicht ausgelöst.The events must be hooked up in the load event of the form, to make sure that the form is completely loaded first; otherwise the events will not be raised.

Hinweis

Im Beispiel wird der gesamte erforderliche Code bereitstellt, einschließlich des von Visual Studio-Designern generierten Formular Initialisierungs Codes.The example provides all the necessary code, including the form initialization code typically generated by Visual Studio designers. Wenn Sie den Dienst in Visual Studio entwickeln, können Sie die zweite partielle Klasse weglassen und das Eigenschaften Fenster verwenden, um die Höhe und Breite des verborgenen Formulars auf NULL festzulegen, die Rahmenart auf FormBorderStyle.Noneund den Fenster Zustand FormWindowState.Minimized.If you are developing your service in Visual Studio, you can omit the second partial class and use the Properties window to set the height and width of the hidden form to zero, the border style to FormBorderStyle.None, and the window state to FormWindowState.Minimized.

So führen Sie das Beispiel aus:To run the example:

  1. Kompilieren Sie den Code über die Befehlszeile.Compile the code from the command line. Der Name, den Sie für die Quelldatei verwenden, ist nicht wichtig.The name that you use for the source file is not important.

  2. Installieren Sie den Dienst über die Befehlszeile mit dem Hilfsprogramm installutil. exe (Installationstool) .Install the service from the command line using the Installutil.exe (Installer Tool) utility. Beispielsweise InstallUtil example.exe, wenn der Name der Quelldatei example.cs oder example.vbist.For example, InstallUtil example.exe if the source file name is example.cs or example.vb. Sie müssen ein Administrator sein, um den Dienst installieren zu können.You must be an administrator to install the service.

  3. Verwenden Sie die Konsole Dienste, um den Dienst zu starten.Use the Services console to start the service.

  4. Ändern Sie die Systemzeit, oder ändern Sie die Benutzereinstellungen, wie z. b. die Maus Eigenschaften.Change the system time, or change user preferences, such as mouse properties.

  5. Zeigen Sie die Nachrichten in der Anwendungs Kategorie Ereignisanzeige an.View the messages in the Application category of Event Viewer.

  6. Verwenden Sie die Konsole Dienste, um den Dienst zu unterbinden.Use the Services console to stop the service.

  7. Deinstallieren Sie den Dienst über die Befehlszeile mithilfe der Option /u.Uninstall the service from the command line by using the /u option. Beispielsweise InstallUtil /u example.exe.For example, 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 Typen von System Ereignissen zu reagieren.The SystemEvents class provides the ability to respond to specific types of system events.

Wenn ein System Ereignis ausgelöst wird, werden alle an das Ereignis angefügten Delegaten mit dem Thread aufgerufen, der auf Systemereignisse überwacht.When a system event is raised, any delegates attached to the event are called using the thread that monitors for system events. Daher sollten Sie alle Aufrufe von ihren Ereignis Handlern Thread sicher durchführen.Therefore, you should make any calls from your event handlers thread-safe. Wenn Sie ein System Ereignis abrufen müssen, das nicht als Member dieser Klasse verfügbar gemacht wird, können Sie die InvokeOnEventsThread-Methode verwenden.If you need to call a system event that is not exposed as a member of this class, you can use the InvokeOnEventsThread method.

Achtung

Führen Sie keine zeitaufwändige Verarbeitung auf dem Thread aus, der einen System Ereignishandler auslöst, da dadurch möglicherweise andere Anwendungen nicht funktionieren.Do not perform time-consuming processing on the thread that raises a system event handler because it might prevent other applications from functioning.

Hinweis

Einige Systemereignisse können nicht auf Windows VistaWindows Vistaausgelöst werden.Some system events might not be raised on Windows VistaWindows Vista. Stellen Sie sicher, dass Ihre Anwendung auf Windows VistaWindows Vistaerwartungsgemäß funktioniert.Be sure to verify that your application works as expected on Windows VistaWindows Vista.

Methoden

CreateTimer(Int32)

Erstellt einen neuen Fensterzeitgeber, der dem Systemereignisfenster zugeordnet ist.Creates a new window timer associated with the system events window.

Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
InvokeOnEventsThread(Delegate)

Ruft den angegebenen Delegaten mit dem Thread auf, der auf Systemereignisse lauscht.Invokes the specified delegate using the thread that listens for system events.

KillTimer(IntPtr)

Beendet den Zeitgeber mit der angegebenen ID.Terminates the timer specified by the given id.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Ereignisse

DisplaySettingsChanged

Tritt ein, wenn ein Benutzer die Anzeigeeinstellungen ändert.Occurs when the user changes the display settings.

DisplaySettingsChanging

Tritt ein, wenn sich die Anzeigeeinstellungen ändern.Occurs when the display settings are changing.

EventsThreadShutdown

Tritt ein, bevor der auf Systemereignisse lauschende Thread beendet wird.Occurs before the thread that listens for system events is terminated.

InstalledFontsChanged

Tritt ein, wenn ein Benutzer Schriftarten zum System hinzufügt oder daraus entfernt.Occurs when the user adds fonts to or removes fonts from the system.

LowMemory

Tritt ein, wenn im System nicht genügend RAM verfügbar ist.Occurs when the system is running out of available RAM.

PaletteChanged

Tritt ein, wenn ein Benutzer zu einer Anwendung wechselt, die eine andere Palette verwendet.Occurs when the user switches to an application that uses a different palette.

PowerModeChanged

Tritt ein, wenn ein Benutzer den Betrieb des Systems unterbricht bzw. fortsetzt.Occurs when the user suspends or resumes the system.

SessionEnded

Tritt ein, wenn ein Benutzer sich abmeldet oder das System herunterfährt.Occurs when the user is logging off or shutting down the system.

SessionEnding

Tritt ein, wenn ein Benutzer versucht, sich abzumelden oder das System herunterzufahren.Occurs when the user is trying to log off or shut down the system.

SessionSwitch

Tritt ein, wenn sich der derzeit angemeldete Benutzer geändert hat.Occurs when the currently logged-in user has changed.

TimeChanged

Tritt ein, wenn ein Benutzer die Systemzeit ändert.Occurs when the user changes the time on the system clock.

TimerElapsed

Tritt ein, wenn das Intervall eines Fensterzeitgebers abgelaufen ist.Occurs when a windows timer interval has expired.

UserPreferenceChanged

Tritt ein, wenn eine Benutzereinstellung geändert wurde.Occurs when a user preference has changed.

UserPreferenceChanging

Tritt ein, wenn sich eine Benutzereinstellung ändert.Occurs when a user preference is changing.

Sicherheit

NamedPermissionSet
für vollständigen Zugriff auf Systemressourcen.for full access to system resources. Anforderungs Werte: LinkDemand.Demand values: LinkDemand. Zugeordneter Status:Associated state:

Gilt für:

Siehe auch