Arbeiten mit Kalendereigenschaften

Überblick

Kalender in Microsoft Project definieren die Arbeits- und Ruhezeiten für das gesamte Projekt sowie für einzelne Aufgaben und Ressourcen. Aspose.Tasks for .NET bietet programmgesteuerten Zugriff auf diese Kalender, einschließlich deren Basishierarchie, Benennung und eindeutiger Identifikation.

Dieser Artikel beschreibt, wie Sie mit der Aspose.Tasks API auf allgemeine Kalendereigenschaften zugreifen und diese ändern können.

Wichtige Kalendereigenschaften

Die Klasse Calendar stellt mehrere zentrale Eigenschaften zur Verfügung, die die Identität und Struktur eines Kalenders definieren:

• BaseCalendar: Verweist auf einen anderen Kalender, von dem der aktuelle Kalender Arbeitszeiten erbt. Diese Eigenschaft ist nur relevant, wenn es sich nicht um einen Basiskalender handelt.
• Name: Der lesbare Name des Kalenders, wie er in der Benutzeroberfläche und in Berichten angezeigt wird.
• Uid: Eine eindeutige Ganzzahlkennung, die zur Identifikation und Verknüpfung von Kalendern innerhalb der Projektdatei verwendet wird.

Diese Eigenschaften sind entscheidend beim Arbeiten mit Kalenderlisten, beim Zuweisen von Kalendern zu Ressourcen oder beim Exportieren der Projektstruktur in andere Formate.

Lesen von Kalendermetadaten

Das folgende Codebeispiel zeigt, wie man allgemeine Kalendereigenschaften wie Name, UID und Basiskalenderverweis ausliest und anzeigt.

// Load an existing project
Project project = new Project("Project_GeneralCalendarProperties.xml");

foreach (Calendar cal in project.Calendars)
{
    if (cal.Name != null)
    {
        Console.WriteLine("UID : " + cal.Uid.ToString() + " Name: " + cal.Name);

        // Show if it is has a base calendar
        Console.Write("Base Calendar : ");
        if (cal.IsBaseCalendar)
            Console.WriteLine("Self");
        else
            Console.WriteLine(cal.BaseCalendar.Name);

        // Get Time in hours on each working day
        foreach (WeekDay wd in cal.WeekDays)
        {
            TimeSpan ts = wd.GetWorkingTime();
            Console.WriteLine("Day Type: " + wd.DayType.ToString() + " Hours: " + ts.ToString());
        }
    }
}

Beispielszenarien

Diese Eigenschaften werden typischerweise in folgenden Anwendungsfällen verwendet:

• Erstellen von Dokumentation oder Berichten mit Kalenderübersichten.
• Durchführung von Validierung oder Transformation der Projektstruktur.
• Verwaltung von Vererbungsketten zwischen Basiskalendern und abgeleiteten Aufgaben-/Ressourcenkalendern.

Durch das Verständnis und die gezielte Bearbeitung dieser Kerneigenschaften können Entwickler die Planungslogik effizient verwalten und die Kompatibilität mit den Erwartungen von Microsoft Project sicherstellen.