Compartir a través de


Objeto RecurrencePattern (Outlook)

Representa el patrón de frecuencia de las citas periódicas y tareas para el objeto AppointmentItem y TaskItem asociado.

Comentarios

Utilice el método GetRecurrencePattern para devolver el objeto RecurrencePattern asociado con un objeto AppointmentItem o TaskItem.

Llamar a GetRecurrencePattern o ClearRecurrencePattern tiene el efecto secundario de configurar la propiedad IsRecurring del elemento en consonancia. Esta propiedad se puede utilizar como sea necesario para filtrar eficientemente el objeto Items.

El tipo de patrón de frecuencia se indica mediante la propiedad RecurrenceType. La propiedad RecurrenceType es la primera propiedad que debe establecer.

Las siguientes propiedades son válidas para todos los patrones de frecuencia: EndTime, repeticiones, StartDate, StartTime o tipo.

En la tabla siguiente muestra las propiedades que son válidas para los diferentes tipos de frecuencia. Si se guarda el elemento y la propiedad es nula o contiene un valor no válido, se produce un error. Patrones mensual y anual sólo son válidos para un solo día. Los patrones semanales sólo son válidos como el o de la propiedad DayOfWeekMask.

RecurrenceType Propiedades Ejemplos
olRecursDaily Duración, hora de finalización, intervalo, NoEndDate, apariciones, PatternStartDate, PatternEndDate, StartTime Un valor de N para intervalo es cada N días.
olRecursWeekly DayOfWeekMask, duración, hora de finalización, intervalo, NoEndDate, repeticiones, PatternStartDate, PatternEndDate, StartTime Un valor de N para intervalo es cada N semanas. Un ejemplo de la propiedad DayofWeekMask es cada el martes, el miércoles y el jueves.
olRecursMonthly DayOfMonth, duración, hora de finalización, intervalo, NoEndDate, repeticiones, PatternStartDate, PatternEndDate, StartTime Un valor de N para intervalo es cada N meses. Un valor de N para DayofMonth es enésimo día del mes.
olRecursMonthNth DayOfWeekMask, duración, hora de finalización, intervalo, instancia, NoEndDate, apariciones, PatternStartDate, PatternEndDate, StartTime Un valor de N para intervalo es cada N meses. Un ejemplo de valor N de instancia es cada número indeterminado del martes. Un ejemplo de la propiedad DayofWeekMask es cada el martes y el miércoles.
olRecursYearly DayOfMonth, duración, hora de finalización, intervalo, MonthOfYear, NoEndDate, apariciones, PatternStartDate, PatternEndDate, StartTime Un valor de N para DayofMonth es el enésimo día del mes. Un ejemplo de MonthOfYear es febrero.
olRecursYearNth DayOfWeekMask, duración, hora de finalización, intervalo, instancia, NoEndDate, apariciones, PatternStartDate, PatternEndDate, StartTime Un ejemplo de valor N de instancia es el enésimo el martes. Un ejemplo de la propiedad DayofWeekMask es el martes, el miércoles y el jueves. Un ejemplo de MonthOfYear es febrero.

Cuando se trabaja con elementos de citas periódicas, debe liberar todas las referencias anteriores, obtener nuevas referencias al elemento de cita periódico antes de tener acceso o modificar el elemento y liberar estas referencias, tan pronto como termine y haya guardado los cambios. Esta práctica se aplica al objeto AppointmentItem periódico y cualquier objeto RecurrencePattern o de excepción. Para liberar una referencia en Visual Basic para Aplicaciones (VBA) o Visual Basic, establezca ese objeto existente en nada. En C#, liberar explícitamente la memoria para ese objeto. Para obtener un ejemplo de código, vea el tema para el objeto AppointmentItem.

Tenga en cuenta que incluso después de liberar la referencia e intentar obtener una nueva, si aún hay una referencia activa a uno de los objetos anteriores, mantenida por otro complemento o Outlook, la nueva referencia puede apuntar a una copia obsoleta del objeto. Por lo tanto, es importante liberar las referencias cuando termine con la cita periódica.

Métodos

Nombre
GetOccurrence

Propiedades

Nombre
Aplicación
Class
DayOfMonth
DayOfWeekMask
Duración
EndTime
Excepciones
Instancia
Intervalo de
MonthOfYear
NoEndDate
Repeticiones
Parent
PatternEndDate
PatternStartDate
RecurrenceType
Regenerar (Regenerate)
Session
StartTime

Consulte también

Referencia del modelo de objetos de Outlook RecurrencePattern (miembros de objeto)

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.