Czytaj i twórz elementy Outlooka

Artykuł ten skupia się na pracy z różnymi elementami Outlooka, w tym kalendarza, kontaktów, zadań, dziennika, notatek i list dystrybucyjnych. W Aspose.Email dla .NET, te elementy są reprezentowane przez następujące klasy: MapiCalendar, MapiContact, MapiTask, MapiJournal, MapiNote i MapiDistributionList. Klasy te służą jako opakowania dla klasy MapiMessage, aby uprościć proces obsługi danych elementów z właściwości MAPI, zapewniając bardziej intuicyjny interfejs do uzyskiwania dostępu i manipulowania danymi elementów.

C# .NET API do wykonywania zadań związanych z e-mailem

Aby programowo pracować z elementami Outlooka w C#, zamierzamy użyć Aspose.Email dla .NET, nowoczesnej biblioteki, która pozwala łatwo zarządzać wiadomościami e-mail, kontaktami, spotkaniami, zadaniami i innymi elementami Outlooka. Niektóre kluczowe funkcje biblioteki obejmują odczyt i zapis wiadomości e-mail w różnych formatach, zarządzanie spotkaniami i zadaniami, pracę z kontaktami, integrację z serwerem Exchange oraz przeprowadzanie zaawansowanych operacji e-mailowych. W tym wpisie na blogu pokażemy, jak jej używać do interakcji z elementami Outlooka w aplikacjach .NET. Praktyczne przykłady i fragmenty kodu są dostarczane, aby pomóc Ci zrozumieć i wdrożyć funkcjonalności Aspose.Email dla .NET w Twoich projektach C#.

Aby skorzystać z możliwości API, można albo pobrać jego DLL, albo zainstalować go z NuGet używając następującego polecenia:

PM> Install-Package Aspose.Email

Ogólne podejście

Ogólne podejście do pracy z elementami Outlooka polega na załadowaniu obiektu MapiMessage, przekształceniu go w konkretną klasę elementu Outlooka (taką jak MapiContact lub MapiCalendar) i następnie uzyskaniu dostępu do jego właściwości lub ich manipulowaniu. To podejście upraszcza pracę z właściwościami MAPI i zapewnia prosty sposób zarządzania różnymi typami elementów Outlooka. Z drugiej strony, zawsze możesz wrócić do obiektu MapiMessage, po prostu wywołując metodę GetUnderlyingMessage na dowolnym obiekcie elementu.

Manipulowanie elementami kalendarza

Elementy kalendarza Outlooka są reprezentowane przez klasę MapiCalendar. Klasa ta zapewnia właściwości i metody do tworzenia, manipulowania i zarządzania elementami kalendarza, takimi jak spotkania, zebrania i wydarzenia w kalendarzu Outlooka. Użytkownicy mogą używać tej klasy do łatwego tworzenia, modyfikowania i interakcji z elementami kalendarza programowo w swoich aplikacjach .NET. W poniższych akapitach dowiesz się, jak tworzyć i odczytywać elementy kalendarza.

Odczytywanie elementów kalendarza

Poniższy przykład kodu demonstruje, jak załadować plik .msg jako obiekt MapiMessage. Następnie sprawdza, czy załadowana wiadomość jest typu Kalendarz za pomocą właściwości SupportedType. Jeśli jest to rzeczywiście element kalendarza, kod rzutuje wiadomość na obiekt MapiCalendar i następnie wyświetla szczegóły elementu kalendarza.

Oto kroki do kodu:

  1. Załaduj plik jako obiekt MapiMessage używając metody Load.
  2. Sprawdź, czy załadowana wiadomość jest typu Kalendarz.
  3. Jeśli jest to element kalendarza, rzutuj wiadomość na obiekt MapiCalendar.
  4. Wyświetl lokalizację, temat, datę rozpoczęcia i datę zakończenia elementu kalendarza.
var msg = MapiMessage.Load("calendar.msg");
if (msg.SupportedType == MapiItemType.Calendar)
{
var calendar = (MapiCalendar)msg.ToMapiMessageItem();
// Display calendar item details
Console.WriteLine($"Location: {calendar.Location}");
Console.WriteLine($"Subject: {calendar.Subject}");
Console.WriteLine($"Start: {calendar.StartDate}");
Console.WriteLine($"End: {calendar.EndDate}");
}
view raw ReadingCalendarItems.cs hosted with ❤ by GitHub

Tworzenie elementu kalendarza

Aby stworzyć nowy element kalendarza i zapisać go w różnych formatach, użyj poniższego przykładu kodu dostarczonego przez Aspose.Email:

  1. Stwórz nowy element kalendarza MapiCalendar z określonymi szczegółami, takimi jak lokalizacja, temat, opis, czas rozpoczęcia i czas zakończenia.
  2. Wywołaj metodę Save na obiekcie kalendarza z parametrami określającymi nazwę pliku wyjściowego i opcje zapisu. Element kalendarza jest zapisywany jako plik ICS (iCalendar) z rozszerzeniem “.ics” przy użyciu MapiCalendarSaveOptions.DefaultIcs.
  3. Podobnie, metoda Save jest wywoływana ponownie na obiekcie kalendarza, aby zapisać element kalendarza jako plik MSG (wiadomość Outlook) z rozszerzeniem “.msg” przy użyciu MapiCalendarSaveOptions.DefaultMsg.
// Create a new calendar item
var calendar = new MapiCalendar(
"Conference Room A",
"Project Kickoff Meeting",
"Discuss the project scope, milestones, and deliverables.",
new DateTime(2024, 6, 1, 9, 0, 0), // Start: June 1, 2024, 9:00 AM
new DateTime(2024, 6, 1, 10, 30, 0) // End: June 1, 2024, 10:30 AM
);
// Save to ICS
calendar.Save("calendar.ics", MapiCalendarSaveOptions.DefaultIcs);
// Save to MSG
calendar.Save("calendar.msg", MapiCalendarSaveOptions.DefaultMsg);
view raw CreatingCalendarItem.cs hosted with ❤ by GitHub

Manipulowanie elementami kontaktów

Aspose.Email oferuje klasę MapiContact, która jest używana do pracy z elementami kontaktów Microsoft Outlook. Pozwala programistom tworzyć, odczytywać, aktualizować i manipulować kontaktami Outlooka w różnych formatach, takich jak MSG i VCF. Klasa ta zapewnia właściwości i metody do ustawiania i pobierania informacji kontaktowych, w tym imienia, adresu e-mail, numerów telefonów, tytułu zawodowego, firmy i innych szczegółów kontaktowych.

Poniższe przykłady kodu demonstrują, jak używać klasy MapiContact do tworzenia i odczytywania kontaktów.

Odczytywanie elementów kontaktów

Proces odczytywania elementu kontaktu polega na załadowaniu wiadomości kontaktowej z pliku wiadomości MAPI i wyświetleniu szczegółów kontaktu:

  1. Załaduj obiekt MapiMessage z pliku używając MapiMessage.Load.
  2. Sprawdź, czy wspierany typ MapiMessage to Kontakt.
  3. Jeśli jest to Kontakt, przekształć MapiMessage na obiekt MapiContact.
  4. Wyświetl imię, e-mail i szczegóły firmy kontaktu.
var msg = MapiMessage.Load("contact.msg");
if (msg.SupportedType == MapiItemType.Contact)
{
var contact = (MapiContact)msg.ToMapiMessageItem();
// Display contact details
Console.WriteLine($"Name: {contact.NameInfo.DisplayName}");
Console.WriteLine($"Email: {contact.ElectronicAddresses.Email1.EmailAddress}");
Console.WriteLine($"Company: {contact.ProfessionalInfo.CompanyName}");
}
view raw ReadingContactItems.cs hosted with ❤ by GitHub

Tworzenie elementu kontaktu

Stwórzmy nowy kontakt przy użyciu klasy MapiContact, ustawiając różne właściwości, takie jak imię, adres e-mail i informacje o firmie, a następnie zapisz szczegóły kontaktu w formatach VCARD i MSG.

Proces obejmuje następujące kroki:

  1. Stwórz nowy obiekt MapiContact i zainicjalizuj jego właściwości, w tym imię, adres e-mail i informacje o firmie.
  2. Zapisz szczegóły kontaktu w formacie VCARD używając metody Save z parametrem ContactSaveFormat.VCard.
  3. Zapisz szczegóły kontaktu w formacie MSG używając metody Save z parametrem ContactSaveFormat.Msg.
// Create a new contact
var contact = new MapiContact
{
NameInfo = new MapiContactNamePropertySet("Felipe", "Cunha", "Pinto"),
ElectronicAddresses = new MapiContactElectronicAddressPropertySet
{
Email1 = new MapiContactElectronicAddress { EmailAddress = "Felipe.Pinto@example.com" }
},
ProfessionalInfo = new MapiContactProfessionalPropertySet { CompanyName = "Custom Service" }
};
// Save the contact to VCARD
contact.Save("contact.vcf", ContactSaveFormat.VCard);
// Save the contact to MSG
contact.Save("contact.msg", ContactSaveFormat.Msg);
view raw CreatingContactItem.cs hosted with ❤ by GitHub

Manipulowanie elementami zadań

Aspose.Email zapewnia rozwiązanie do efektywnego zarządzania zadaniami Outlooka. Klasa MapiTask jest doskonałym wyborem do tworzenia i odczytywania zadań bezproblemowo. Zobaczmy, jak ta klasa działa w kodzie.

Odczytywanie elementów zadań

Aby uzyskać dostęp do elementów zadań i nimi manipulować, załaduj jeden z pliku używając MapiMessage.Load. W kilku linijkach kodu możesz pobrać ważne szczegóły zadania, takie jak temat, status i procent ukończenia.

  1. Załaduj zadanie z pliku używając MapiMessage.Load.
  2. Sprawdź, czy załadowana wiadomość jest typu MapiItemType Task.
  3. Jeśli wiadomość jest zadaniem, przekształć ją na typ MapiTask.
  4. Wyświetl szczegóły zadania, drukując temat, status i procent ukończenia.
// Load a task from a file
var msg = MapiMessage.Load("task.msg");
if (msg.SupportedType == MapiItemType.Task)
{
var task = (MapiTask)msg.ToMapiMessageItem();
// Display task details
Console.WriteLine($"Subject: {task.Subject}");
Console.WriteLine($"Status: {task.Status}");
Console.WriteLine($"Percent Complete: {task.PercentComplete}");
}
view raw ReadingTaskItem.cs hosted with ❤ by GitHub

Tworzenie elementu zadania

Poniższy przykład kodu demonstruje, jak stworzyć element zadania, ustawić jego właściwości, takie jak tytuł, opis, daty rozpoczęcia i zakończenia, procent ukończenia oraz status, i zapisać go jako plik MSG:

  1. Stwórz nowy obiekt zadania używając klasy MapiTask z określonymi szczegółami, takimi jak tytuł, opis, data rozpoczęcia, data zakończenia, procent ukończenia i status.
  2. Ustaw właściwość PercentComplete zadania i właściwość Status.
  3. Zapisz utworzone zadanie do pliku MSG używając metody Save z parametrem TaskSaveFormat.Msg jako format.
// Create a new task
var task = new MapiTask(
"Develop Feature X",
"Develop the new feature X for the upcoming release.",
DateTime.Now,
DateTime.Now.AddDays(7)) // Task duration of 7 days
{
PercentComplete = 50,
Status = MapiTaskStatus.InProgress
};
// Save the task to MSG
task.Save("task.msg", TaskSaveFormat.Msg);
view raw CreatingTaskItem.cs hosted with ❤ by GitHub

Zarządzanie elementami dziennika

Wpis w dzienniku Outlooka jest reprezentowany przez klasę MapiJournal. Poniższe instrukcje poprowadzą Cię, jak utworzyć i odczytać wpis w dzienniku.

Odczytywanie elementu MapiJournal

Aby odczytać element MapiJournal, możesz załadować wiadomość dziennika używając metody MapiMessage.Load. Po zweryfikowaniu, że wspierany typ to Dziennik, możesz pobrać i wyświetlić szczegóły dziennika, takie jak temat, status dokumentu, czas rozpoczęcia i czas zakończenia.

  1. Załaduj wiadomość MAPI z pliku.
  2. Sprawdź, czy wspierany typ załadowanej wiadomości to element dziennika.
  3. Jeśli wiadomość jest typu Dziennik, przekształć ją na obiekt MapiJournal.
  4. Wyświetl szczegóły dziennika, w tym temat, status, czas rozpoczęcia i czas zakończenia.
var msg = MapiMessage.Load("journal.msg");
if (msg.SupportedType == MapiItemType.Journal)
{
var journal = (MapiJournal)msg.ToMapiMessageItem();
// Display journal details
Console.WriteLine($"Subject: {journal.Subject}");
Console.WriteLine($"Status: {journal.DocumentStatus}");
Console.WriteLine($"Start: {journal.StartTime}");
Console.WriteLine($"End: {journal.EndTime}");
}
view raw ReadingJournalItem.cs hosted with ❤ by GitHub

Tworzenie elementu MapiJournal

Teraz zamierzamy stworzyć wpis w dzienniku i uwzględnić szczegóły. Wpis będzie również zawierał krótki opis spotkania. Ten kod demonstruje, jak stworzyć i zapisać MapiJournal.

  1. Zdefiniuj nowy wpis dziennika używając klasy MapiJournal z określonymi szczegółami, takimi jak tytuł, opis, opis spotkania i podsumowanie dyskusji.
  2. Ustaw czas rozpoczęcia i zakończenia.
  3. Określ firmę i skategoryzuj wpis.
  4. Zapisz stworzony wpis dziennika do pliku używając metody Save.
// Create a new journal entry
var journal = new MapiJournal(
"Project Meeting",
"Discussed project milestones and deliverables.",
"Meeting Description",
"Brief: Milestone and Deliverables Discussion")
{
StartTime = DateTime.Now,
EndTime = DateTime.Now.AddMinutes(90), // Duration of 90 minutes
Companies = new[] { "Custom Service" },
Categories = new[] { "Meeting", "Project" }
};
// Save the journal entry
journal.Save("journal.msg");
view raw CreatingJournalItem.cs hosted with ❤ by GitHub

Zarządzanie elementami notatek

Aspose.Email oferuje klasę MapiNote, która reprezentuje notatkę Outlooka. Zapewnia rozwiązanie do efektywnego tworzenia i pobierania informacji o notatkach. Zobaczmy, jak to działa.

Odczytywanie elementu notatki

Aby uzyskać dostęp i wyświetlić szczegóły notatki, załaduj wiadomość notatki używając metody MapiMessage.Load i pobierz obiekt notatki. Następnie możesz uzyskać dostęp i pokazać konkretne szczegóły, takie jak temat, treść i kolor notatki do dalszego przetwarzania.

  1. Załaduj obiekt MapiMessage z pliku.
  2. Jeśli załadowana wiadomość jest typu Notatka, przekształć MapiMessage na obiekt MapiNote.
  3. Wydrukuj temat, treść i kolor przekształconego obiektu MapiNote.
var msg = MapiMessage.Load("note.msg");
if (msg.SupportedType == MapiItemType.Note)
{
var note = (MapiNote)msg.ToMapiMessageItem();
// Display note details
Console.WriteLine($"Subject: {note.Subject}");
Console.WriteLine($"Body: {note.Body}");
Console.WriteLine($"Color: {note.Color}");
}
view raw ReadingNoteItem.cs hosted with ❤ by GitHub

Tworzenie elementu notatki

Tworzenie nowej notatki jest łatwe, definiując właściwości tematu, treści i koloru notatki w nowym obiekcie MapiNote. Gdy notatka jest skonfigurowana, można ją zapisać jako plik wiadomości używając metody Save z określonym formatem pliku do przyszłego odniesienia i zarządzania.

  1. Stwórz nowy obiekt MapiNote z Tematem, Treścią i Kolorem.
  2. Zapisz notatkę do pliku msg, wywołując metodę Save.
// Create a new note
var note = new MapiNote
{
Subject = "Note Subject",
Body = "Note Body",
Color = NoteColor.Yellow
};
// Save the note
note.Save("note.msg", NoteSaveFormat.Msg);
view raw CreatingNoteItem.cs hosted with ❤ by GitHub

Zarządzanie listami dystrybucyjnymi

Aby stworzyć i odczytać listę dystrybucyjną Outlooka, zamierzamy użyć klasy MapiDistributionList. Poniższe przykłady kodu z krokami pomogą Ci zrozumieć, jak ta funkcjonalność może być zaimplementowana w projekcie.

Odczytywanie listy dystrybucyjnej

Aby odczytać element listy dystrybucyjnej, zacznij od załadowania go z pliku za pomocą metody MapiMessage.Load. Jeśli załadowany element jest typu DistList, możesz następnie wyświetlić jego szczegóły, takie jak nazwa i informacje o członkach.

  1. Załaduj listę dystrybucyjną z pliku.
  2. Sprawdź, czy załadowana wiadomość jest typu lista dystrybucyjna (DistList).
  3. Przekształć wiadomość na obiekt MapiDistributionList.
  4. Wyświetl nazwę listy dystrybucyjnej i członków.
// Load a distribution list from a file
var msg = MapiMessage.Load("dlist.msg");
if (msg.SupportedType == MapiItemType.DistList)
{
var dlist = (MapiDistributionList)msg.ToMapiMessageItem();
// Display distribution list details
Console.WriteLine($"Name: {dlist.DisplayName}");
foreach (var member in dlist.Members)
{
Console.WriteLine($"Member: {member.DisplayName}, Email: {member.EmailAddress}");
}
}
view raw ReadingDistributionList.cs hosted with ❤ by GitHub

Tworzenie listy dystrybucyjnej

Aby utworzyć nową listę dystrybucyjną, użyj przestrzeni nazw Aspose.Email.Mapi. Dodaj członków do niej, określając ich imiona i adresy e-mail. Możesz zapisać listę dystrybucyjną w formacie VCF lub MSG do przyszłego użytku.

  1. Stwórz nową listę dystrybucyjną za pomocą klasy MapiDistributionList.
  2. Dodaj członków do listy dystrybucyjnej wraz z ich adresami e-mail.
  3. Zapisz listę dystrybucyjną w formacie VCF używając metody Save.
  4. Zapisz listę dystrybucyjną w formacie MSG tą samą metodą Save.
// Create a new distribution list
var distributionList = new MapiDistributionList
{
DisplayName = "Project Team"
};
// Add members to the distribution list
distributionList.Members.Add(new MapiDistributionListMember("Mark Brown", "mark.brown@example.com"));
distributionList.Members.Add(new MapiDistributionListMember("Emily Taylor", "emily.taylor@example.com"));
// Save the distribution list to VCF format
distributionList.Save("distribution_list.vcf", new MapiDistributionListSaveOptions(ContactSaveFormat.VCard));
// Save the distribution list to MSG format
distributionList.Save("distribution_list.msg", new MapiDistributionListSaveOptions(ContactSaveFormat.Msg));
view raw CreatingDistributionList.cs hosted with ❤ by GitHub

Podsumowanie

W tym wpisie na blogu zbadaliśmy sposoby odczytywania i tworzenia elementów Outlooka, takich jak kalendarze, kontakty, zadania, wpisy w dzienniku, notatki i listy dystrybucyjne programowo w C#. Do kodowania użyliśmy Aspose.Email dla .NET, kompleksowej biblioteki, która ułatwia pracę z zadaniami związanymi z e-mailem, w tym manipulacjami różnymi elementami Outlooka. Wykorzystując klasy dostarczone przez bibliotekę, możesz tworzyć, odczytywać i manipulować tymi elementami z łatwością. Post ten zawierał podstawowe przykłady każdego elementu, stanowiąc podstawę do bardziej złożonych operacji, które mogą być potrzebne w Twoich aplikacjach. Intuicyjne przykłady kodu pomagają ocenić możliwości biblioteki i zrozumieć, jak wdrożyć jej funkcjonalności w swoim projekcie.

Czuj się swobodnie korzystając z naszych publicznych zasobów:

  • Dokumentacja API oferuje szczegółowe informacje o klasach i metodach.
  • Dokumentacja zawiera kompleksowe przewodniki z przykładami.
  • Forum wsparcia pozwala użytkownikom szukać pomocy i omawiać problemy.
  • Blog zawiera aktualizacje, samouczki i najlepsze praktyki.

Zobacz także