DailyTrigger Class

Represents a trigger that starts a task based on a daily schedule. For example, the task starts at a specific time every day, every other day, every third day, and so on.

Inheritance Hierarchy

SystemObject
Microsoft.Win32.TaskSchedulerTrigger
Microsoft.Win32.TaskSchedulerDailyTrigger

Namespace: Microsoft.Win32.TaskScheduler
Assembly: Microsoft.Win32.TaskScheduler (in Microsoft.Win32.TaskScheduler.dll) Version: 2.12.0

Syntax

Copy

[XmlRootAttribute("CalendarTrigger", Namespace = "http://schemas.microsoft.com/windows/2004/02/mit/task", 
	IsNullable = false)]
public sealed class DailyTrigger : Trigger, 
	ICalendarTrigger, ITriggerDelay, IXmlSerializable

Request Example View Source

The DailyTrigger type exposes the following members.

Constructors

	Name	Description
	DailyTrigger	Creates an unbound instance of a DailyTrigger.

Top

Properties

Name

Description

DaysInterval

Sets or retrieves the interval between the days in the schedule.

Enabled

Gets or sets a Boolean value that indicates whether the trigger is enabled.
(Inherited from Trigger)

EndBoundary

Gets or sets the date and time when the trigger is deactivated. The trigger cannot start the task after it is deactivated.

Note
While the maximum value for this property is MaxValue, the Windows Task Scheduler management application that is part of the OS will fail if this value is greater than December 31, 9998.

(Inherited from Trigger)

ExecutionTimeLimit

Gets or sets the maximum amount of time that the task launched by this trigger is allowed to run. Not available with Task Scheduler 1.0.
(Inherited from Trigger)

Gets or sets the identifier for the trigger. Cannot set with Task Scheduler 1.0.
(Inherited from Trigger)

RandomDelay

Gets or sets a delay time that is randomly added to the start time of the trigger.

Repetition

Gets a RepetitionPattern instance that indicates how often the task is run and how long the repetition pattern is repeated after the task is started.
(Inherited from Trigger)

StartBoundary

Gets or sets the date and time when the trigger is activated.
(Inherited from Trigger)

TriggerType

Gets the type of the trigger.
(Inherited from Trigger)

Top

Methods

	Name	Description
	CheckBindValue	Checks the bind value for any conversion. (Inherited from Trigger)
	Clone	Creates a new Trigger that is an unbound copy of this instance. (Inherited from Trigger)
	CompareTo	Compares the current instance with another object of the same type and returns an integer that indicates whether the current instance precedes, follows, or occurs in the same position in the sort order as the other object. (Inherited from Trigger)
	CopyProperties	Copies the properties from another Trigger the current instance. This will not copy any properties associated with any derived triggers except those supporting the ITriggerDelay interface. (Overrides TriggerCopyProperties(Trigger))
	Dispose	Releases all resources used by this class. (Inherited from Trigger)
	Equals(Object)	Determines whether the specified Object, is equal to this instance. (Inherited from Trigger)
	Equals(Trigger)	Indicates whether the current object is equal to another object of the same type. (Overrides TriggerEquals(Trigger))
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object)
	GetHashCode	Returns a hash code for this instance. (Inherited from Trigger)
	GetType	Gets the Type of the current instance. (Inherited from Object)
	GetUnboundValueOrDefaultT	Gets the unbound value or a default. (Inherited from Trigger)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object)
	OnNotifyPropertyChanged	Called when a property has changed to notify any attached elements. (Inherited from Trigger)
	SetRepetition	Obsolete. Sets the repetition. (Inherited from Trigger)
	ToString	Returns a string representing this trigger. (Inherited from Trigger)
	ToString(CultureInfo)	Returns a String that represents this trigger in a specific language. (Inherited from Trigger)
	V2GetTriggerString	Gets the non-localized trigger string for V2 triggers. (Overrides TriggerV2GetTriggerString)

Top

Events

	Name	Description
	PropertyChanged	Occurs when a property value changes. (Inherited from Trigger)

Top

Fields

	Name	Description
	unboundValues	In testing and may change. Do not use until officially introduced into library. (Inherited from Trigger)

Top

Remarks

A DailyTrigger will fire at a specified time every day or interval of days.

Example

Copy

// Create a trigger that runs every other day and will start randomly between 10 a.m. and 12 p.m.
DailyTrigger dt = new DailyTrigger();
dt.StartBoundary = DateTime.Today + TimeSpan.FromHours(10);
dt.DaysInterval = 2;
dt.RandomDelay = TimeSpan.FromHours(2); // V2 only

Reference

Microsoft.Win32.TaskScheduler Namespace