CalendarContract.Events Classe

Definição

[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

Herança

Object

JavaObject

Object

CalendarContract.Events

Atributos

RegisterAttribute

Comentários

Constantes e auxiliares para a tabela Eventos, que contém detalhes para eventos individuais. <H3>Operações</h3> Todas as operações podem ser feitas como um aplicativo ou como um adaptador de sincronização. Para executar uma operação como um adaptador de sincronização #CALLER_IS_SYNCADAPTER deve ser definido como true e #ACCOUNT_NAME deve #ACCOUNT_TYPE ser definido nos parâmetros de Uri. Consulte Uri.Builder#appendQueryParameter(java.lang.String, java.lang.String) detalhes sobre como adicionar parâmetros. Os adaptadores de sincronização têm acesso de gravação a mais colunas, mas são restritos a uma única conta por vez. <dl><dt><b>Insert</b></dt><dd>Ao inserir um novo evento, os seguintes campos deverão ser incluídos: <ul><li>dtstart</li><li>dtend se o evento não for recorrente</li><li>duração se o evento for recorrente</li><li>rrule ou rdate se o evento for recorrente</li><li>eventTimezone</li li><>a calendar_id</li></ul> Também há requisitos adicionais ao inserir ou atualizar um evento. Consulte a seção sobre Como escrever em eventos.</dd><dt><b>Update</b></dt><dd>Para executar uma atualização de um evento, o Events#_ID evento deve ser fornecido como uma ID acrescentada ao Uri ( ContentUris#withAppendedId) ou como o primeiro item de seleção – a seleção deve começar com "_id=?" e o primeiro selectionArg deve ser o _id do evento. As atualizações também podem ser feitas usando uma seleção e nenhuma ID. A atualização de um evento deve respeitar as mesmas regras que a inserção e é restrita ainda mais nos campos que podem ser gravados. Consulte a seção sobre Como escrever em eventos.</dd><dt><b>Delete</b></dt><dd>Eventos podem ser excluídos como Events#_ID uma ID acrescentada no Uri ou usando qualquer seleção padrão. Se uma ID acrescentada for usada, uma seleção não será permitida. Há duas versões de exclusão: como um aplicativo e como um adaptador de sincronização. Uma exclusão de aplicativo definirá a coluna excluída em um evento e removerá todas as instâncias desse evento. Uma exclusão do adaptador de sincronização removerá o evento do banco de dados e todos os dados associados.</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. Haverá uma linha retornada para cada evento que corresponde à seleção de consulta ou, no máximo, uma única linha se ela Events#_ID for acrescentada ao Uri. Eventos recorrentes retornarão apenas uma única linha, independentemente do número de vezes que o evento se repetir.</dd></dl><h3>Gravando em eventos</h3> Há mais restrições em todas as Atualizações e Inserções na tabela Eventos: <ul><li>Se allDay estiver definido como 1 eventTimezone deve ser "UTC" e a hora deve corresponder a um limite de meia-noite.<As exceções /li><li>não têm permissão para ocorrer novamente. Se rrule ou rdate não estiver vazio, original_id e original_sync_id deverão estar vazios.</li><li>Em geral, um calendar_id não deve ser modificado após a inserção. Isso não é explicitamente proibido, mas muitos adaptadores de sincronização não se comportarão de maneira esperada se o calendar_id for modificado.</li></ul> As colunas de eventos a seguir são graváveis por um aplicativo e um adaptador de sincronização. <ul><li>#CALENDAR_ID</li><li>#ORGANIZER</li><li>#TITLE</li><li>#EVENT_LOCATION</li><li>#DESCRIPTION</li><li>#EVENT_COLOR<><>/li#DTSTART<><li/li>#DTENDli<></li>#EVENT_TIMEZONEli<><>#EVENT_END_TIMEZONE</li li/li><li>#DURATION</li><li/li li>#ALL_DAY</li><li>#RRULE</li/li><li>#RDATE</li><li>#EXRULE</li><li>#EXDATE</li><li>#ORIGINAL_ID</li><li>#ORIGINAL_SYNC_ID</li><li>#ORIGINAL_INSTANCE_TIME</li><>#ORIGINAL_ALL_DAY<><>#ACCESS_LEVEL< li/li><li>#AVAILABILITY</li><>#GUESTS_CAN_MODIFY< li/li li/li><li>#GUESTS_CAN_INVITE_OTHERS</li li/li><li>#GUESTS_CAN_SEE_GUESTS</li/li><li>#CUSTOM_APP_PACKAGE</li><>#CUSTOM_APP_URI</li><li>#UID_2445</li></ul> As colunas de Eventos a seguir são graváveis somente por um adaptador de sincronização <ul><li>#DIRTY</li><>#MUTATORS</li><li>#_SYNC_ID</li><li>#SYNC_DATA1</li><li>#SYNC_DATA2</li><li>#SYNC_DATA3</li/li><li>#SYNC_DATA4</li><>#SYNC_DATA5</li><li>#SYNC_DATA6</li><li>#SYNC_DATA7</li><li>#SYNC_DATA8</li><>#SYNC_DATA9< li/li><>#SYNC_DATA10</ul><> As colunas restantes são atualizadas apenas pelo provedor ou são exibições em outras tabelas e não podem ser alteradas por meio da tabela Eventos.

Java documentação para android.provider.CalendarContract.Events.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.