使用C#創建計劃任務(How to create a Task Scheduler use C# )，
本文主要講解了如何使用C#來創建windows計劃任務。
解決方案開始：
這裡選用微軟自帶的類庫TaskScheduler，下面是封裝過的代碼，包含了刪除計劃任務、判斷計劃任務是否存在、獲取所有的計劃任務、創建計劃任務 。(具體看詳細注釋)：
獲取計劃任務的列表：
![]()
/// <summary>
/// get all tasks
/// </summary>
public static IRegisteredTaskCollection GetAllTasks()
{
TaskSchedulerClass ts = new TaskSchedulerClass();
ts.Connect(null, null, null, null);
ITaskFolder folder = ts.GetFolder("\\");
IRegisteredTaskCollection tasks_exists = folder.GetTasks(1);
return tasks_exists;
}
View Code
判斷計劃任務是否存在：
![]()
/// <summary>
/// check task isexists
/// </summary>
/// <param name="taskName"></param>
/// <returns></returns>
public static bool IsExists(string taskName)
{
var isExists = false;
IRegisteredTaskCollection tasks_exists = GetAllTasks();
for (int i = 1; i <= tasks_exists.Count; i++)
{
IRegisteredTask t = tasks_exists[i];
if (t.Name.Equals(taskName))
{
isExists=true;
break;
}
}
return isExists;
}
View Code
刪除計劃任務：
![]()
/// <summary>
/// delete task
/// </summary>
/// <param name="taskName"></param>
private static void DeleteTask(string taskName)
{
TaskSchedulerClass ts = new TaskSchedulerClass();
ts.Connect(null, null, null, null);
ITaskFolder folder = ts.GetFolder("\\");
folder.DeleteTask(taskName, 0);
}
View Code
創建計劃任務：
![]()
/// <summary>
/// create scheduler
/// </summary>
/// <param name="creator"></param>
/// <param name="taskName"></param>
/// <param name="path"></param>
/// <param name="interval"></param>
/// <param name="startBoundary"></param>
/// <param name="description"></param>
/// <returns></returns>
public static _TASK_STATE CreateTaskScheduler(string creator, string taskName, string path,string interval,string startBoundary,string description)
{
try
{
if (IsExists(taskName))
{
DeleteTask(taskName);
}
//new scheduler
TaskSchedulerClass scheduler = new TaskSchedulerClass();
//pc-name/ip,username,domain,password
scheduler.Connect(null, null, null, null);
//get scheduler folder
ITaskFolder folder = scheduler.GetFolder("\\");
//set base attr
ITaskDefinition task = scheduler.NewTask(0);
task.RegistrationInfo.Author = creator;//creator
task.RegistrationInfo.Description = description;//description
//set trigger (IDailyTrigger ITimeTrigger)
ITimeTrigger tt = (ITimeTrigger)task.Triggers.Create(_TASK_TRIGGER_TYPE2.TASK_TRIGGER_TIME);
tt.Repetition.Interval = interval;// format PT1H1M==1小時1分鐘 設置的值最終都會轉成分鐘加入到觸發器
tt.StartBoundary = startBoundary;//start time
//set action
IExecAction action = (IExecAction)task.Actions.Create(_TASK_ACTION_TYPE.TASK_ACTION_EXEC);
action.Path = path;//計劃任務調用的程序路徑
task.Settings.ExecutionTimeLimit = "PT0S"; //運行任務時間超時停止任務嗎? PTOS 不開啟超時
task.Settings.DisallowStartIfOnBatteries = false;//只有在交流電源下才執行
task.Settings.RunOnlyIfIdle = false;//僅當計算機空閒下才執行
IRegisteredTask regTask = folder.RegisterTaskDefinition(taskName, task,
(int)_TASK_CREATION.TASK_CREATE, null, //user
null, // password
_TASK_LOGON_TYPE.TASK_LOGON_INTERACTIVE_TOKEN,
"");
IRunningTask runTask = regTask.Run(null);
return runTask.State ;
}
catch (Exception ex)
{
throw ex;
}
}
View Code
完整代碼：
![]()
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using TaskScheduler;
namespace McodsBgManager
{
public class SchTaskExt
{
/// <summary>
/// delete task
/// </summary>
/// <param name="taskName"></param>
private static void DeleteTask(string taskName)
{
TaskSchedulerClass ts = new TaskSchedulerClass();
ts.Connect(null, null, null, null);
ITaskFolder folder = ts.GetFolder("\\");
folder.DeleteTask(taskName, 0);
}
/// <summary>
/// get all tasks
/// </summary>
public static IRegisteredTaskCollection GetAllTasks()
{
TaskSchedulerClass ts = new TaskSchedulerClass();
ts.Connect(null, null, null, null);
ITaskFolder folder = ts.GetFolder("\\");
IRegisteredTaskCollection tasks_exists = folder.GetTasks(1);
return tasks_exists;
}
/// <summary>
/// check task isexists
/// </summary>
/// <param name="taskName"></param>
/// <returns></returns>
public static bool IsExists(string taskName)
{
var isExists = false;
IRegisteredTaskCollection tasks_exists = GetAllTasks();
for (int i = 1; i <= tasks_exists.Count; i++)
{
IRegisteredTask t = tasks_exists[i];
if (t.Name.Equals(taskName))
{
isExists=true;
break;
}
}
return isExists;
}
/// <summary>
/// create task
/// </summary>
/// <param name="creator"></param>
/// <param name="taskName"></param>
/// <param name="path"></param>
/// <param name="interval"></param>
/// <returns>state</returns>
public static _TASK_STATE CreateTaskScheduler(string creator, string taskName, string path,string interval)
{
try
{
if (IsExists(taskName))
{
DeleteTask(taskName);
}
//new scheduler
TaskSchedulerClass scheduler = new TaskSchedulerClass();
//pc-name/ip,username,domain,password
scheduler.Connect(null, null, null, null);
//get scheduler folder
ITaskFolder folder = scheduler.GetFolder("\\");
//set base attr
ITaskDefinition task = scheduler.NewTask(0);
task.RegistrationInfo.Author = "McodsAdmin";//creator
task.RegistrationInfo.Description = "...";//description
//set trigger (IDailyTrigger ITimeTrigger)
ITimeTrigger tt = (ITimeTrigger)task.Triggers.Create(_TASK_TRIGGER_TYPE2.TASK_TRIGGER_TIME);
tt.Repetition.Interval = interval;// format PT1H1M==1小時1分鐘 設置的值最終都會轉成分鐘加入到觸發器
tt.StartBoundary = "2015-04-09T14:27:25";//start time
//set action
IExecAction action = (IExecAction)task.Actions.Create(_TASK_ACTION_TYPE.TASK_ACTION_EXEC);
action.Path = path;
task.Settings.ExecutionTimeLimit = "PT0S"; //運行任務時間超時停止任務嗎? PTOS 不開啟超時
task.Settings.DisallowStartIfOnBatteries = false;//只有在交流電源下才執行
task.Settings.RunOnlyIfIdle = false;//僅當計算機空閒下才執行
IRegisteredTask regTask = folder.RegisterTaskDefinition(taskName, task,
(int)_TASK_CREATION.TASK_CREATE, null, //user
null, // password
_TASK_LOGON_TYPE.TASK_LOGON_INTERACTIVE_TOKEN,
"");
IRunningTask runTask = regTask.Run(null);
return runTask.State ;
}
catch (Exception ex)
{
throw ex;
}
}
}
}
View Code
SchTaskExt.cs封裝好了如何使用呢？
btnSetup_Click的代碼如下：此處使用的是calc.exe做例。
private void btnSetup_Click(object sender, RoutedEventArgs e)
{
//創建者
var creator = "天佑";
//計劃任務名稱
var taskName = "CalcTask";
//執行的程序路徑
var path = "C:\\Windows\\System32\\calc.exe";
//計劃任務執行的頻率 PT1M一分鐘 PT1H30M 90分鐘
var interval = "PT1M";
//開始時間 請遵循 yyyy-MM-ddTHH:mm:ss 格式
var startBoundary = "2015-04-09T14:27:25";
var description = "這是計劃描述 abc ";
_TASK_STATE state = SchTaskExt.CreateTaskScheduler(creator, taskName, path, interval, startBoundary,description);
if (state == _TASK_STATE.TASK_STATE_RUNNING)
{
MessageBox.Show("計劃任務部署成功!");
}
}
運行成功後：
可以看到calc.exe已經跑起來了，接下來我們在控制面板找到計劃任務窗口看看。
好了 大功告成！
注意：
1.引用taskachd.dll後選中按下F4在屬性中將 嵌入互操作類型 改為 False (沒設置會報一個錯誤: 無法嵌入互操作類型“TaskScheduler.TaskSchedulerClass”。請改用適用的接口。 )
2.所有操作都需要實例化schdule後進行connection：schdule.Connec("pc-name 或者 ip","username","domain","password")
3.觸發器類型有多種選擇(按天IDailyTrigger,按分鐘ITimeTrigger))；
觸發頻率(Interval)的格式需要遵循"PT1H1M"這樣的格式；
起始時間需要遵循"YYYY-MM-DDThh:mm:ss"這樣的格式。
4.計劃任務運行的實例好像只能是唯一的，因為目前的情況這個calc可以正常運行第一次，第二次就被拒絕請求：
操作員或系統管理員拒絕了請求。(0x800710E0) ，這個錯誤在網上並沒有找到解決方案，如下圖。
後來在網上搜到 這裡這種解決方案，但是按照設置後仍沒得到解決，官方也沒有這個錯誤代碼(點擊這裡查看Task Scheduler)。
所以我理解成這個計劃任務只能運行一個實例，這個實例沒有結束之前，如果到達下一次觸發周期，則會被拒絕計劃請求。
另：如有其它诠釋還請指明，非常感謝!
完！
