例外の発生回数を処理する

プロジェクトカレンダーで繰り返しの例外（たとえば毎年の祝日や季節的な休業など）を定義する場合、その例外が何回繰り返されるかを指定することが重要です。Aspose.Tasks for .NET では、 CalendarException クラスの Occurrences プロパティを使用してこれを設定します。

このプロパティは整数値を受け取り、定義された FromDate から開始して例外が発生する回数を示します。たとえば、毎年の祝日を表す例外に対して Occurrences = 5 を設定すると、その例外は 5 年間適用されます。

例：複数回発生する例外を定義する

以下のコード例では、毎年繰り返される例外を 5 年間設定する方法を示します。

1// Define exception and specify occurrences
2CalendarException except = new CalendarException();
3except.EnteredByOccurrences = true;
4except.Occurrences = 5;
5except.Type = CalendarExceptionType.YearlyByDay;

Examples-CSharp-WorkingWithCalendarExceptions-HandleExceptionOccurences.cs hosted with ❤ by GitHub

まとめ

Occurrences プロパティを使用することで、繰り返し発生する例外を構造的かつ制御された方法で定義できます。これは、長期プロジェクト期間中に毎年発生する祝日などの非稼働日を自動化する際に特に便利です。

関連するシナリオについては、以下もご参照ください：

例外に適用する曜日を定義するタスクの操作