Abrufen von Kalenderausschlüssen

Abrufen von Kalenderausschlüssen

Bei der Arbeit mit Projektkalendern in Aspose.Tasks for .NET kann es erforderlich sein, Ausnahmedaten wie Feiertage, spezielle Arbeitstage oder geplante arbeitsfreie Zeiträume abzurufen. Diese Ausnahmen sind entscheidend für die genaue Analyse von Projektplänen und -dauern.

Die Klasse Calendar bietet über die Eigenschaft Exceptions Zugriff auf Kalenderausschlüsse. Diese Eigenschaft gibt eine Sammlung von CalendarException-Objekten zurück, von denen jedes einen bestimmten Ausnahmzeitraum darstellt.

Jede CalendarException bietet unter anderem folgende Eigenschaften:

• FromDate: Startdatum des Ausnahmzeitraums.
• ToDate: Enddatum des Ausnahmzeitraums.
• DayWorking: Gibt an, ob der Tag ein Arbeitstag ist.
• EnteredByOccurrences: Gibt an, ob die Ausnahme wiederholt auftritt.

Durch Iterieren über die Exceptions-Sammlung können alle definierten Kalenderausschlüsse in einem Projekt überprüft oder weiterverarbeitet werden.

Beispiel: Abrufen von Kalenderausschlüssen

Das folgende Beispiel zeigt, wie ein Projekt geladen und alle Kalenderausschlüsse seiner Kalender aufgelistet werden.

Project project = new Project("New Project.mpp");

// Access calendars
foreach (Calendar cal in project.Calendars)
{
    // Access calendar exceptions
    foreach (CalendarException calExc in cal.Exceptions)
    {
        Console.WriteLine("From: " + calExc.FromDate.ToShortDateString());
        Console.WriteLine("To: " + calExc.ToDate.ToShortDateString());
    }
}

Fazit

Der Zugriff auf Kalenderausschlüsse ermöglicht ein vollständiges Verständnis der Arbeitszeitkonfiguration eines Projekts. Dies ist besonders nützlich beim Implementieren benutzerdefinierter Planungslogik, beim Erstellen von Berichten oder beim Überprüfen korrekt definierter arbeitsfreier Zeiten.

Für weiterführende Szenarien lesen Sie auch:

• Festlegen von Wochentagen für Ausnahmen
• Verarbeiten von Wiederholungen für Ausnahmen