Управление встречами: создание и изменение, конвертация ICS в MSG

Создать встречу и сохранить её на диск в формате MSG или ICS

Этот Appointment класс в Aspose.Email для .NET может быть использован для создания новой встречи. В этой статье мы сначала создаём встречу и сохраняем её на диск в формате ICS. Для создания встречи и её сохранения на диск требуются следующие шаги.

Создать экземпляр Appointment класс и инициализировать его с помощью этого конструктора.
Передайте следующие аргументы в указанный выше конструктор
1. Место
2. Сводка
3. Описание
4. Дата начала
5. Дата завершения
6. Организатор
7. Участники
Вызвать Save() метод и указать имя файла и формат в аргументах.

Встречу можно открыть в Microsoft Outlook или любой программе, способной загрузить файл ICS. Если файл открыт в Microsoft Outlook, он автоматически добавит встречу в календарь Outlook.

Следующий фрагмент кода показывает, как создать и сохранить встречу на диск в формате ICS или MSG.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET

// Create and initialize an instance of the Appointment class
Appointment appointment = new Appointment(
    "Meeting Room 3 at Office Headquarters",// Location
    "Monthly Meeting",                      // Summary
    "Please confirm your availability.",    // Description
    new DateTime(2015, 2, 8, 13, 0, 0),     // Start date
    new DateTime(2015, 2, 8, 14, 0, 0),     // End date
    "from@domain.com",                      // Organizer
    "attendees@domain.com");                // Attendees

// Save the appointment to disk in ICS format            
appointment.Save(fileName + ".ics", new AppointmentIcsSaveOptions());
Console.WriteLine("Appointment created and saved to disk successfully.");

// Save the appointment to disk in MSG format
appointment.Save(fileName + ".msg", new AppointmentMsgSaveOptions(););
Console.WriteLine("Appointment created and saved to disk successfully.");

Создание встречи с HTML‑содержимым

Вы можете указать альтернативные представления описания события в разных типах контента, используя заголовок X-ALT-DESC. Это позволяет получателям файла iCalendar выбирать представление, которое лучше соответствует их потребностям. Например, можно включить описание в простом тексте с типом контента "text/plain" и описание в HTML с типом контента "text/html". Для каждого альтернативного представления добавляется заголовок X-ALT-DESC. Чтобы создать встречу с HTML‑содержимым, установите HtmlDescription свойство.

Попробуйте следующий пример кода для создания встречи с альтернативным HTML‑описанием:

Создайте новый экземпляр класса Appointment.
Передайте необходимые параметры в конструктор Appointment:
- Укажите место проведения встречи.
- Установите дату и время начала.
- Установите дату и время окончания.
- Укажите организатора.
- Укажите участника.
Установите HtmlDescription свойство объекта встречи, указывающее, что описание в формате HTML.
Установите свойство Description объекта встречи в строку формата HTML, заключённую в многострочную строку:
- Разметка HTML включает блок <style>, определяющий CSS‑класс с именем "text" со стилями шрифта.
- Тело HTML содержит тег абзаца <p> с CSS‑классом "text" и фактическое сообщение‑приглашение.
Объект встречи теперь готов, и вы можете выполнять дальнейшие операции или сохранить его как файл iCalendar.

var appointment = new Appointment("Bygget 83",
    DateTime.UtcNow, // start date
    DateTime.UtcNow.AddHours(1), // end date
    new MailAddress("TintinStrom@from.com", "Tintin Strom"), // organizer
    new MailAddress("AinaMartensson@to.com", "Aina Martensson")) // attendee
{
    HtmlDescription = @"
    <html>
     <style type=""text/css"">
      .text {
             font-family:'Comic Sans MS';
             font-size:16px;
            }
     </style>
    <body>
     <p class=""text"">Hi, I'm happy to invite you to our party.</p>
    </body>
    </html>"
};

Создание запроса черновика встречи

В наших предыдущих статьях было показано, как создать и сохранить встречу в формате ICS. Часто требуется создать запрос встречи в режиме черновика, чтобы базовая информация была внесена, а затем такой черновик встречи мог быть переслан другим пользователям для внесения необходимых изменений в соответствии с их потребностями. Чтобы сохранить встречу в режиме черновика, MethodType свойство класса Appointment должно быть установлено в AppointmentMethodType.Publish. Следующий фрагмент кода показывает, как создать черновик запроса встречи.

string sender = "test@gmail.com";
string recipient = "test@email.com";

MailMessage message = new MailMessage(sender, recipient, string.Empty, string.Empty);

Appointment app = new Appointment(string.Empty, DateTime.Now, DateTime.Now, sender, recipient)
{
    MethodType = AppointmentMethodType.Publish
};

message.AddAlternateView(app.RequestApointment());

MapiMessage msg = MapiMessage.FromMailMessage(message);

// Save the appointment as draft.
msg.Save(dstDraft);

Console.WriteLine(Environment.NewLine + "Draft saved at " + dstDraft);

Создание черновика встречи из текста

Следующий фрагмент кода показывает, как создать черновик встречи из текста.

string ical = @"BEGIN:VCALENDAR
METHOD:PUBLISH
PRODID:-//Aspose Ltd//iCalender Builder (v3.0)//EN
VERSION:2.0
BEGIN:VEVENT
ATTENDEE;CN=test@gmail.com:mailto:test@gmail.com
DTSTART:20130220T171439
DTEND:20130220T174439
DTSTAMP:20130220T161439Z
END:VEVENT
END:VCALENDAR";

string sender = "test@gmail.com";
string recipient = "test@email.com";
MailMessage message = new MailMessage(sender, recipient, string.Empty, string.Empty);
AlternateView av = AlternateView.CreateAlternateViewFromString(ical, new ContentType("text/calendar"));
message.AlternateViews.Add(av);
MapiMessage msg = MapiMessage.FromMailMessage(message);
msg.Save(dataDir + "draft_out.msg");

Настройка встреч

Установка статуса участников встречи

API Aspose.Email для .NET позволяет задавать статус участников встречи при формировании сообщения-ответа. Это добавляет свойство PARTSTAT в файлICS.

DateTime startDate = new DateTime(2011, 12, 10, 10, 12, 11),
         endDate = new DateTime(2012, 11, 13, 13, 11, 12);
MailAddress organizer = new MailAddress("aaa@amail.com", "Organizer");
MailAddressCollection attendees = new MailAddressCollection();
MailAddress attendee1 = new MailAddress("bbb@bmail.com", "First attendee");
MailAddress attendee2 = new MailAddress("ccc@cmail.com", "Second attendee");

attendee1.ParticipationStatus = ParticipationStatus.Accepted;
attendee2.ParticipationStatus = ParticipationStatus.Declined;
attendees.Add(attendee1);
attendees.Add(attendee2);

Appointment target = new Appointment(location, startDate, endDate, organizer, attendees);

Настройка идентификатора продукта для iCalendar

API Aspose.Email для .NET позволяет получать или задавать идентификатор продукта, создавшего объект iCalendar.

string description = "Test Description";
Appointment app = new Appointment("location", "test appointment", description, DateTime.Today,
DateTime.Today.AddDays(1), "first@test.com", "second@test.com");

IcsSaveOptions saveOptions = IcsSaveOptions.Default;
saveOptions.ProductId = "Test Corporation";
app.Save(dataDir + "ChangeProdIdOfICS.ics", saveOptions);

Загрузка встреч

Также Appointment класс может использоваться для загрузки встречи из файла ICS.

Загрузка встречи в формате ICS

Чтобы загрузить встречу в формате ICS, требуется выполнить следующие шаги:

Создать экземпляр Appointment класс.
Вызвать Load() метод, указывая путь к файлу ICS.
Прочитайте любое свойство, чтобы получить любую информацию о встрече (файл ICS).

Следующий фрагмент кода показывает, как загрузить встречу в формате ICS.

// Load an Appointment just created and saved to disk and display its details.
Appointment loadedAppointment = Appointment.Load(dstEmail);
Console.WriteLine(Environment.NewLine + "Loaded Appointment details are as follows:");
// Display the appointment information on screen
Console.WriteLine("Summary: " + loadedAppointment.Summary);
Console.WriteLine("Location: " + loadedAppointment.Location);
Console.WriteLine("Description: " + loadedAppointment.Description);
Console.WriteLine("Start date: " + loadedAppointment.StartDate);
Console.WriteLine("End date: " + loadedAppointment.EndDate);
Console.WriteLine("Organizer: " + appointment.Organizer);
Console.WriteLine("Attendees: " + appointment.Attendees);
Console.WriteLine(Environment.NewLine + "Appointment loaded successfully from " + dstEmail);

Конвертировать ICS в MSG

API позволяет легко преобразовать встречу в объект сообщения. Следующий пример кода показывает, как конвертировать запрос встречи в MailMessage или MapiMessage:

var appointment = Appointment.Load("appRequest.ics");

var eml = appointment.ToMailMessage();
var msg = appointment.ToMapiMessage();

Чтение нескольких событий из файла ICS

List<Appointment> appointments = new List<Appointment>();
CalendarReader reader = new CalendarReader(dataDir + "US-Holidays.ics");

while (reader.NextEvent())
{
    appointments.Add(reader.Current);
}
//working with appointments...

Записать несколько событий в файл ICS

IcsSaveOptions saveOptions = new IcsSaveOptions();
saveOptions.Action = AppointmentAction.Create;
using (CalendarWriter writer = new CalendarWriter(dataDir + "WriteMultipleEventsToICS_out.ics", saveOptions))
{
    for (int i = 0; i < 10; i++)
    {
        Appointment app = new Appointment(string.Empty, DateTime.Now, DateTime.Now, "sender@domain.com", "receiver@domain.com");
        app.Description = "Test body " + i;
        app.Summary = "Test summary:" + i;
        writer.Write(app);
    }
}

Определить версию встречи

Чтобы определить версию встречи, вы можете использовать Appointment.Version свойство Appointment класс. Это свойство помогает определить, на какой версии основаны их файлы, обеспечивая интеграцию с другими системами и приложениями.

Следующий образец кода показывает, как реализовать это свойство в вашем проекте:

var app = Appointment.Load("meeting.ics");

if (app.Version == 1.0)
{
    // do something
}

Работа с MIME‑сообщениями Работа с элементами Outlook