當應用程式需執行需要系統管理員權限的操作 (修改系統時間、寫入受保護登錄機碼、安裝服務、修改 hosts 檔等),必須以「系統管理員身分執行」。透過在 `Program.cs` 的 `Main` 入口點檢測目前權限並啟動 UAC 昇權,可實現程式預設以管理員身分運行。
using System;
using System.Diagnostics;
using System.Security.Principal;
using System.Windows.Forms;
static class Program
{
[STAThread]
static void Main(string[] args)
{
Application.EnableVisualStyles();
Application.SetCompatibleTextRenderingDefault(false);
// 1. 檢查目前使用者是否為系統管理員
WindowsIdentity identity = WindowsIdentity.GetCurrent();
WindowsPrincipal principal = new WindowsPrincipal(identity);
bool isAdmin = principal.IsInRole(WindowsBuiltInRole.Administrator);
if (isAdmin)
{
// 已是管理員,直接啟動主視窗
Application.Run(new MainForm());
}
else
{
// 2. 非管理員:啟動新進程並要求 UAC 昇權
ProcessStartInfo startInfo = new ProcessStartInfo
{
FileName = Application.ExecutablePath, // 當前執行檔路徑
Arguments = string.Join(" ", args), // 傳遞原始參數
Verb = "runas", // 關鍵:要求以管理員身分執行
UseShellExecute = true // 必須為 true 才能使用 runas verb
};
try
{
Process.Start(startInfo); // 觸發 UAC 提示視窗
}
catch (System.ComponentModel.Win32Exception ex)
{
// 使用者點擊 UAC 視窗的「否」
MessageBox.Show("此程式需要系統管理員權限才能執行。", "權限不足",
MessageBoxButtons.OK, MessageBoxIcon.Warning);
}
// 3. 結束目前非管理員進程
Application.Exit();
}
}
}
| 屬性/方法 | 作用 |
|---|---|
WindowsPrincipal.IsInRole(WindowsBuiltInRole.Administrator) | 檢查目前使用者 Token 是否包含 Administrators 群組 SID (已啟用) |
ProcessStartInfo.Verb = "runas" | 要求 Shell 以提升權限啟動進程 (觸發 UAC 同意提示) |
UseShellExecute = true | 啟用 Shell 執行模式,`runas` verb 僅在此模式有效 |
Application.ExecutablePath | 取得目前執行檔完整路徑,支援偵錯/發布/安裝後各種情境 |
string.Join(" ", args) | 保留原始命令列參數傳遞給昇權後的新進程 |
在專案屬性 → Application → 「View Windows Settings」建立 `app.manifest`,設定 `requestedExecutionLevel`:
<?xml version="1.0" encoding="utf-8"?>
<assembly manifestVersion="1.0" xmlns="urn:schemas-microsoft-com:asm.v1">
<trustInfo xmlns="urn:schemas-microsoft-com:asm.v2">
<security>
<requestedPrivileges xmlns="urn:schemas-microsoft-com:asm.v3">
<!-- level="requireAdministrator" 會強制 UAC 昇權 -->
<requestedExecutionLevel level="requireAdministrator" uiAccess="false" />
</requestedPrivileges>
</security>
</trustInfo>
</assembly>
差異: Manifest 方式會在啟動前就彈出 UAC,無法在程式碼中判斷使用者是否點選「否」並優雅處理 (如顯示唯讀模式)。程式碼檢測方式彈性更高。
在 `Main` 入口點實作 UAC 昇權檢測,是 WinForms/WPF 桌面應用程式確保必要管理員權限的標準做法,配合 `app.manifest` 可提供雙重保障。