SystemEvents 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
시스템 이벤트 알림에 액세스할 수 있도록 합니다. 이 클래스는 상속될 수 없습니다.
public ref class SystemEvents sealedpublic sealed class SystemEventstype SystemEvents = classPublic NotInheritable Class SystemEvents- 상속
-
SystemEvents
예제
이 섹션에서는 두 가지 예제를 포함합니다. 첫 번째 예제에서는 일반 애플리케이션에서 시스템 이벤트를 사용 하 고 두 번째 예제에는 Windows 서비스의 시스템 이벤트를 사용 하는 방법을 보여 줍니다.
예제 1
다음 코드 예제에서는 일부 시스템 이벤트에 대한 관심을 등록한 다음 해당 이벤트가 발생할 때까지 기다립니다. 표시된 출력은 사용자가 디스플레이 해상도를 변경하는 경우에 발생합니다.
#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
예제 2
다음 코드 예제에서는 및 이벤트를 처리 하는 매우 간단한 Windows 서비스를 보여 줍니다 TimeChangedUserPreferenceChanged . 이 예제에는 라는 서비스, 라는 SimpleServiceHiddenForm양식 및 설치 관리자가 포함됩니다. 양식은 시스템 이벤트에 필요한 메시지 루프를 제공합니다.
참고
서비스에는 데스크톱과 상호 작용할 수 없는 한 메시지 루프가 없습니다. 이 예제와 같이 숨겨진 양식에서 메시지 루프를 제공하지 않는 경우 로컬 시스템 계정으로 서비스를 실행해야 하며 데스크톱과의 상호 작용을 사용하도록 설정하려면 수동 개입이 필요합니다. 즉, 관리자는 서비스 속성 대화 상자의 로그온 탭에 있는 데스크톱 검사 서비스 상호 작용 허용 상자를 수동으로 검사 합니다. 이 경우 메시지 루프가 자동으로 제공됩니다. 이 옵션은 서비스가 로컬 시스템 계정으로 실행되는 경우에만 사용할 수 있습니다. 데스크톱과의 상호 작용은 프로그래밍 방식으로 사용하도록 설정할 수 없습니다.
이 예제의 서비스는 의 HiddenForminstance 실행하는 스레드를 시작합니다. 이벤트는 양식에 연결되고 처리됩니다. 폼이 완전히 먼저 로드되도록 하려면 폼의 로드 이벤트에 이벤트를 연결해야 합니다. 그렇지 않으면 이벤트가 발생하지 않습니다.
참고
이 예제에서는 Visual Studio 디자이너에서 일반적으로 생성하는 양식 초기화 코드를 포함하여 필요한 모든 코드를 제공합니다. Visual Studio에서 서비스를 개발하는 경우 두 번째 부분 클래스를 생략하고 속성 창을 사용하여 숨겨진 폼의 높이와 너비를 0으로 설정하고 테두리 스타일을 FormBorderStyle.None로 설정하고 창 상태를 FormWindowState.Minimized로 설정할 수 있습니다.
예제를 실행하려면 다음을 수행합니다.
명령줄에서 코드를 컴파일합니다. 원본 파일에 사용하는 이름은 중요하지 않습니다.
Installutil.exe(설치 관리자 도구) 유틸리티를 사용하여 명령줄에서 서비스를 설치합니다. 예를 들어
InstallUtil example.exe원본 파일 이름이 또는example.vb인 경우 입니다example.cs. 서비스를 설치하려면 관리자여야 합니다.서비스 콘솔을 사용하여 서비스를 시작합니다.
시스템 시간을 변경하거나 마우스 속성과 같은 사용자 기본 설정을 변경합니다.
메시지를 볼 합니다 애플리케이션 이벤트 뷰어의 범주입니다.
서비스 콘솔을 사용하여 서비스를 중지합니다.
옵션을 사용하여 명령줄에서 서비스를 제거합니다
/u. 예들 들어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
설명
클래스는 SystemEvents 특정 유형의 시스템 이벤트에 응답하는 기능을 제공합니다.
시스템 이벤트가 발생하면 시스템 이벤트를 모니터링하는 스레드를 사용하여 이벤트에 연결된 모든 대리자를 호출합니다. 따라서 이벤트 처리기에서 스레드로부터 안전하게 호출해야 합니다. 이 클래스의 멤버로 노출되지 않은 시스템 이벤트를 호출해야 하는 경우 메서드를 InvokeOnEventsThread 사용할 수 있습니다.
주의
다른 애플리케이션의 작동을 방해할 수 있으므로 시스템 이벤트 처리기를 발생 시키는 스레드에서 시간이 많이 걸리는 처리를 수행 하지 않습니다.
참고
일부 시스템 이벤트는 Windows Vista에서 발생하지 않을 수 있습니다. Windows Vista에서 애플리케이션이 예상대로 작동하는지 확인해야 합니다.
메서드
| CreateTimer(Int32) |
시스템 이벤트 창과 연결된 새 창 타이머를 만듭니다. |
| Equals(Object) |
지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object) |
| GetHashCode() |
기본 해시 함수로 작동합니다. (다음에서 상속됨 Object) |
| GetType() |
현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object) |
| InvokeOnEventsThread(Delegate) |
시스템 이벤트를 수신하는 스레드를 사용하여 지정된 대리자를 호출합니다. |
| KillTimer(IntPtr) |
주어진 ID로 지정된 타이머를 종료합니다. |
| MemberwiseClone() |
현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object) |
| ToString() |
현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object) |
이벤트
| DisplaySettingsChanged |
사용자가 디스플레이 설정을 변경할 때 발생됩니다. |
| DisplaySettingsChanging |
디스플레이 설정을 변경할 때 발생됩니다. |
| EventsThreadShutdown |
시스템 이벤트를 수신하는 스레드가 종료되기 전에 발생됩니다. |
| InstalledFontsChanged |
사용자가 시스템 글꼴을 추가하거나 제거할 때 발생됩니다. |
| LowMemory |
사용되지 않음.
사용되지 않음.
사용되지 않음.
시스템에 사용할 수 있는 RAM이 없을 때 발생됩니다. |
| PaletteChanged |
사용자가 다른 색상표를 사용하는 애플리케이션으로 전환할 때 발생됩니다. |
| PowerModeChanged |
사용자가 시스템을 일시 중단하거나 다시 시작할 때 발생됩니다. |
| SessionEnded |
사용자가 로그오프하거나 시스템을 종료할 때 발생됩니다. |
| SessionEnding |
사용자가 로그오프하려고 하거나 시스템을 종료하려고 할 때 발생됩니다. |
| SessionSwitch |
현재 로그인한 사용자가 변경될 때 발생합니다. |
| TimeChanged |
사용자가 시스템 시계의 시간을 변경할 때 발생됩니다. |
| TimerElapsed |
창 타이머 간격 설정이 만료될 때 발생됩니다. |
| UserPreferenceChanged |
사용자 기본 설정이 변경될 때 발생됩니다. |
| UserPreferenceChanging |
사용자 기본 설정이 변경될 때 발생됩니다. |
적용 대상
추가 정보
GitHub에서 Microsoft와 공동 작업
이 콘텐츠의 원본은 GitHub에서 찾을 수 있으며, 여기서 문제와 끌어오기 요청을 만들고 검토할 수도 있습니다. 자세한 내용은 참여자 가이드를 참조하세요.
.NET
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기