Quelltext der Seite .NET MAUI: Kalendereintrag unter Android erstellen

{{Steckbrief
| gilt_fuer   = .NET MAUI 9/10 bzw. .NET for Android; Android 8 bis 16
| bereich     = Softwareentwicklung
| dauer       = ca. 20 Minuten
| rechte      = Entwicklungsumgebung; Variante 2: Kalenderberechtigung des Benutzers
| stand       = Oktober 2026
}}
'''Einen Kalendereintrag unter Android erstellen''' – etwa für einen Servicetermin aus einer Außendienst-App – geht in .NET MAUI auf zwei Wegen: Am einfachsten öffnet die App den Kalender des Geräts mit vorausgefüllten Daten, und der Benutzer bestätigt. Soll der Termin ohne Rückfrage eingetragen werden, schreibt die App direkt über den <code>CalendarContract</code> von Android – dafür ist eine Laufzeitberechtigung nötig.

[[Datei:NET-MAUI-Kalendereintrag-Android.png|thumb|center|750px|Kalendereintrag unter Android: per Intent die Kalender-App mit vorausgefülltem Termin öffnen oder mit Laufzeitberechtigung direkt über den CalendarContract schreiben.]]

== Variante 1: Kalender-App mit vorausgefülltem Termin öffnen (empfohlen) ==
Keine Berechtigung nötig, der Benutzer sieht und bestätigt den Termin. Der Code liegt in <code>Platforms/Android</code> oder wird mit <code>#if ANDROID</code> eingeschlossen:
<syntaxhighlight lang="csharp">
#if ANDROID
using Android.Content;
using Android.Provider;

public static class AndroidKalender
{
    public static void TerminVorschlagen(string titel, string ort, string beschreibung,
                                         DateTimeOffset beginn, DateTimeOffset ende)
    {
        var intent = new Intent(Intent.ActionInsert)
            .SetData(CalendarContract.Events.ContentUri)
            .PutExtra(CalendarContract.ExtraEventBeginTime, beginn.ToUnixTimeMilliseconds())
            .PutExtra(CalendarContract.ExtraEventEndTime, ende.ToUnixTimeMilliseconds())
            .PutExtra(CalendarContract.Events.InterfaceConsts.Title, titel)
            .PutExtra(CalendarContract.Events.InterfaceConsts.EventLocation, ort)
            .PutExtra(CalendarContract.Events.InterfaceConsts.Description, beschreibung);

        Platform.CurrentActivity?.StartActivity(intent);
    }
}
#endif
</syntaxhighlight>
<code>ToUnixTimeMilliseconds()</code> ersetzt die früher nötige Hilfsmethode zur Umrechnung von <code>DateTime</code> in Millisekunden.

== Variante 2: Termin direkt eintragen ==
=== Schritt 1: Berechtigungen deklarieren ===
In <code>Platforms/Android/AndroidManifest.xml</code>:
<syntaxhighlight lang="xml">
<uses-permission android:name="android.permission.READ_CALENDAR" />
<uses-permission android:name="android.permission.WRITE_CALENDAR" />
</syntaxhighlight>

=== Schritt 2: Berechtigung zur Laufzeit anfragen ===
<syntaxhighlight lang="csharp">
var status = await Permissions.RequestAsync<Permissions.CalendarWrite>();
if (status != PermissionStatus.Granted)
{
    await Shell.Current.DisplayAlertAsync("Kalender",
        "Ohne Kalenderzugriff kann der Termin nicht eingetragen werden.", "OK");
    return;
}
</syntaxhighlight>
Für das Ermitteln des Zielkalenders zusätzlich <code>Permissions.CalendarRead</code> anfragen.

=== Schritt 3: Eintrag schreiben ===
<syntaxhighlight lang="csharp">
#if ANDROID
using Android.Content;
using Android.Provider;

public static long TerminEintragen(long kalenderId, string titel,
                                   DateTimeOffset beginn, DateTimeOffset ende)
{
    var values = new ContentValues();
    values.Put(CalendarContract.Events.InterfaceConsts.CalendarId, kalenderId);
    values.Put(CalendarContract.Events.InterfaceConsts.Title, titel);
    values.Put(CalendarContract.Events.InterfaceConsts.Dtstart, beginn.ToUnixTimeMilliseconds());
    values.Put(CalendarContract.Events.InterfaceConsts.Dtend, ende.ToUnixTimeMilliseconds());
    values.Put(CalendarContract.Events.InterfaceConsts.EventTimezone, TimeZoneInfo.Local.Id);

    var uri = Platform.AppContext.ContentResolver!
        .Insert(CalendarContract.Events.ContentUri, values);
    return long.Parse(uri!.LastPathSegment!);      // ID des neuen Termins
}
#endif
</syntaxhighlight>
Die <code>kalenderId</code> ermitteln Sie per Abfrage von <code>CalendarContract.Calendars.ContentUri</code> (z. B. den ersten beschreibbaren Kalender des Google- oder Exchange-Kontos).

== Hinweise ==
* '''Variante 1 bevorzugen:''' Weniger Berechtigungen bedeuten weniger Rückfragen in der Google-Play-Prüfung und mehr Vertrauen der Benutzer.
* '''Plattformübergreifend:''' Für Android ''und'' iOS bietet sich ein Community-Plugin für Kalenderzugriff an (z. B. ''Plugin.Maui.CalendarStore''); unter iOS ist zusätzlich ein Nutzungshinweis in der <code>Info.plist</code> nötig.
* '''Zeitzonen:''' Termine immer als <code>DateTimeOffset</code> bzw. UTC übergeben, sonst verschieben sie sich bei Sommer-/Winterzeit.
* Bei Außendienst- und Service-Apps mit Kalender- und Groupware-Anbindung unterstützt Sie die [https://www.max-it.de/development/individuelle-softwareentwicklung/ individuelle Softwareentwicklung von m.a.x. it].

== Siehe auch ==
* [[Von Xamarin zu .NET MAUI migrieren]]
* [[.NET MAUI: Kein Internet im Android-Emulator]]

== Links und Quellen ==
* [https://learn.microsoft.com/de-de/dotnet/maui/platform-integration/appmodel/permissions Microsoft Learn: Berechtigungen in .NET MAUI]
* [https://www.max-it.de/development/individuelle-softwareentwicklung/ Individuelle Softwareentwicklung und App-Entwicklung von m.a.x. it]

{{Uebermax}}
[[Kategorie:Softwareentwicklung]]