NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

RecurrencePatterns.AddDailyPattern (Int32, String, TimeSpan, TimeSpan, TimeSpan, DateTime, DateTime)

Adds a DailyPattern, given the daily execution interval, the pattern name, the start and end times, the recurrence pattern repetition rate, and the start and end dates.

[Visual Basic]
Overloads Public Function AddDailyPattern( _
   ByVal everyNthDay As Integer, _
   ByVal patternName As String, _
   ByVal startTime As TimeSpan, _
   ByVal endTime As TimeSpan, _
   ByVal interval As TimeSpan, _
   ByVal validFrom As DateTime, _
   ByVal validUntil As DateTime _
) As DailyPattern
[C#]
public DailyPattern AddDailyPattern(
   int everyNthDay,
   string patternName,
   TimeSpan startTime,
   TimeSpan endTime,
   TimeSpan interval,
   DateTime validFrom,
   DateTime validUntil
);
[C++]
public: DailyPattern* AddDailyPattern(
   int everyNthDay,
   String* patternName,
   TimeSpan startTime,
   TimeSpan endTime,
   TimeSpan interval,
   DateTime validFrom,
   DateTime validUntil
);
[JScript]
public function AddDailyPattern(
   everyNthDay : int,
   patternName : String,
   startTime : TimeSpan,
   endTime : TimeSpan,
   interval : TimeSpan,
   validFrom : DateTime,
   validUntil : DateTime
) : DailyPattern;

Parameters

everyNthDay
The daily execution interval for this recurrence pattern.
patternName
The name that identifies the recurrence pattern.
startTime
The time of a specific day when the recurrence pattern starts to occur.
endTime
The time of a specific day when the event stops being raised.
interval
The recurrence pattern repetition rate for a specific day.
validFrom
The date the recurrence pattern starts being valid.
validUntil
The date the recurrence pattern stops being valid.

Return Value

The DailyPattern.

Exceptions

Exception Type Condition
ArgumentException The endTime parameter value is less than 0 or greater than 23:59:59.

-or-

The interval parameter value is less than 0 or greater than 23:59:59.

-or-

The patternName parameter value is greater than 255 characters.

-or-

The startTime parameter value is less than 0 or greater than 23:59:59.

-or-

The everyNthDay parameter value is less than or equal to 0.

ArgumentNullException The patternName parameter value is a null reference (in Visual Basic Nothing).

Remarks

When a pattern is added, the next scheduled time is automatically recalculated.

If the ValidFrom property is greater than the ValidUntil property, the values are switched.

See Also

RecurrencePatterns Class | RecurrencePatterns Members | System.Timers Namespace | RecurrencePatterns.AddDailyPattern Overload List | DailyPattern | DateTime | TimeSpan