Administrar elementos del calendario de Outlook
Aspose.Email MapiCalendar La clase proporciona métodos y atributos para establecer varias propiedades de un elemento de calendario. Esta sección ofrece ejemplos de código para:
- Crear y Guardar Elementos de Calendario
- Guardar Elementos de Calendario como Archivos MSG
- Guardar IDs de Producto para Elementos de Calendario MAPI a ICS
- Obtener el número total de eventos
- Agregar Recordatorios Visuales
- Agregar Recordatorios de Audio
- Agregar/recuperar adjuntos de archivos de calendario
- Verificar el Estado de los Destinatarios en Solicitudes de Reunión
- Crear zona horaria de calendario MAPI a partir de la zona horaria estándar
- Establecer Recordatorios para Citas
- Convertir cita EML a MSG con cuerpo HTML
Crear y guardar elementos del calendario
El siguiente fragmento de código muestra cómo crear y guardar un elemento de calendario en formato ICS.
Guardar Elementos de Calendario como Archivos MSG
El siguiente fragmento de código muestra cómo guardar el elemento del calendario como MSG.
Guardar IDs de Producto para Elementos de Calendario MAPI a ICS
El ProductIdentifier propiedad del MapiCalendarIcsSaveOptions La clase se usa para guardar un elemento de calendario MAPI en un archivo iCalendar (ICS) preservando la información original de fecha y hora, así como un identificador de producto personalizado. La propiedad especifica el identificador del producto que creó el objeto iCalendar.
El siguiente ejemplo de código muestra cómo trabajar con datos iCalendar (ICS) dentro de un objeto de calendario MAPI:
var icsSaveOptions = new MapiCalendarIcsSaveOptions
{
KeepOriginalDateTimeStamp = true,
ProductIdentifier = "Foo Ltd"
};
mapiCalendar.Save("my.ics", icsSaveOptions);
Obtener Número Total de Eventos
La clase CalendarReader permite manejar eventos de calendario sin esfuerzo. Las siguientes propiedades y un método le permiten trabajar con múltiples eventos:
- CalendarReader.Count - La propiedad Count de la clase CalendarReader le permite obtener el número de componentes Vevent (eventos) presentes en el calendario, facilitando el seguimiento del número total de eventos.
- CalendarReader.IsMultiEvents - Esta propiedad determina si el calendario contiene varios eventos. Proporciona un valor booleano que indica si el calendario contiene más de un evento, ayudando a identificar calendarios con uno o varios eventos.
- CalendarReader.Method - La propiedad Method obtiene el tipo de método iCalendar asociado al objeto calendario. Devuelve el tipo de método, como “REQUEST”, “PUBLISH” o “CANCEL”, proporcionando información valiosa sobre el propósito del calendario.
- CalendarReader.Version - Obtiene la versión de iCalendar.
- CalendarReader.LoadAsMultiple() Este método permite cargar una lista de eventos de un calendario que contiene múltiples eventos. Devuelve una lista de objetos Appointment, facilitando el acceso y procesamiento individual de cada evento.
El siguiente ejemplo de código demuestra cómo puede implementar estas capacidades en su proyecto:
var reader = new CalendarReader(fileName);
Console.WriteLine("Calendar contains " + reader.Count + " events");
Console.WriteLine("The Version of the calendar is " + reader.Version);
Console.WriteLine("The Method of the calendar is " + reader.Method);
Console.WriteLine("Is calendar contains contains multiple events? - " + reader.IsMultiEvents);
List<Appointment> appointments = reader.LoadAsMultiple();
Agregar Recordatorios Visuales
El siguiente fragmento de código muestra cómo agregar un recordatorio visual a un calendario.
Agregar Recordatorios de Audio
El siguiente fragmento de código muestra cómo añadir un recordatorio de audio a un calendario.
Agregar/recuperar adjuntos de archivos de calendario
El siguiente fragmento de código muestra cómo agregar/recuperar adjuntos de archivos de calendario.
Verificar el Estado de los Destinatarios en Solicitudes de Reunión
El siguiente fragmento de código muestra cómo mostrar el estado de los destinatarios de una solicitud de reunión.
Crear zona horaria de calendario MAPI a partir de zona horaria estándar
El siguiente fragmento de código muestra cómo crear MapiCalendarTimeZone a partir de la zona horaria estándar.
Establecer Recordatorios para Citas
Se puede añadir un recordatorio cuando se crea una cita. Estas alarmas pueden activarse según diferentes criterios, como n minutos antes de que comience el programa, repetir n veces a intervalos de n. Se pueden usar distintas etiquetas para crear estos disparadores en el script encerrado entre BEGIN:VALARM y END:VALARM dentro de una cita. Existe una serie de variantes en las que el recordatorio puede configurarse en una cita.
Agregar Etiquetas para Configurar Recordatorios
El siguiente fragmento de código muestra cómo establecer un recordatorio añadiendo etiquetas.
Convertir cita EML a MSG con cuerpo HTML
Desde la versión 19.3, Aspose.Email ofrece la capacidad de convertir citas EML a MSG manteniendo el cuerpo HTML de la cita. Aspose.Email proporciona un MapiConversionOptions.ForcedRtfBodyForAppointment propiedad que tiene un valor predeterminado de true. Cuando el valor de MapiConversionOptions.ForcedRtfBodyForAppointment está configurado a true, el cuerpo de la cita se convierte a formato RTF. Para mantener el formato del cuerpo de la cita en HTML, establezca el valor de MapiConversionOptions.ForcedRtfBodyForAppointment a false.
El siguiente ejemplo demuestra el uso de MapiConversionOptions.ForcedRtfBodyForAppointment propiedad para mantener el formato del cuerpo de la cita en HTML.
Establecer el Estado de los Elementos de Calendario MAPI Manualmente
Establezca explícitamente el estado de un objeto de Calendario MAPI, anulando el comportamiento predeterminado. Esto permite un mejor control sobre los estados de los eventos del calendario, particularmente al manejar solicitudes de reunión recibidas. Por defecto, cuando se crea una reunión, su estado es MapiCalendarState.Meeting. Cuando se recibe en la bandeja de entrada del destinatario, cambia automáticamente a MapiCalendarState.Received, y su clase de mensaje se actualiza a “IPM.Schedule.Meeting.Request”. Usando SetStateForced permite establecer manualmente el estado a Received, lo que puede ser útil para conservar la información del organizador al guardar el calendario como un archivo MSG. Sin embargo, esto puede impedir el reenvío o reenvío adecuado de la reunión.
El ejemplo de código a continuación demuestra cómo crear un MapiCalendar objeto, asignar un organizador y establecer explícitamente su estado a ambos Meeting y Received usando SetStateForced. Luego guarda el elemento del calendario como un archivo .msg.
MapiCalendar appointment = new MapiCalendar(
"LAKE ARGYLE WA 6743",
"Appointment",
"This is a very important meeting :)",
new DateTime(2024, 5, 10, 12, 30, 0, DateTimeKind.Utc),
new DateTime(2024, 5, 10, 13, 30, 0, DateTimeKind.Utc));
appointment.Organizer = new MapiElectronicAddress
{
EmailAddress = "test@aaa.com",
DisplayName = "test display Name"
};
appointment.SetStateForced(MapiCalendarState.Meeting | MapiCalendarState.Received);
appointment.Save("appointment.msg", AppointmentSaveFormat.Msg);