JobSchedule.FrequencyInterval Property
Gets or sets the frequency interval, which determines how often the job is scheduled to run.
Namespace: Microsoft.SqlServer.Management.Smo.Agent
Assembly: Microsoft.SqlServer.Smo (in microsoft.sqlserver.smo.dll)
Syntax
'Declaration
Public Property FrequencyInterval As Integer
public int FrequencyInterval { get; set; }
public:
property int FrequencyInterval {
int get ();
void set (int value);
}
/** @property */
public int get_FrequencyInterval ()
/** @property */
public void set_FrequencyInterval (int value)
public function get FrequencyInterval () : int
public function set FrequencyInterval (value : int)
Property Value
An Int32 value that specifies the frequency interval.
Remarks
FrequencyInterval is always interpreted relative to the value of the FrequencyTypes property. FrequencyInterval is interpreted using these values.
FrequencyInterval value |
FrequencyType value |
FrequencyInterval is not applicable. |
FrequencyType.Unknown |
FrequencyInterval is not applicable. The schedule runs once only. |
FrequencyType.OneTime |
An integer value that specifies the number of days. For example, when FrequencyInterval property is 3, the schedule job runs every third day. |
FrequencyType.Daily |
A bit flag long integer value that specifies the days of the week using the WeekDays enumeration. WeekDays.Sunday = 1 WeekDays.Monday = 2 WeekDays.Tuesday = 4 WeekDays.Wednesday = 8 WeekDays.Thursday = 16 WeekDays.Friday = 32 WeekDays.Saturday = 64 WeekDays.WeekDays = 62 WeekDays.WeekEnds = 65 WeekDays.EveryDay = 127 Combine values using an OR logical operator to set more than a single day. For example, combine WeekDays.Monday and WeekDays.Friday (FrequencyInterval = 2 + 32 = 34) to schedule an activity for Monday and Friday. |
FrequencyType.Weekly |
An integer that specifies the ordinal day of the month on which the schedule is active. For example, 4 specifies the fourth day of the month. |
FrequencyType.Monthly |
A long integer that specifies the day of the week. This property is used together with the FrequencyRelativeIntervals property, which specifies the ordinal number of the specified day of the week that occurs within the month. For example, if FrequencyRelativeIntervals property is set to 2 and the FrequencyInterval is set to Friday, the scheduled job runs on the second Friday of every month. |
FrequencyType.MonthlyRelative |
FrequencyInterval is not applicable. The schedule runs when Microsoft SQL Server is started. |
FrequencyType.AutoStart |
FrequencyInterval is not applicable. The schedule runs when the processor running the instance of SQL Server is idle. |
FrequencyType.OnIdle |
FrequencyInterval is not applicable. |
FrequencyType.Valid |
This namespace, class, or member is supported only in version 2.0 of the Microsoft .NET Framework.
Example
How to: Create a Job with Steps and a Schedule in Visual Basic .NET
Thread Safety
Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Platforms
Development Platforms
For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.
Target Platforms
For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.
See Also
Reference
JobSchedule Class
JobSchedule Members
Microsoft.SqlServer.Management.Smo.Agent Namespace
Other Resources
Scheduling Automatic Administrative Tasks in SQL Server Agent
Automating Administrative Tasks (SQL Server Agent)
sp_add_schedule (Transact-SQL)