CalendarContract.Events Klasse

Definition

[Android.Runtime.Register("android/provider/CalendarContract$Events", DoNotGenerateAcw=true)]
public sealed class CalendarContract.Events : Java.Lang.Object

[<Android.Runtime.Register("android/provider/CalendarContract$Events", DoNotGenerateAcw=true)>]
type CalendarContract.Events = class
    inherit Object

Vererbung

Object

JavaObject

Object

CalendarContract.Events

Attribute

RegisterAttribute

Hinweise

Konstanten und Hilfsprogramme für die Tabelle "Ereignisse", die Details zu einzelnen Ereignissen enthält. <h3>Operations</h3> Alle Vorgänge können entweder als App oder als Synchronisierungsadapter ausgeführt werden. Um einen Vorgang als Synchronisierungsadapter #CALLER_IS_SYNCADAPTER auszuführen, sollte auf "true" festgelegt sein und #ACCOUNT_NAME#ACCOUNT_TYPE in den URI-Parametern festgelegt werden. Ausführliche Informationen zum Hinzufügen von Parametern finden Sie Uri.Builder#appendQueryParameter(java.lang.String, java.lang.String) unter. Synchronisierungsadapter haben Schreibzugriff auf mehr Spalten, sind aber gleichzeitig auf ein einzelnes Konto beschränkt. <dl>dt b Insert/b</dt><>dd<Beim Einfügen eines neuen Ereignisses müssen die folgenden Felder enthalten sein: ><ul><li>dtstart</li li><>dtend, wenn das Ereignis nicht periodisch</li li><>dauer ist, wenn das Ereignis wiederkehrende</li li><>rrule oder rdate ist, wenn das Ereignis recurring</li li><>eventTimezone</li li li><>a calendar_id</li></ul><><> Es gibt auch weitere Anforderungen beim Einfügen oder Aktualisieren eines Ereignisses. Weitere Informationen finden Sie im Abschnitt "Schreiben in Ereignisse".</dd><dt><b>Update</b></dt><dd>To perform an update of an Event the event the Events#_ID event should be provided either as an appended id to the URI ( ContentUris#withAppendedId) or as the first selection item-the selection should start with "_id=?" und die erste selectionArg sollte die _id des Ereignisses sein. Updates können auch mithilfe einer Auswahl und ohne ID durchgeführt werden. Das Aktualisieren eines Ereignisses muss die gleichen Regeln wie das Einfügen beachten und in den Feldern, die geschrieben werden können, weiter eingeschränkt werden. Weitere Informationen finden Sie im Abschnitt "Schreiben in Ereignisse".</dd><dt><b>Delete</b></dt><dd-Ereignisse>können entweder durch die Events#_ID angefügte ID im URI oder mithilfe einer Standardauswahl gelöscht werden. Wenn eine angefügte ID verwendet wird, ist eine Auswahl nicht zulässig. Es gibt zwei Löschversionen: als App und als Synchronisierungsadapter. Eine App-Löschdatei legt die gelöschte Spalte für ein Ereignis fest und entfernt alle Instanzen dieses Ereignisses. Eine Synchronisierungsadapterlöschung entfernt das Ereignis aus der Datenbank und alle zugehörigen Daten.</dd><dt><b>Query</b></dt><dd>Querying the Events table will get you all information about a set of events except their reminders, attendees, and extended properties. Es wird eine Zeile für jedes Ereignis zurückgegeben, das der Abfrageauswahl entspricht, oder höchstens eine einzelne Zeile, wenn der Events#_ID URI angefügt wird. Wiederkehrende Ereignisse geben nur eine einzelne Zeile zurück, unabhängig davon, wie oft das Ereignis wiederholt wird.</dd></dl><h3>Schreiben in Ereignisse</h3> Es gibt weitere Einschränkungen für alle Updates und Einfügungen in der Tabelle "Events": <ul><li>If allDay is set to 1 eventTimezone must be "UTC" and the time must correspond to a mitternacht boundary.</li li><>Ausnahmen dürfen nicht erneut auftreten. Wenn rrule oder rdate nicht leer ist, müssen original_id und original_sync_id leer sein.</li li><>Im Allgemeinen sollte ein calendar_id nach der Einfügung nicht geändert werden. Dies ist nicht explizit verboten, aber viele Synchronisierungsadapter verhalten sich nicht erwartungsgemäß, wenn die calendar_id geändert wird.</li></ul> Die folgenden Ereignisspalten können sowohl von einer App als auch von einem Synchronisierungsadapter geschrieben werden. <ul><li>#CALENDAR_ID</li><>#ORGANIZER</li/li><>#TITLE</li/><>#EVENT_LOCATION<li><>#DESCRIPTION</li/li><>#EVENT_COLOR</li/><>#DTSTART<li/li/li/><>#DTEND<><>#EVENT_TIMEZONE<><>#EVENT_END_TIMEZONE<><>#DURATION<><>#ALL_DAY<li/li><>#RRULE<><li>#RDATE</li><>#EXRULE</li/li><>#EXDATE</li/><>#ORIGINAL_ID<li/><>#ORIGINAL_SYNC_ID<li/li/li><>#ORIGINAL_INSTANCE_TIME</li/><>#ORIGINAL_ALL_DAY<li/><>#ACCESS_LEVEL<><>#AVAILABILITY<><>#GUESTS_CAN_MODIFY<><>#GUESTS_CAN_INVITE_OTHERS<><>#GUESTS_CAN_SEE_GUESTS<><li>#CUSTOM_APP_PACKAGE</li><>#CUSTOM_APP_URI</li/li><>#UID_2445</li></ul> Die folgenden Ereignisspalten sind nur durch einen Synchronisierungsadapter <ul><li>#DIRTY</li><>#MUTATORS</li/><>#_SYNC_ID<li/><>#SYNC_DATA1<li/li/><>#SYNC_DATA2<li/li><>#SYNC_DATA3< beschreibbar><li>#SYNC_DATA4</li><>#SYNC_DATA5</li/li><>#SYNC_DATA6</li/><>#SYNC_DATA7<li/li/><>#SYNC_DATA8<li><>#SYNC_DATA9</li/li><>#SYNC_DATA10</li></ul> Die verbleibenden Spalten werden entweder nur vom Anbieter aktualisiert oder sind Ansichten in anderen Tabellen und können nicht über die Tabelle "Events" geändert werden.

Java Dokumentation für android.provider.CalendarContract.Events.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.