Documentation – Outlook 저장소 파일 작업

Net: PST 파일 생성 및 관리

Mon, 01 Jan 0001 00:00:00 +0000

기존 PST 파일을 파싱하는 것뿐만 아니라, Aspose.Email은 처음부터 PST 파일을 생성하는 방법을 제공합니다. 이 기사에서는 Outlook PST 파일을 생성하고 하위 폴더 또는 메시지를 추가하는 방법을 보여줍니다.

PST 파일 생성

로컬 디스크에 새 PST 파일을 만들려면 다음을 사용해야 합니다: PersonalStorage class. 이 클래스를 사용하면 .NET 응용 프로그램에서 PST 파일을 생성, 읽기 및 조작할 수 있습니다. 한 줄의 코드로 스토리지 파일을 처음부터 생성합니다:

// Create new PST
using var pst = PersonalStorage.Create(path, FileFormatVersion.Unicode);

PST에 하위 폴더 추가

Root 폴더에 접근한 뒤 호출하여 PST 파일 루트에 하위 폴더를 추가합니다. AddSubFolder 메서드.

다음 코드 스니펫은 Inbox라는 하위 폴더를 추가하는 방법을 보여줍니다:

// Add new folder "Test"
pst.RootFolder.AddSubFolder("Inbox");

폴더 컨테이너 클래스 확인

새 폴더를 만들거나 기존 폴더에 항목을 추가할 때, 새로운 항목 또는 폴더의 컨테이너 클래스가 부모 폴더의 컨테이너 클래스와 일치하도록 하여 PST 저장 파일 내의 조직 계층 구조를 유지하는 것이 중요합니다. 이를 위해 Aspose.Email은 EnforceContainerClassMatching 속성 FolderCreationOptions class. 이 속성은 추가되는 폴더의 컨테이너 클래스가 부모 폴더의 컨테이너 클래스와 일치하는지 확인하도록 강제할지 여부를 지정합니다. ’true’로 설정하면 컨테이너 클래스가 일치하지 않을 경우 예외가 발생합니다. 기본값은 ‘false’입니다.

다음 코드 예제는 다음의 사용을 보여줍니다: EnforceContainerClassMatching 컨테이너 클래스가 일치하지 않는 폴더를 추가할 때 예외를 발생시킬지 여부를 제어하는 속성:

using (var pst = PersonalStorage.Create("storage.pst", FileFormatVersion.Unicode))
{
    // Create a standard Contacts folder with the IPF.Contacts container class.
    var contacts = pst.CreatePredefinedFolder("Contacts", StandardIpmFolder.Contacts);
    
    // An exception will not arise. EnforceContainerClassMatching is false by default.
    contacts.AddSubFolder("Subfolder1", "IPF.Note");
    
    // An exception will occur as the container class of the subfolder being added (IPF.Note) 
    // does not match the container class of the parent folder (IPF.Contact).
    contacts.AddSubFolder("Subfolder3", new FolderCreationOptions {EnforceContainerClassMatching = true, ContainerClass = "IPF.Note"});
}

참고: PST에서 폴더를 생성할 때 컨테이너 클래스 일치를 강제 적용하면 예외가 발생할 수 있으므로 적절히 처리하여 예기치 않은 동작을 방지하십시오.

폴더 컨테이너 클래스 변경

때때로 폴더 컨테이너 클래스를 변경해야 할 필요가 있습니다. 일반적인 예로, 서로 다른 유형(약속, 메시지 등)의 메시지를 동일한 폴더에 추가하는 경우가 있습니다. 이러한 경우, 폴더 내 모든 요소가 올바르게 표시되도록 폴더 클래스를 변경해야 합니다. 다음 코드 조각은 PST에서 폴더의 컨테이너 클래스를 변경하는 방법을 보여줍니다.

using var pst = PersonalStorage.FromFile("PersonalStorage1.pst);
var folder = pst.RootFolder.GetSubFolder("Inbox");

folder.ChangeContainerClass("IPF.Note");

PST에 파일 추가

Microsoft Outlook의 핵심 기능은 이메일, 캘린더, 작업, 연락처 및 저널 항목을 관리하는 것입니다. 또한 파일을 PST 폴더에 추가할 수 있으며, 이렇게 추가된 PST는 문서 기록을 유지합니다. Aspose.Email은 메시지, 연락처, 작업 및 저널 항목을 PST에 추가하는 것과 동일한 방식으로 폴더에 파일을 추가하는 기능을 제공합니다. 다음 코드 조각은 Aspose.Email을 사용하여 PST 폴더에 문서를 추가하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
using (var personalStorage = PersonalStorage.Create(dataDir + "Ps1_out.pst", FileFormatVersion.Unicode))
{
    var folder = personalStorage.RootFolder.AddSubFolder("Files");

    // Add Document.doc file with the "IPM.Document" message class by default.
    folder.AddFile(dataDir + "attachment_1.doc", null);
}

PST 파일에 메시지 추가

Aspose.Email을 사용하면 생성하거나 로드한 PST 파일의 하위 폴더에 메시지를 추가할 수 있습니다. 이 문서는 디스크에서 두 개의 메시지를 PST의 Inbox 하위 폴더에 추가합니다. 다음을 사용하십시오: PersonalStorage 및 FolderInfo PST 파일에 메시지를 추가하기 위한 클래스들. PST 파일의 Inbox 폴더에 메시지를 추가하려면:

FolderInfo 클래스의 인스턴스를 생성하고 Inbox 폴더의 내용을 로드합니다.
디스크에서 Inbox 폴더로 메시지를 추가하려면 다음을 호출합니다: FolderInfo.AddMessage() 메서드. FolderInfo 클래스는 다음을 노출합니다 AddMessages 대량의 메시지를 폴더에 추가하여 디스크 I/O 작업을 감소시키고 성능을 향상시키는 메서드입니다.

다음 코드 조각은 Inbox라는 PST 하위 폴더에 메시지를 추가하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Create new PST            
var personalStorage = PersonalStorage.Create(dataDir, FileFormatVersion.Unicode);

// Add new folder "Inbox"
personalStorage.RootFolder.AddSubFolder("Inbox");

// Select the "Inbox" folder
var inboxFolder = personalStorage.RootFolder.GetSubFolder("Inbox");

// Add some messages to "Inbox" folder
inboxFolder.AddMessage(MapiMessage.FromFile(RunExamples.GetDataDir_Outlook() + "MapiMsgWithPoll.msg"));

성능 향상을 위한 일괄 메시지 추가

PST에 개별 메시지를 추가하면 디스크에 대한 I/O 작업이 증가하여 성능이 저하될 수 있습니다. 성능을 개선하려면 대량 모드로 메시지를 추가하여 I/O 작업을 최소화할 수 있습니다. AddMessages 메서드를 사용하면 메시지를 일괄 추가할 수 있으며 다음 시나리오에서 사용할 수 있습니다. 또한, MessageAdded 폴더에 메시지가 추가될 때 발생하는 이벤트.

다른 PST에서 메시지 추가

다른 PST에서 메시지를 추가하려면, 다음을 사용합니다: FolderInfo.EnumerateMapiMessages 값을 반환하는 메서드 IEnumerable<MapiMessage>:

using var srcPst = PersonalStorage.FromFile(@"source.pst", false);
using var destPst = PersonalStorage.FromFile(@"destination.pst");

// Get the folder by name
var srcFolder = srcPst.RootFolder.GetSubFolder("SomeFolder");
var destFolder = destPst.RootFolder.GetSubFolder("SomeFolder");

destFolder.MessageAdded += new MessageAddedEventHandler(OnMessageAdded);
destFolder.AddMessages(srcFolder.EnumerateMapiMessages());


// Handles the MessageAdded event.
static void OnMessageAdded(object sender, MessageAddedEventArgs e)
{
    Console.WriteLine($"Added: {e.EntryId}");
}

디렉터리에서 메시지 추가

디렉터리에서 메시지를 추가하려면, 다음을 생성합니다: GetMessages(string pathToDir) 다음과 같은 값을 반환하는 명명된 반복자 메서드 IEnumerable<MapiMessage>:

using var pst = PersonalStorage.FromFile(@"storage.pst");
var folder = pst.RootFolder.GetSubFolder("SomeFolder");
folder.MessageAdded += OnMessageAdded;
folder.AddMessages(GetMessages(@"MessageDirectory"));

// Named iterator method to read messages from directory.
static IEnumerable<MapiMessage> GetMessages(string pathToDir)
{
    string[] files = Directory.GetFiles(pathToDir, "*.msg");

    foreach (var file in files)
    {
        yield return MapiMessage.Load(file);
    }
}

// Handles the MessageAdded event.
static void OnMessageAdded(object sender, MessageAddedEventArgs e)
{
    Console.WriteLine($"Added: {e.EntryId}");
}

디스크에서 메시지 로드

다음 코드 조각은 디스크에서 메시지를 로드하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
private static void AddMessagesInBulkMode(string fileName, string msgFolderName)
{
    using (PersonalStorage personalStorage = PersonalStorage.FromFile(fileName))
    {
        FolderInfo folder = personalStorage.RootFolder.GetSubFolder("myInbox");
        folder.MessageAdded += OnMessageAdded;
        folder.AddMessages(new MapiMessageCollection(msgFolderName));
    }
}
static void OnMessageAdded(object sender, MessageAddedEventArgs e)
{
    Console.WriteLine(e.EntryId);
    Console.WriteLine(e.Message.Subject);
}

IEnumerable 구현

다음 코드 조각은 IEnumerable 구현을 사용하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
public class MapiMessageCollection : IEnumerable<MapiMessage>
{
    private string path;

    public MapiMessageCollection(string path)
    {
        this.path = path;
    }

    public IEnumerator<MapiMessage> GetEnumerator()
    {
        return new MapiMessageEnumerator(path);
    }

    IEnumerator IEnumerable.GetEnumerator()
    {
        return GetEnumerator();
    }
}

public class MapiMessageEnumerator : IEnumerator<MapiMessage>
{
    private readonly string[] files;

    private int position = -1;

    public MapiMessageEnumerator(string path)
    {
        string path1 = RunExamples.GetDataDir_Outlook();
        files = Directory.GetFiles(path1);
    }

    public bool MoveNext()
    {
        position++;
        return (position < files.Length);
    }

    public void Reset()
    {
        position = -1;
    }

    object IEnumerator.Current
    {
        get
        {
            return Current;
        }
    }

    public MapiMessage Current
    {
        get
        {
            try
            {
                return MapiMessage.FromFile(files[position]);
            }
            catch (IndexOutOfRangeException)
            {
                throw new InvalidOperationException();
            }
        }
    }
    public void Dispose()
    {
    }
}

Net: PST 파일의 비동기 작업

Mon, 01 Jan 0001 00:00:00 +0000

현대 애플리케이션의 확장성과 응답성을 향상시키기 위해 Aspose.Email for .NET은 PST 파일 작업을 위한 비동기 메서드를 제공합니다. 이러한 새로운 API를 사용하면 개발자는 메인 스레드를 차단하지 않고 PST 파일을 생성, 열기, 병합 및 분할할 수 있어 UI 애플리케이션 및 고부하 서비스에 이상적입니다.

PST 파일을 비동기적으로 생성

다음은 PersonalStorage.CreateAsync 메서드는 새로운 PST 파일을 비동기적으로 생성할 수 있게 해주며, 대용량 데이터를 다루거나 응답성이 높은 UI가 필요한 애플리케이션에서 논블로킹 실행을 가능하게 합니다. 다음 코드 샘플은 이 기능을 C# 프로젝트에 구현하는 방법을 보여줍니다:

string pstFilePath = "newMailbox.pst";
var format = FileFormatVersion.Unicode;

// Create a new PST file asynchronously
using (var pst = await PersonalStorage.CreateAsync(pstFilePath, format, CancellationToken.None))
{
     Console.WriteLine($"PST file created at: {pstFilePath}");
}

PST 파일을 비동기적으로 열기

기존 PST 파일을 비동기적으로 열려면, 다음을 사용하십시오 the PersonalStorage.FromFileAsync Aspose.Email API의 메서드입니다. 다음 코드 샘플은 이 기능을 C# 프로젝트에 구현하는 방법을 보여줍니다:

string pstFilePath = "newMailbox.pst";
var format = FileFormatVersion.Unicode;

// Open the PST file asynchronously
        using (var pst = await PersonalStorage.FromFileAsync(pstFilePath, CancellationToken.None))
        {
            Console.WriteLine("PST file opened successfully.");

            // Access folders or messages here
            Console.WriteLine($"Root folder name: {pst.RootFolder.DisplayName}");
}

PST 파일을 비동기적으로 병합

다음은 MergeWithAsync Aspose.Email의 메서드 PersonalStorage 클래스는 한 PST 파일의 내용을 다른 파일에 비동기적으로 병합할 수 있게 합니다. 이는 메일 아카이브를 통합하거나 백업을 결합하거나 대량으로 이메일 데이터를 처리하는 등 애플리케이션의 메인 스레드를 차단하지 않는 시나리오에 유용합니다. 아래 코드 샘플은 C# 프로젝트에서 이 메서드를 사용하는 방법을 보여줍니다:

string targetPstPath = "mainMailbox.pst";
string sourcePstPath = "archiveToMerge.pst";

// Open both PST files asynchronously
using (var targetPst = await PersonalStorage.FromFileAsync(targetPstPath, CancellationToken.None))
using (var sourcePst = await PersonalStorage.FromFileAsync(sourcePstPath, CancellationToken.None))
{
    // Merge the source PST into the target PST
    await targetPst.MergeWithAsync(sourcePst, CancellationToken.None);

    Console.WriteLine("Merge operation completed successfully.");
}

PST 파일을 비동기적으로 분할

아래 코드 샘플은 기존 PST 파일을 비동기적으로 여는 방법을 보여줍니다 using FromFileAsync, 그리고 이를 사용하여 여러 파트로 분할합니다 SplitIntoAsync. 각 파트는 50 MB를 초과하지 않으며 지정된 출력 디렉터리에 저장됩니다. 비동기 실행을 통해 작업이 메인 스레드를 차단하지 않으므로 대용량 PST 아카이브를 처리하는 애플리케이션에 적합합니다.

using (var pst = await PersonalStorage.FromFileAsync("input.pst"))
{
    await pst.SplitIntoAsync(50 * 1024 * 1024, "part_", "outputDirectory", CancellationToken.None);
}

Net: PST 파일에서 메시지 관리

Mon, 01 Jan 0001 00:00:00 +0000

Outlook PST 파일에서 메시지 정보 가져오기

에서 PST 파일을 읽고 정보 검색 이 기사에서는 Outlook PST 파일을 로드하고 폴더를 탐색하여 폴더 이름과 해당 폴더에 있는 메시지 수를 얻는 방법을 논의했습니다. 이번 기사에서는 PST 파일의 모든 폴더와 하위 폴더를 읽고 메시지에 대한 정보(예: 제목, 발신자, 수신자)를 표시하는 방법을 설명합니다. Outlook PST 파일은 중첩 폴더를 포함할 수 있습니다. 최상위 폴더와 중첩 폴더 모두에서 메시지 정보를 얻으려면 재귀 메서드를 사용하여 모든 폴더를 읽어야 합니다. 다음 코드 조각은 Outlook PST 파일을 읽고 폴더와 메시지 내용을 재귀적으로 표시하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
public static void Run()
{            
    string dataDir = RunExamples.GetDataDir_Outlook();

    // Load the Outlook file
    string path = dataDir + "PersonalStorage.pst";

    try
    {
       
        // Load the Outlook PST file
        PersonalStorage personalStorage = PersonalStorage.FromFile(path);

        // Get the Display Format of the PST file
        Console.WriteLine("Display Format: " + personalStorage.Format);

        // Get the folders and messages information
        FolderInfo folderInfo = personalStorage.RootFolder;

        // Call the recursive method to display the folder contents
        DisplayFolderContents(folderInfo, personalStorage);
    }
    catch (Exception ex)
    {
        Console.WriteLine(ex.Message);               
    }            
}

/// <summary>
/// This is a recursive method to display contents of a folder
/// </summary>
/// <param name="folderInfo"></param>
/// <param name="pst"></param>
private static void DisplayFolderContents(FolderInfo folderInfo, PersonalStorage pst)
{
    // Display the folder name
    Console.WriteLine("Folder: " + folderInfo.DisplayName);
    Console.WriteLine("==================================");
    // Display information about messages inside this folder
    MessageInfoCollection messageInfoCollection = folderInfo.GetContents();
    foreach (MessageInfo messageInfo in messageInfoCollection)
    {
        Console.WriteLine("Subject: " + messageInfo.Subject);
        Console.WriteLine("Sender: " + messageInfo.SenderRepresentativeName);
        Console.WriteLine("Recipients: " + messageInfo.DisplayTo);
        Console.WriteLine("------------------------------");
    }

    // Call this method recursively for each subfolder
    if (folderInfo.HasSubFolders == true)
    {
        foreach (FolderInfo subfolderInfo in folderInfo.GetSubFolders())
        {
            DisplayFolderContents(subfolderInfo, pst);
        }
    }
}

PST 파일에서 메시지 추출

이 기사에서는 Microsoft Outlook PST 파일을 읽고 메시지를 추출하는 방법을 보여줍니다. 메시지는 MSG 형식으로 디스크에 저장됩니다.

사용해 보세요!

다음 명령을 실행하십시오 ConversationThread 간단한 앱 프로젝트이며, PST에서 이메일을 읽고 대화 스레드를 찾는 Aspose.Email 기능의 흥미로운 사용법을 탐색합니다.

다음 코드 조각은 PST 파일에서 메시지를 추출하는 방법을 보여줍니다:

재귀 메서드를 사용하여 모든 폴더(중첩 폴더 포함)를 탐색하고 PersonalStorage.ExtractMessage() 메서드를 호출하여 Outlook 메시지를 해당 인스턴스로 가져옵니다. MapiMessage 클래스.
그 후, MapiMessage.Save() 메서드를 호출하여 메시지를 디스크나 스트림에 MSG 형식으로 저장합니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
public static void Run()
{            
    // The path to the file directory.
    string dataDir = RunExamples.GetDataDir_Outlook();

    // Load the Outlook file
    string path = dataDir + "PersonalStorage.pst";

    try
    {
        // load the Outlook PST file
        PersonalStorage pst = PersonalStorage.FromFile(path);

        // get the Display Format of the PST file
        Console.WriteLine("Display Format: " + pst.Format);

        // get the folders and messages information
        FolderInfo folderInfo = pst.RootFolder;

        // Call the recursive method to extract msg files from each folder
        ExtractMsgFiles(folderInfo, pst);
    }
    catch (Exception ex)
    {
        Console.WriteLine(ex.Message);
    }            
}

/// <summary>
/// This is a recursive method to display contents of a folder
/// </summary>
/// <param name="folderInfo"></param>
/// <param name="pst"></param>
private static void ExtractMsgFiles(FolderInfo folderInfo, PersonalStorage pst)
{
    // display the folder name
    Console.WriteLine("Folder: " + folderInfo.DisplayName);
    Console.WriteLine("==================================");
    // loop through all the messages in this folder
    MessageInfoCollection messageInfoCollection = folderInfo.GetContents();
    foreach (MessageInfo messageInfo in messageInfoCollection)
    {
        Console.WriteLine("Saving message {0} ....", messageInfo.Subject);
        // get the message in MapiMessage instance
        MapiMessage message = pst.ExtractMessage(messageInfo);
        // save this message to disk in msg format
        message.Save(message.Subject.Replace(":", " ") + ".msg");
        // save this message to stream in msg format
        MemoryStream messageStream = new MemoryStream();
        message.Save(messageStream);
    }

    // Call this method recursively for each subfolder
    if (folderInfo.HasSubFolders == true)
    {
        foreach (FolderInfo subfolderInfo in folderInfo.GetSubFolders())
        {
            ExtractMsgFiles(subfolderInfo, pst);
        }
    }
}

MAPI 항목 유형 식별

다음은 MapiItemType enum은 해당 클래스에서 파생된 객체로 명시적으로 변환할 수 있는 MAPI 항목 유형을 나타냅니다. IMapiMessageItem 인터페이스. 이렇게 하면 사용자가 확인을 피할 수 있습니다 MessageClass 메시지 변환 전 속성 값.

다음 코드 샘플은 변환될 항목의 타입을 정의하는 방법을 보여줍니다:

foreach (var messageInfo in folder.EnumerateMessages())
{
    var msg = pst.ExtractMessage(messageInfo);

    switch (msg.SupportedType)
    {
        // Non-supported type. MapiMessage cannot be converted to an appropriate item type.
        // Just use in MSG format.
        case MapiItemType.None:
            break;
        // An email message. Conversion isn't required.
        case MapiItemType.Message:
            break;
        // A contact item. Can be converted to MapiContact.
        case MapiItemType.Contact:
            var contact = (MapiContact)msg.ToMapiMessageItem();
            break;
        // A calendar item. Can be converted to MapiCalendar.
        case MapiItemType.Calendar:
            var calendar = (MapiCalendar)msg.ToMapiMessageItem();
            break;
        // A distribution list. Can be converted to MapiDistributionList.
        case MapiItemType.DistList:
            var dl = (MapiDistributionList)msg.ToMapiMessageItem();
            break;
        // A Journal entry. Can be converted to MapiJournal.
        case MapiItemType.Journal:
            var journal = (MapiJournal)msg.ToMapiMessageItem();
            break;
        // A StickyNote. Can be converted to MapiNote.
        case MapiItemType.Note:
            var note = (MapiNote)msg.ToMapiMessageItem();
            break;
        // A Task item. Can be converted to MapiTask.
        case MapiItemType.Task:
            var task = (MapiTask)msg.ToMapiMessageItem();
            break;
    }
}

메시지 검색 및 검색

Aspose.Email은 다음과 같은 오버로드된 메서드를 제공합니다: FolderInfo 메시지를 필터링하고 검색하는 클래스:

IEnumerable EnumerateMessages(MailQuery mailQuery) - MailQuery를 사용하여 메시지 필터링.
IEnumerable EnumerateMessages(MessageKind kind) - 유형(MessageKind)별로 메시지를 검색합니다.
IEnumerable EnumerateMessages(int startIndex, int count) - 시작 인덱스와 개수를 사용하여 메시지 검색을 페이지화합니다.

폴더 내용 페이지별 검색

대용량 PST 폴더를 작업할 때 모든 메시지를 한 번에 가져오는 것은 비효율적일 수 있습니다. 성능과 제어를 개선하기 위해 Aspose.Email for .NET은 the에서 페이지 매김 지원을 제공합니다: FolderInfo.GetContents 메서드. 이 메서드는 지정된 쿼리와 일치하는 메시지의 일부를 주어진 인덱스에서 시작하여 개수만큼 제한하여 가져옵니다. 이를 통해 메시지를 더 작고 관리하기 쉬운 배치로 가져올 수 있습니다. 메서드는 다음 매개변수를 사용합니다:

IList<MessageInfo> FolderInfo.GetContents(MailQuery query, int startIndex, int count)

query — 메시지에 적용할 필터 (옵션)
startIndex — 검색을 시작할 0 기반 인덱스
count — 반환할 메시지 개수

아래 코드 샘플은 이 메서드를 프로젝트에 구현하는 방법을 보여줍니다:

// Load the PST file
using (var pst = PersonalStorage.FromFile(fileName))
{
    // Access a specific subfolder
    var folder = pst.RootFolder.GetSubFolder("Inbox");

    // Build a query to filter messages by sender address
    var queryBuilder = new PersonalStorageQueryBuilder();
    queryBuilder.From.Contains("report-service", true);

    // Define the page size
    int pageSize = 5;

    // Retrieve and process messages in pages
    for (int pageIndex = 0; pageIndex < 6; pageIndex++)
    {
        int startIndex = pageIndex * pageSize;

        // Get a page of messages
        var messages = folder.GetContents(queryBuilder.GetQuery(), startIndex, pageSize);

        foreach (MessageInfo messageInfo in messages)
        {
            // Output basic info about each message
            Console.WriteLine($"Subject: {messageInfo.Subject}, Sender: {messageInfo.SenderRepresentativeName}");
        }
    }
}

PST에서 스트림으로 직접 메시지 저장

PST 파일에서 메시지를 직접 스트림에 저장하려면, 메시지에 대한 MsgInfo를 추출하지 않고 SaveMessageToStream() 메서드를 사용하세요. 다음 코드 조각은 PST에서 스트림으로 직접 메시지를 저장하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// The path to the file directory.
string dataDir = RunExamples.GetDataDir_Outlook();

// Load the Outlook file
string path = dataDir + "PersonalStorage.pst";

// Save message to MemoryStream
using (PersonalStorage personalStorage = PersonalStorage.FromFile(path))
{
    FolderInfo inbox = personalStorage.RootFolder.GetSubFolder("Inbox");
    foreach (MessageInfo messageInfo in inbox.EnumerateMessages())
    {
        using (MemoryStream memeorystream = new MemoryStream())
        {
            personalStorage.SaveMessageToStream(messageInfo.EntryIdString, memeorystream);
        }
    }
}

// Save message to file
using (PersonalStorage pst = PersonalStorage.FromFile(path))
{
    FolderInfo inbox = pst.RootFolder.GetSubFolder("Inbox");
    foreach (MessageInfo messageInfo in inbox.EnumerateMessages())
    {
        using (FileStream fs = File.OpenWrite(messageInfo.Subject + ".msg"))
        {
            pst.SaveMessageToStream(messageInfo.EntryIdString, fs);
        }
    }
}

using (PersonalStorage pst = PersonalStorage.FromFile(path))
{
    FolderInfo inbox = pst.RootFolder.GetSubFolder("Inbox");
    
    // To enumerate entryId of messages you may use FolderInfo.EnumerateMessagesEntryId() method:
    foreach (string entryId in inbox.EnumerateMessagesEntryId())
    {
        using (MemoryStream ms = new MemoryStream())
        {
            pst.SaveMessageToStream(entryId, ms);
        }
    }
}

특정 개수의 메시지 추출

다음 코드 조각은 PST에서 지정된 개수의 메시지를 추출하는 방법을 보여줍니다. 첫 번째 메시지의 인덱스와 추출할 메시지 총 개수를 제공하기만 하면 됩니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
FolderInfo inbox = personalStorage.RootFolder.GetSubFolder("Inbox");

// Extracts messages starting from 10th index top and extract total 100 messages
MessageInfoCollection messages = inbox.GetContents(10, 100);

PST에서 전체 항목 수 가져오기

Aspose.Email은 다음을 제공합니다 GetTotalItemsCount() 메서드 PersonalStorage.Store 속성. PST에 포함된 메시지 항목의 총 수를 반환합니다.

다음 코드 샘플은 PST 파일에 저장된 항목(메시지, 일정, 연락처 등)의 총 개수를 검색하는 방법을 보여줍니다:

using (var pst = PersonalStorage.FromFile("my.pst", false))
{
    var count = pst.Store.GetTotalItemsCount();
}

전체 메시지를 추출하지 않고 첨부 파일 추출

Aspose.Email API를 사용하면 PST 메시지에서 전체 메시지를 먼저 추출하지 않고도 첨부 파일을 추출할 수 있습니다. ExtractAttachments 메서드 PersonalStorage 이를 위해 사용할 수 있습니다. 다음 코드 조각은 전체 메시지를 추출하지 않고 첨부 파일을 추출하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
string dataDir = RunExamples.GetDataDir_Outlook();

using (PersonalStorage personalstorage = PersonalStorage.FromFile(dataDir + "Outlook.pst"))
{
    FolderInfo folder = personalstorage.RootFolder.GetSubFolder("Inbox");

    foreach (var messageInfo in folder.EnumerateMessagesEntryId())
    {
        MapiAttachmentCollection attachments = personalstorage.ExtractAttachments(messageInfo);

        if (attachments.Count != 0)
        {
            foreach (var attachment in attachments)
            {
                if (!string.IsNullOrEmpty(attachment.LongFileName))
                {
                    if (attachment.LongFileName.Contains(".msg"))
                    {
                        continue;
                    }
                    else
                    {
                        attachment.Save(dataDir + @"\Attachments\" + attachment.LongFileName);
                    }
                }
            }
        }
    }
}

PST 파일에서 메시지 수신자 추출

메시지 수신자는 메시지 엔트리 ID를 사용하여 PST 파일에서 추출할 수 있습니다. 이 기능은 the PersonalStorage class. 아래 코드 샘플은 메시지 수신자를 추출하는 방법을 보여줍니다:

EntryD별 (using the ExtractRecipients(string entryId) 메서드 PersonalStorage class)

using (var pst = PersonalStorage.FromFile(fileName))
{  
    // Recipients are extracted using the entry ID
    var recipients = pst.ExtractRecipients("AAAAADzSMygQQFJOkKwVhb8v5EUkASAA");
}

MessageInfo에서 (using the MapiRecipientCollection ExtractRecipients(MessageInfo messageInfo) method)

using (var pst = PersonalStorage.FromFile(fileName))
{  
    // The "Inbox" folder is obtained
    var folder = pst.RootFolder.GetSubfolder("Inbox");

    // Each message in the "Inbox" folder is iterated
    foreach (var messageInfo in folder.EnumerateMessages())
    {
        // Recipients are extracted from each message
        var recipients = pst.ExtractRecipients(messageInfo);
    }
}

메시지 및 폴더 검색

기준별 검색

Personal Storage (PST) 파일에는 방대한 양의 데이터가 포함될 수 있습니다. 이러한 대용량 파일에서 특정 기준에 맞는 데이터를 검색하려면 정보를 필터링하기 위해 코드에 여러 검사 지점을 포함해야 합니다. With the PersonalStorageQueryBuilder 클래스, Aspose.Email를 사용하면 지정된 검색 기준에 따라 PST에서 특정 레코드를 검색할 수 있습니다. PST는 발신자, 수신자, 제목, 메시지 중요도, 첨부 파일 존재 여부, 메시지 크기, 심지어 메시지 ID와 같은 검색 매개변수를 기반으로 메시지를 검색할 수 있습니다. PersonalStorageQueryBuilder 하위 폴더 검색에도 사용할 수 있습니다.

PST에서 메시지 및 폴더 검색

다음 코드 스니펫은 사용 방법을 보여줍니다. PersonalStorageQueryBuilder 다양한 검색 기준에 따라 PST 내용 검색을 수행하는 클래스입니다. 예를 들어, 다음과 같이 PST를 검색하는 방법을 보여줍니다:

메시지 중요도.
메시지 클래스.
첨부 파일 존재 여부.
메시지 크기.
읽지 않은 메시지.
첨부 파일이 있는 읽지 않은 메시지, 그리고
특정 하위 폴더 이름을 가진 폴더.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// The path to the File directory.
string dataDir = RunExamples.GetDataDir_Outlook();

using (PersonalStorage personalStorage = PersonalStorage.FromFile(dataDir + "Outlook.pst"))
{
    FolderInfo folder = personalStorage.RootFolder.GetSubFolder("Inbox");
    PersonalStorageQueryBuilder builder = new PersonalStorageQueryBuilder();

    // High importance messages
    builder.Importance.Equals((int)MapiImportance.High);
    MessageInfoCollection messages = folder.GetContents(builder.GetQuery());
    Console.WriteLine("Messages with High Imp:" + messages.Count);

    builder = new PersonalStorageQueryBuilder();
    builder.MessageClass.Equals("IPM.Note");
    messages = folder.GetContents(builder.GetQuery());
    Console.WriteLine("Messages with IPM.Note:" + messages.Count);

    builder = new PersonalStorageQueryBuilder();
    // Messages with attachments AND high importance
    builder.Importance.Equals((int)MapiImportance.High);
    builder.HasFlags(MapiMessageFlags.MSGFLAG_HASATTACH);
    messages = folder.GetContents(builder.GetQuery());
    Console.WriteLine("Messages with atts: " + messages.Count);

    builder = new PersonalStorageQueryBuilder();
    // Messages with size > 15 KB
    builder.MessageSize.Greater(15000);
    messages = folder.GetContents(builder.GetQuery());
    Console.WriteLine("messags size > 15Kb:" + messages.Count);

    builder = new PersonalStorageQueryBuilder();
    // Unread messages
    builder.HasNoFlags(MapiMessageFlags.MSGFLAG_READ);
    messages = folder.GetContents(builder.GetQuery());
    Console.WriteLine("Unread:" + messages.Count);

    builder = new PersonalStorageQueryBuilder();
    // Unread messages with attachments
    builder.HasNoFlags(MapiMessageFlags.MSGFLAG_READ);
    builder.HasFlags(MapiMessageFlags.MSGFLAG_HASATTACH);
    messages = folder.GetContents(builder.GetQuery());
    Console.WriteLine("Unread msgs with atts: " + messages.Count);

    // Folder with name of 'SubInbox'
    builder = new PersonalStorageQueryBuilder();
    builder.FolderName.Equals("SubInbox");
    FolderInfoCollection folders = folder.GetSubFolders(builder.GetQuery());
    Console.WriteLine("Folder having subfolder: " + folders.Count);

    builder = new PersonalStorageQueryBuilder();
    // Folders with subfolders
    builder.HasSubfolders();
    folders = folder.GetSubFolders(builder.GetQuery());
    Console.WriteLine(folders.Count);
}

대소문자 구분 없는 검색 매개변수

다음 코드 조각은 대소문자를 무시하는 매개변수를 사용하여 PST에서 문자열을 검색하는 방법을 보여줍니다.

using (PersonalStorage personalStorage = PersonalStorage.Create("CaseSensitivity.pst", FileFormatVersion.Unicode))
{
	FolderInfo folderinfo = personalStorage.CreatePredefinedFolder("Inbox", StandardIpmFolder.Inbox);
	folderinfo.AddMessage(MapiMessage.FromMailMessage(MailMessage.Load("Sample.eml")));
	PersonalStorageQueryBuilder builder = new PersonalStorageQueryBuilder();
	// IgnoreCase is True
	builder.From.Contains("automated", true);
	MailQuery query = builder.GetQuery();
	MessageInfoCollection coll = folderinfo.GetContents(query);
	Console.WriteLine(coll.Count);
}

여러 키워드로 메시지 제목 검색

다음과 같이 사용할 수 있습니다 MailQueryBuilder.Or 아래와 같이 지정된 단어 중 하나 이상을 포함하는 제목을 가진 메시지를 찾는 메서드:

var builder1 = new PersonalStorageQueryBuilder();
builder1.Subject.Contains("Review"); // 'Review' is key word for the search

var builder2 = new PersonalStorageQueryBuilder();
builder2.Subject.Contains("Error"); // 'Error' is also key word for the search

var queryBuilder = new PersonalStorageQueryBuilder();
queryBuilder.Or(builder1.GetQuery(), builder2.GetQuery()); // message subjects must contain 'Review' or 'Error' words

using (var storage = PersonalStorage.FromFile("example.pst"))
{
    var folderInfo = storage.RootFolder.GetSubFolder("Inbox");
    var messageInfos = folderInfo.GetContents(queryBuilder.GetQuery());

    foreach (var messageInfo in messageInfos)
    {
        Console.WriteLine(messageInfo.Subject);
    }
}

메시지 조작

항목을 다른 폴더로 이동

Aspose.Email를 사용하면 동일한 개인 저장소(PST) 파일 내에서 소스 폴더의 항목을 다른 폴더로 이동할 수 있습니다. 여기에는 다음이 포함됩니다:

지정된 폴더를 새 상위 폴더로 이동하기.
지정된 메시지를 새 폴더로 이동합니다.
내용을 새 폴더로 이동하기.
하위 폴더를 새 상위 폴더로 이동하기.

다음 코드 조각은 동일한 PST 파일 내에서 소스 폴더의 메시지 및 폴더와 같은 항목을 다른 폴더로 이동하는 방법을 보여줍니다.

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

using(PersonalStorage personalStorage = PersonalStorage.FromFile("test.pst"))
{
    FolderInfo inbox = personalStorage.GetPredefinedFolder(StandardIpmFolder.Inbox);
    FolderInfo deleted = personalStorage.GetPredefinedFolder(StandardIpmFolder.DeletedItems);
    FolderInfo subfolder = inbox.GetSubFolder("Subfolder");

    // Move folder and message to the Deleted Items
    personalStorage.MoveItem(subfolder, deleted);
    MessageInfoCollection contents = subfolder.GetContents();
    personalStorage.MoveItem(contents[0], deleted);

    // Move all inbox subfolders and subfolder contents to the Deleted Items
    inbox.MoveSubfolders(deleted);
    subfolder.MoveContents(deleted);
}

메시지 속성 업데이트

때때로 메시지의 제목 변경, 중요도 표시 등과 같이 특정 속성을 업데이트해야 할 경우가 있습니다. 이러한 속성 변경을 포함한 PST 파일의 메시지를 업데이트하려면 FolderInfo.ChangeMessages 이 메서드. 이 문서는 PST 파일에서 메시지 속성을 일괄 변경하는 방법을 보여줍니다. 다음 코드 스니펫은 PST 파일의 여러 메시지에 대해 일괄 모드로 속성을 업데이트하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// The path to the File directory.
string dataDir = RunExamples.GetDataDir_Outlook() + "Sub.pst";

// Load the Outlook PST file
PersonalStorage personalStorage = PersonalStorage.FromFile(dataDir);
            
// Get Requierd Subfolder 
FolderInfo inbox = personalStorage.RootFolder.GetSubFolder("Inbox");

// find messages having From = "someuser@domain.com"
PersonalStorageQueryBuilder queryBuilder = new PersonalStorageQueryBuilder();
queryBuilder.From.Contains("someuser@domain.com");

// Get Contents from Query
MessageInfoCollection messages = inbox.GetContents(queryBuilder.GetQuery());

// Save (MessageInfo,EntryIdString) in List
IList<string> changeList = new List<string>();
foreach (MessageInfo messageInfo in messages)
{
    changeList.Add(messageInfo.EntryIdString);
}

// Compose the new properties
MapiPropertyCollection updatedProperties = new MapiPropertyCollection();
updatedProperties.Add(MapiPropertyTag.PR_SUBJECT_W, new MapiProperty(MapiPropertyTag.PR_SUBJECT_W, Encoding.Unicode.GetBytes("New Subject")));
updatedProperties.Add(MapiPropertyTag.PR_IMPORTANCE, new MapiProperty(MapiPropertyTag.PR_IMPORTANCE, BitConverter.GetBytes((long)2)));

// update messages having From = "someuser@domain.com" with new properties
inbox.ChangeMessages(changeList, updatedProperties);

사용자 정의 속성 업데이트

때때로 PST 파일 내에서 처리된 항목을 표시해야 할 때가 있습니다. Aspose.Email API는 MapiProperty와 MapiNamedProperty를 사용하여 이를 달성할 수 있도록 합니다. 다음 메서드가 도움이 됩니다.

ctor MapiNamedProperty(long propertyTag, string nameIdentifier, Guid propertyGuid, byte[] propertyValue)
ctor MapiNamedProperty(long propertyTag, long nameIdentifier, Guid propertyGuid, byte[] propertyValue)
FolderInfo.ChangeMessages(MapiPropertyCollection updatedProperties) - 폴더 내 모든 메시지를 변경합니다.
PersonalStorage.ChangeMessage(string entryId, MapiPropertyCollection updatedProperties) - 메시지 속성을 변경합니다.

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

public static void Run()
{
	// Load the Outlook file
	string dataDir = RunExamples.GetDataDir_Outlook() + "Sub.pst";
	using (PersonalStorage personalStorage = PersonalStorage.FromFile(dataDir))
	{
		FolderInfo testFolder = personalStorage.RootFolder.GetSubFolder("Inbox");

		// Create the collection of message properties for adding or updating
		MapiPropertyCollection newProperties = new MapiPropertyCollection();

		// Normal,  Custom and PidLidLogFlags named  property
		MapiProperty property = new MapiProperty(MapiPropertyTag.PR_ORG_EMAIL_ADDR_W,Encoding.Unicode.GetBytes("test_address@org.com"));
		MapiProperty namedProperty1 = new MapiNamedProperty(GenerateNamedPropertyTag(0, MapiPropertyType.PT_LONG),"ITEM_ID",Guid.NewGuid(),BitConverter.GetBytes(123));
		MapiProperty namedProperty2 = new MapiNamedProperty(GenerateNamedPropertyTag(1, MapiPropertyType.PT_LONG),0x0000870C,new Guid("0006200A-0000-0000-C000-000000000046"),BitConverter.GetBytes(0));
		newProperties.Add(namedProperty1.Tag, namedProperty1);
		newProperties.Add(namedProperty2.Tag, namedProperty2);
		newProperties.Add(property.Tag, property);
		testFolder.ChangeMessages(testFolder.EnumerateMessagesEntryId(), newProperties);
	}
}

private static long GenerateNamedPropertyTag(long index, MapiPropertyType dataType)
{
	return (((0x8000 | index) << 16) | (long)dataType) & 0x00000000FFFFFFFF;
}

메시지 삭제

이 문서는 다음을 사용하는 방법을 보여줍니다. FolderInfo PST 파일의 특정 폴더에 접근하는 클래스입니다. 이전에 로드하거나 만든 PST 파일의 Sent 하위 폴더에서 메시지를 삭제하려면:

다음의 인스턴스를 생성합니다. FolderInfo 클래스와 Sent 하위 폴더의 내용을 로드합니다.
Sent 폴더의 메시지를 삭제하려면 호출합니다: FolderInfo.DeleteChildItem() 메서드와 전달하는 MessageInfo.EntryId 매개변수로 사용됩니다. 다음 코드 조각은 PST 파일의 Sent 하위 폴더에서 메시지를 삭제하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// The path to the File directory.
string dataDir = RunExamples.GetDataDir_Outlook() + "Sub.pst";

// Load the Outlook PST file
PersonalStorage personalStorage = PersonalStorage.FromFile(dataDir);

// Get the Sent items folder
FolderInfo folderInfo = personalStorage.GetPredefinedFolder(StandardIpmFolder.SentItems);

MessageInfoCollection msgInfoColl = folderInfo.GetContents();
foreach (MessageInfo msgInfo in msgInfoColl)
{
    Console.WriteLine(msgInfo.Subject + ": " + msgInfo.EntryIdString);
    if (msgInfo.Subject.Equals("some delete condition") == true)
    {
        // Delete this item
        folderInfo.DeleteChildItem(msgInfo.EntryId);
        Console.WriteLine("Deleted this message");
    }
}

폴더 삭제

PST 폴더를 삭제된 항목 폴더로 이동하여 삭제할 수 있습니다.

using (PersonalStorage pst = PersonalStorage.FromFile(@"test.pst"))
{
    FolderInfo deletedItemsFolder = pst.GetPredefinedFolder(StandardIpmFolder.DeletedItems);
    FolderInfo emptyFolder = pst.RootFolder.GetSubFolder("Empty folder");
	  FolderInfo someFolder = pst.RootFolder.GetSubFolder("Some folder");
    pst.MoveItem(emptyFolder, deletedItemsFolder);
	  pst.MoveItem(someFolder, deletedItemsFolder);
}

이 방법의 장점은 삭제된 폴더를 쉽게 복구할 수 있다는 점입니다.

FolderInfo someFolder = deletedItemsFolder.GetSubFolder("Some folder");
pst.MoveItem(someFolder, pst.RootFolder);

필요한 경우 삭제된 항목 폴더에서 폴더를 영구적으로 제거할 수도 있습니다.

deletedItemsFolder.DeleteChildItem(emptyFolder.EntryId);

다음은 DeleteChildItem() 이 메서드는 삭제된 항목 폴더를 거치지 않고 즉시 영구적으로 하위 폴더를 삭제하려는 경우 모든 폴더에 사용할 수 있습니다.

FolderInfo someFolder = pst.RootFolder.GetSubFolder("Some folder");
pst.RootFolder.DeleteChildItem(someFolder.EntryId);

PST에서 항목 삭제

고유 entryId를 사용하여 Personal Storage Table(PST)에서 항목(폴더 또는 메시지)을 삭제하려면 DeleteItem(string entryId) 메서드를 호출합니다. PersonalStorage 클래스.

다음 코드 스니펫을 사용하여 DeleteItem 메서드를 호출하고 entryId를 매개변수로 전달할 수 있습니다:

var pst = PersonalStorage.FromFile("sample.pst");

// ...

pst.DeleteItem(entryId);

// ...

참고:

이 메서드는 PST에서 항목을 영구적으로 삭제하며 실행 취소할 수 없습니다. 실수로 데이터가 손실되지 않도록 사용할 때 주의하십시오.
표준 관행에 따라 entryId가 유효하고 PST 내에 존재하는 항목과 일치하는지 확인하십시오.
그렇지 않으면 예외가 발생합니다. 필요 시 삭제된 항목을 복구할 수 있도록 PST의 백업을 유지하거나 적절한 복구 조치를 구현하는 것이 좋습니다.

대량 삭제

Aspose.Email API를 사용하여 PST 파일에서 항목을 일괄 삭제할 수 있습니다. 이는 다음을 사용하여 구현됩니다: DeleteChildItems() 삭제할 항목을 가리키는 Entry ID 목록을 받는 메서드입니다. 다음 코드 조각은 PST 파일에서 항목을 일괄 삭제하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// The path to the File directory.
string dataDir = RunExamples.GetDataDir_Outlook() + @"Sub.pst";
using (PersonalStorage personalStorage = PersonalStorage.FromFile(dataDir))
{
    // Get Inbox SubFolder from Outlook file
    FolderInfo inbox = personalStorage.RootFolder.GetSubFolder("Inbox");

    // Create instance of PersonalStorageQueryBuilder
    PersonalStorageQueryBuilder queryBuilder = new PersonalStorageQueryBuilder();

    queryBuilder.From.Contains("someuser@domain.com");
    MessageInfoCollection messages = inbox.GetContents(queryBuilder.GetQuery());
    IList<string> deleteList = new List<string>();
    foreach (MessageInfo messageInfo in messages)
    {
        deleteList.Add(messageInfo.EntryIdString);
    }

    // delete messages having From = "someuser@domain.com"
    inbox.DeleteChildItems(deleteList);
}

PST 및 OST 파일에서 소프트 삭제된 항목 복구

Aspose.Email for .NET은 PST 및 OST 파일에서 소프트 삭제된 항목을 복구하는 메서드를 제공합니다. 이 기능은 다음을 통해 구현됩니다: PersonalStorage 클래스로, 다음을 포함합니다: FindAndExtractSoftDeletedItems 메서드입니다. 이 메서드를 사용하면 소프트 삭제된 항목을 찾고 복원하여 손실될 수 있는 중요한 데이터를 복구할 수 있습니다. 복구된 항목은 각각의 폴더에 다음과 같이 저장됩니다. .msg 파일을 처리하면서 원본 폴더 구조가 유지되도록 합니다. 아래 코드 샘플은 이 기능을 프로젝트에 구현하는 방법을 보여줍니다:

using (var pst = PersonalStorage.FromFile(fileName))
{
    // Soft deleted items are found and extracted
    var entries = pst.FindAndExtractSoftDeletedItems();

    // The recovered items are iterated through
    for (var index = 0; index < entries.Count; index++)
    {
        // Folder information is obtained by ID
        var folderInfo = pst.GetFolderById(entries[index].FolderId);

        // A directory for the folder is created if it doesn't exist
        if (!Directory.Exists(folderInfo.DisplayName))
        {
            Directory.CreateDirectory(Path.Combine(path, folderInfo.DisplayName));
        }
        
        // The restored item is obtained
        var msg = entries[index].Item;
        
        // The restored item is saved as a .msg file
        msg.Save(Path.Combine(path, folderInfo.DisplayName, $"{index}.msg"));
    }
}

PST 파일에서 소프트 삭제된 메시지 열거

PST 파일에서 소프트 삭제된 메시지는 두 번 삭제된 항목으로, 처음에는 삭제된 항목 폴더로 이동하고 다시 제거된 것입니다. 이러한 메시지는 영구적으로 삭제되지 않으며 프로그래밍 방식으로 여전히 접근할 수 있습니다. Aspose.Email for .NET은 이러한 소프트 삭제된 메시지를 검토하거나 복구하기 위한 검색을 지원합니다.

PST 파일에서 소프트 삭제된(두 번 삭제된) 항목을 열거하고 복구하려면 다음을 사용하십시오: FindAndEnumerateSoftDeletedItems() 메서드입니다. 이 메서드는 해당 항목들의 열거 가능한 목록을 반환하며, 각 항목은 메시지와 삭제된 폴더의 ID를 포함합니다.

다음 코드 샘플은 두 번 삭제된 이메일을 열거하고 복구하는 방법을 보여줍니다. 이는 RestoredItemEntry PST 파일에서 복구된 소프트 삭제 항목을 나타내는 클래스로, 다음 속성을 포함합니다:

Item (MapiMessage): 복구된 메시지 개체입니다.
FolderId (string): 메시지가 원래 삭제된 폴더의 식별자입니다.

// Load the PST file
using (var pst = PersonalStorage.FromFile("archive.pst"))
{
    // Enumerate soft-deleted items
    foreach (var entry in pst.FindAndEnumerateSoftDeletedItems())
    {
        var message = entry.Item;
        var folderId = entry.FolderId;

        Console.WriteLine($"Subject: {message.Subject}");
        Console.WriteLine($"Deleted from Folder ID: {folderId}");
        Console.WriteLine("-----------------------------------");
    }
}

PST 파일 분할

여러 PST로 분할

Aspose.Email API는 단일 PST 파일을 원하는 파일 크기의 여러 PST 파일로 분할하는 기능을 제공합니다.

아래 코드 샘플은 파일 분할 프로세스를 설명합니다:

먼저, 다음을 사용합니다. FromFile 메서드 PersonalStorage 파일 이름을 지정하는 클래스.
그런 다음, 다음을 호출합니다. StorageProcessedEventHandler StorageProcessed 이벤트를 처리하는 대리자입니다.
StorageProcessingEventArgs는 PersonalStorage.StorageProcessing 이벤트에 대한 데이터를 제공합니다. 그 StorageProcessingEventArgs.FileName 속성을 사용하면 PST 파일의 이름을 검색할 수 있습니다. 용도는 MergeWith 메서드는 현재 PST의 이름이 되며, 메인 PST와 병합할 때 사용됩니다. SplitInto 메서드는 현재 파트의 이름이 됩니다.
마지막으로, SplitInto(long chunkSize, string partFileNamePrefix, string path) 오버로드 메서드는 PST 저장소를 작은 파트로 분할하도록 시작합니다. 다음 매개변수를 사용합니다:

chunkSize: 각 청크의 대략적인 바이트 크기입니다.
partFileNamePrefix: PST 각 파트 파일 이름에 추가될 접두사입니다. 제공된 경우, 접두사는 각 파일 이름의 앞에 추가됩니다. 제공되지 않은 경우(null 또는 빈 문자열), 접두사 없이 PST 파트가 생성됩니다.
path: 청크가 생성될 폴더 경로입니다.

각 파트의 파일 이름은 템플릿을 따릅니다: {prefix}part{number}.pst, 여기서 {prefix}는 파일 이름 접두사(제공된 경우)를 나타내고, {number}는 청크 파일의 번호를 나타냅니다.

var pst = PersonalStorage.FromFile("sample.pst");

// ...

pst.StorageProcessing += (sender, args) =>
{
    Console.WriteLine("Storage processing event raised for file: " + args.FileName);
};

// ...

pst.SplitInto(5000000, "prefix_", outputFolderPath);

지정된 기준에 따라 PST 분할

다음 코드는 지정된 기준에 따라 PST를 분할하는 방법을 보여줍니다.

PST 파일 병합

단일 PST로 병합

여러 PST 파일을 단일 PST 파일로 병합할 수도 있습니다. PST 분할 및 병합 작업 모두에 이벤트를 추가하여 추적할 수 있습니다.

다음 코드 조각은 단일 PST 파일로 병합하는 방법을 보여줍니다:

사용해 보세요!

무료로 여러 이메일 파일을 온라인에서 하나로 병합 및 결합합니다 Aspose.Email Merger App.

다른 PST에서 폴더 병합

다음 코드 조각은 다른 PST에서 폴더를 병합하는 방법을 보여줍니다:

Net: PST 파일에서 연락처 관리

Mon, 01 Jan 0001 00:00:00 +0000

연락처 추가 및 저장

PST에 연락처 추가

섹션 PST 파일 생성 및 관리 PST 파일을 생성하고 하위 폴더를 추가하는 방법을 보여줍니다. Aspose.Email을 사용하면 생성하거나 로드한 PST 파일의 Contacts 하위 폴더에 MapiContact를 추가할 수 있습니다. 아래는 PST에 MapiContact를 추가하는 단계입니다:

다음을 생성합니다 MapiContact 객체.
설정합니다. MapiContact 속성 다양한 생성자와 메서드를 사용하여.
다음을 사용하여 PST를 생성합니다 PersonalStorage.Create() 메서드.
루트 폴더에 접근한 뒤 호출하여 PST 파일 루트에 미리 정의된 폴더(Contacts)를 생성합니다. AddMapiMessageItem() 메서드.

다음 코드 스니펫은 MapiContact를 생성한 다음 새로 만든 PST 파일의 연락처 폴더에 추가하는 방법을 보여줍니다.

// Create three Contacts 
var contact1 = new MapiContact("Sebastian Wright", "SebastianWright@dayrep.com");
var contact2 = new MapiContact("Wichert Kroos", "WichertKroos@teleworm.us", "Grade A Investment");
var contact3 = new MapiContact("Christoffer van de Meeberg", "ChristoffervandeMeeberg@teleworm.us", "Krauses Sofa Factory", "046-630-4614046-630-4614");

// Contact #4
var contact4 = new MapiContact{NameInfo = new MapiContactNamePropertySet("Margaret", "J.", "Tolle")};
contact4.PersonalInfo.Gender = MapiContactGender.Female;
contact4.ProfessionalInfo = new MapiContactProfessionalPropertySet("Adaptaz", "Recording engineer");
contact4.PhysicalAddresses.WorkAddress.Address = "4 Darwinia Loop EIGHTY MILE BEACH WA 6725";
contact4.ElectronicAddresses.Email1 = new MapiContactElectronicAddress("Hisen1988", "SMTP", "MargaretJTolle@dayrep.com");
contact4.Telephones.BusinessTelephoneNumber = "(08)9080-1183";
contact4.Telephones.MobileTelephoneNumber = "(925)599-3355(925)599-3355";

// Contact #5
var contact5 = new MapiContact{NameInfo = new MapiContactNamePropertySet("Matthew", "R.", "Wilcox")};
contact5.PersonalInfo.Gender = MapiContactGender.Male;
contact5.ProfessionalInfo = new MapiContactProfessionalPropertySet("Briazz", "Psychiatric aide");
contact5.PhysicalAddresses.WorkAddress.Address = "Horner Strasse 12 4421 SAASS";
contact5.Telephones.BusinessTelephoneNumber = "0650 675 73 300650 675 73 30";
contact5.Telephones.HomeTelephoneNumber = "(661)387-5382(661)387-5382";

// Contact #6
var contact6 = new MapiContact
{
    NameInfo = new MapiContactNamePropertySet("Bertha", "A.", "Buell"),
    ProfessionalInfo = new MapiContactProfessionalPropertySet("Awthentikz", "Social work assistant")
};
contact6.PersonalInfo.PersonalHomePage = "B2BTies.com";
contact6.PhysicalAddresses.WorkAddress.Address = "Im Astenfeld 59 8580 EDELSCHROTT";
contact6.ElectronicAddresses.Email1 = new MapiContactElectronicAddress("Experwas", "SMTP", "BerthaABuell@armyspy.com");
contact6.Telephones = new MapiContactTelephonePropertySet("06605045265");

using (PersonalStorage personalStorage = PersonalStorage.Create("SampleContacts_out.pst", FileFormatVersion.Unicode))
{
    var contactFolder = personalStorage.CreatePredefinedFolder("Contacts", StandardIpmFolder.Contacts);
    contactFolder.AddMapiMessageItem(contact1);
    contactFolder.AddMapiMessageItem(contact2);
    contactFolder.AddMapiMessageItem(contact3);
    contactFolder.AddMapiMessageItem(contact4);
    contactFolder.AddMapiMessageItem(contact5);
    contactFolder.AddMapiMessageItem(contact6);
}

연락처를 MSG 형식으로 저장

이 기사에서는 Outlook PST 파일에서 연락처 정보를 액세스하고 MSG 형식으로 디스크에 저장하는 방법을 설명합니다. 연락처 정보를 얻는 단계는 다음과 같습니다:

PST 파일을 로드합니다 PersonalStorage 객체.
Contacts 폴더를 탐색합니다.
메시지를 반복하여 Contacts 폴더의 내용을 가져옵니다.
다음이 맞는지 확인하십시오: MessageInfo.MessageClass 속성 값이 "IPM.Contact"와 일치합니다.
다음을 호출합니다. PersonalStorage.ExtractMessage() 메서드로 가져옵니다 MapiMessage 객체.
MapiMessage.Save() 메서드를 호출하여 연락처를 MSG 형식으로 디스크에 저장합니다.

다음 코드 스니펫은 PST 파일에서 모든 연락처 정보를 가져와 MSG 형식으로 디스크에 저장하는 방법을 보여줍니다.

// Load the Outlook PST file
var pst = PersonalStorage.FromFile("SampleContacts.pst");

// Get the Contacts folder
var contactsFolder = pst.RootFolder.GetSubFolder("Contacts");

// Loop through all the contacts in this folder
foreach (MessageInfo messageInfo in contactsFolder.EnumerateMessages())
{
    if (messageInfo.MessageClass == "IPM.Contact")
    {
        // Get the contact information
        var msg = pst.ExtractMessage(messageInfo);
        
        // Save to disk in msg format
        string contactName = msg.Subject.Replace(":", " ").Replace("\\", " ").Replace("?", " ").Replace("/", " ");
        msg.Save($"{contactName}.msg", SaveOptions.DefaultMsgUnicode);
    }
}

연락처를 VCF 형식으로 저장

이 기사에서는 Microsoft Outlook PST 파일에서 연락처 정보를 액세스하고 vCard(VCF) 형식으로 디스크에 저장하는 방법을 보여줍니다. 다음을 사용하십시오: PersonalStorage 및 MapiContact PST 파일에서 연락처 정보를 가져오는 클래스. 연락처 정보를 가져오려면:

PST 파일을 로드합니다 PersonalStorage 클래스.
Contacts 폴더를 탐색합니다.
메시지를 반복하여 Contacts 폴더의 내용을 가져옵니다.
다음이 맞는지 확인하십시오: MessageInfo.MessageClass 속성 값이 "IPM.Contact"와 일치합니다.
다음을 호출합니다. PersonalStorage.ExtractMessage() 메서드로 가져옵니다 MapiMessage 객체.
다음을 호출합니다. MapiMessage.ToMapiMessageItem() 및 캐스트 IMapiMessageItem to MapiContact 유형.
다음을 호출합니다. MapiContact.Save() 연락처를 VCard 형식으로 디스크에 저장하는 메서드.

아래 프로그램은 디스크에서 PST 파일을 로드하고 모든 연락처를 vCard (VCF) 형식으로 저장합니다. VCF 파일은 표준 vCard 연락처 파일을 로드할 수 있는 다른 프로그램에서도 사용할 수 있습니다. Microsoft Outlook에서 VCF 파일을 열면 아래 스크린샷과 같은 형태로 표시됩니다.

다음 코드 스니펫은 Outlook PST에서 연락처를 vCard(VCF) 형식으로 내보내는 방법을 보여줍니다.

// Load the Outlook PST file
var pst = PersonalStorage.FromFile("SampleContacts.pst");

// Get the Contacts folder
var contactsFolder = pst.RootFolder.GetSubFolder("Contacts");

// Loop through all the contacts in this folder
foreach (MessageInfo messageInfo in contactsFolder.EnumerateMessages())
{
    if (messageInfo.MessageClass == "IPM.Contact")
    {
        // Get the contact information
        var msg = pst.ExtractMessage(messageInfo);
        var contact = (MapiContact)msg.ToMapiMessageItem();

        // Display some contents on screen
        Console.WriteLine("Name: " + contact.NameInfo.DisplayName);

        // Save to disk in VCard format
        string contactName = contact.Subject.Replace(":", " ").Replace("\\", " ").Replace("?", " ").Replace("/", " ");
        contact.Save($"{contactName}.vcf", ContactSaveFormat.VCard);
    }
}

참고: PST 파일에서 배포 목록 관리

Net: PST 파일에서 배포 목록 관리

Mon, 01 Jan 0001 00:00:00 +0000

배포 목록 생성 및 관리

배포 목록 생성 및 저장

Aspose.Email API를 사용하여 여러 연락처를 모은 배포 목록을 생성할 수 있습니다. 배포 목록은 Outlook MSG 형식으로 디스크에 저장될 수 있으며, MS Outlook에서 열어 보거나 조작할 수 있습니다. 다음 코드 조각은 배포 목록을 생성하고 저장하는 방법을 보여줍니다.

배포 목록 읽기

다음 코드 스니펫은 PST에서 배포 목록을 읽는 방법을 보여줍니다.

using Aspose.Email.Storage.Pst;
using Aspose.Email.Mapi;

// Load the PST file
using (var pst = PersonalStorage.FromFile("your.pst"))
{
    // Get the Contacts folder
    var folder = pst.GetPredefinedFolder(StandardIpmFolder.Contacts);

    if (folder != null)
    {
        foreach (var msgInfo in folder.EnumerateMessages())
        {
            // Check if the message has the "IPM.DistList" message class
            if (msgInfo.MessageClass == "IPM.DistList")
            {
                // Extract the distribution list
                var distList = (MapiDistributionList)pst.ExtractMessage(msgInfo).ToMapiMessageItem();
                
                // Now, you can work with the distribution list
                // (e.g., access its members, display its properties, or make modifications)
            }
        }
    }
}

배포 목록 업데이트

다음 코드 조각은 PST에서 배포 목록을 업데이트하는 방법을 보여줍니다.

using Aspose.Email.Mapi;
using Aspose.Email.Storage.Pst;

// Load PST file
using (PersonalStorage pst = PersonalStorage.FromFile("my.pst"))
{
    // Get Contacts folder
    var folder = pst.GetPredefinedFolder(StandardIpmFolder.Contacts);

    // Add a new member to each distribution list in PST
    foreach (var msg in folder.EnumerateMessages())
    {
        // Check if the message has the "IPM.DistList" message class
        if (msg.MessageClass == "IPM.DistList")
        {
            var distList = pst.ExtractMessage(msg).ToMapiMessageItem();

            // Create a new member to add
            var member = new MapiDistributionListMember("Edward R. Manuel", "EdwardRManuel@example.com");
            distList.Members.Add(member);

            // Update Distribution List in PST
            folder.UpdateMessage(msg.EntryIdString, distList);
        }
    }
}

Net: PST 파일에서 캘린더 항목 관리

Mon, 01 Jan 0001 00:00:00 +0000

PST에 MAPI 캘린더 추가

PST 파일 생성 및 관리 PST 파일을 생성하고 하위 폴더를 추가하는 방법을 보여줍니다. Aspose.Email을 사용하면 생성하거나 로드한 PST 파일의 Calendar 하위 폴더에 MapiCalendar를 추가할 수 있습니다. 아래는 PST에 MapiCalendar를 추가하는 단계입니다:

다음을 생성합니다 MapiCalendar 객체.
설정합니다. MapiCalendar 생성자와 메서드를 사용하여 속성을 설정합니다.
다음을 사용하여 PST를 생성합니다 PersonalStorage.Create() 메서드.
루트 폴더에 접근한 뒤 호출하여 PST 파일 루트에 미리 정의된 폴더(Calendar)를 생성합니다. AddMapiMessageItem() 메서드.

다음 코드 조각은 다음을 생성하는 방법을 보여줍니다: MapiCalendar 그런 다음 새로 만든 PST 파일의 캘린더 폴더에 추가합니다.

캘린더 항목을 ICS 형식으로 디스크에 저장

이 기사에서는 Outlook PST 파일에서 캘린더 항목을 액세스하고 캘린더를 ICS 형식으로 디스크에 저장하는 방법을 보여줍니다. 다음을 사용하십시오: PersonalStorage 및 MapiCalendar 캘린더 정보를 가져오는 클래스. 아래는 캘린더 항목을 저장하는 단계입니다:

PST 파일을 로드합니다 PersonalStorage 클래스.
캘린더 폴더 탐색.
캘린더 폴더의 내용을 가져와 메시지 컬렉션을 얻습니다.
메시지 컬렉션을 반복합니다.
호출하십시오 PersonalStorage.ExtractMessage() 연락처 정보를 얻는 메서드 MapiCalendar 클래스.
다음을 호출합니다. MapiCalendar.Save() 캘린더 항목을 디스크에 ICS 형식으로 저장하는 메서드.

아래 프로그램은 디스크에서 PST 파일을 로드하고 모든 캘린더 항목을 ICS 형식으로 저장합니다. ICS 파일은 표준 ICS 캘린더 파일을 로드할 수 있는 다른 프로그램에서도 사용할 수 있습니다. Microsoft Outlook에서 열면 아래 스크린샷과 같은 형태로 표시됩니다.

다음 코드 스니펫은 Outlook PST에서 캘린더 항목을 ICS 형식으로 내보내는 방법을 보여줍니다.

원본 타임스탬프와 함께 저장

다음 기능을 사용하면 캘린더 항목을 원본 날짜 및 시간 정보를 유지한 채 ICS로 저장할 수 있습니다:

MapiCalendarIcsSaveOptions - MapiCalendar를 Ics 형식으로 저장할 때 추가 옵션을 지정하도록 허용합니다.
MapiCalendarIcsSaveOptions.KeepOriginalDateTimeStamp - 출력 파일에서 원본 DateTimeStamp 값을 유지하도록 허용합니다.

아래 코드 샘플을 사용하여 프로젝트에 기능을 구현하십시오:

var cal = pst.ExtractMessage(msgInfo).ToMapiMessageItem() as MapiCalendar;

if (cal != null)
{
  cal.Save("cal.ics", new MapiCalendarIcsSaveOptions() { KeepOriginalDateTimeStamp = true});
}

반복 항목에서 발생 인스턴스 수정/삭제

Aspose.Email for .NET API를 사용하여 기존 반복에 예외를 추가할 수 있습니다. 다음 코드 샘플은 이 기능의 사용 방법을 보여줍니다.

Net: PST 파일에서 작업, 저널 및 메모 관리

Mon, 01 Jan 0001 00:00:00 +0000

PST에 MAPI 작업 추가

다음은 PST 파일 생성 및 관리 이 문서는 PST 파일을 생성하고 하위 폴더를 추가하는 방법을 보여줍니다. Aspose.Email을 사용하면 추가할 수 있습니다 MapiTask 생성하거나 로드한 PST 파일의 Tasks 하위 폴더에 추가합니다. 아래는 PST에 MapiTask를 추가하는 단계입니다.

다음을 생성합니다 MapiTask 객체.
설정합니다. MapiTask 생성자와 다양한 메서드를 사용해 속성을 설정합니다.
다음을 사용하여 PST를 생성합니다 PersonalStorage.Create() 메서드.
루트 폴더에 접근한 뒤 호출하여 PST 파일 루트에 미리 정의된 폴더(Tasks)를 생성합니다. AddMapiMessageItem() 메서드.

다음 코드 조각은 다음을 생성하는 방법을 보여줍니다: MapiTask 그런 다음 새로 만든 PST 파일의 작업 폴더에 추가합니다.

PST에 MAPI 저널 추가

Aspose.Email은 또한 추가할 수 있습니다 MapiJournal 생성하거나 로드한 PST 파일의 Journal 하위 폴더에 추가합니다. 아래는 추가하는 단계입니다 MapiJournal PST에:

다음을 생성합니다 MapiJournal 객체
설정합니다. MapiJournal 생성자와 메서드를 사용하여 속성을 설정합니다.
다음을 사용하여 PST를 생성합니다 PersonalStorage.Create() 메서드.
루트 폴더에 접근한 뒤 사전 정의된 폴더(Journals)를 PST 파일의 루트에 생성하고 그 다음에 호출합니다. AddMapiMessageItem() 메서드.

다음 코드 조각은 다음을 생성하는 방법을 보여줍니다: MapiJournal 그런 다음 새로 만든 PST 파일의 저널 폴더에 추가합니다.

MAPI 저널에 첨부 파일 추가

다음 코드 조각은 첨부 파일을 추가하는 방법을 보여줍니다: MapiJournal.

PST에 MAPI 메모 추가

Aspose.Email을 사용하면 추가할 수 있습니다: MapiNote 생성하거나 로드한 PST 파일의 Notes 하위 폴더에 추가합니다. 추가하려면 MapiNote PST에:

템플릿 만들기 MapiNote Microsoft Outlook을 사용하여 MSG 파일로 저장합니다.
저장된 MSG 메모를 로드합니다: MapiMessage 객체.
다음을 생성합니다 MapiNote 객체를 사용해 템플릿 MSG 메모를 로드합니다.
설정합니다. MapiNote 속성.
다음을 사용하여 PST를 생성합니다 PersonalStorage.Create() 메서드.
루트 폴더에 접근한 후 호출하여 PST 파일 루트에 미리 정의된 폴더(Notes)를 생성합니다. AddMapiMessageItem() 메서드.

다음 코드 조각은 다음을 생성하는 방법을 보여줍니다: MapiNote 그런 다음 새로 만든 PST 파일의 메모 폴더에 추가합니다.

Net: PST 비밀번호 보호 작업

Mon, 01 Jan 0001 00:00:00 +0000

PST 비밀번호 보호 작업

Microsoft Outlook은 사용자가 PST 파일을 비밀번호로 보호하여 접근을 제한할 수 있게 합니다. Aspose.Email은 PST 파일의 비밀번호 보호를 감지할 수 있습니다. 비밀번호 보호는 실제로 Outlook에서만 구현되며, 데이터는 전혀 암호화되지 않습니다. 따라서 API를 사용해 비밀번호를 모른 상태에서도 이메일을 추출할 수 있습니다.

사용해 보세요!

다음 명령을 실행하십시오 PstPasswordManager 간단한 앱 프로젝트를 만들고 PST 비밀번호 관리를 위한 Aspose.Email의 기능을 경험해 보세요.

비밀번호 보호 PST 파일 읽기

비밀번호가 보호된 파일도 일반 비보호 PST 파일처럼 읽을 수 있습니다.

using var pst = PersonalStorage.FromFile(fileName);
foreach (var folder in pst.RootFolder.GetSubFolders())
{
    foreach (var msg in folder.EnumerateMessages())
    {

    }
}

PST가 비밀번호 보호되는지 확인

API는 다음을 제공합니다: PersonalStorage.Store.IsPasswordProtected 속성. PersonalStorage.Store.IsPasswordProtected 속성은 PST 파일이 비밀번호로 보호되면 true, 그렇지 않으면 false를 반환합니다.

다음 코드 스니펫은 사용법을 보여줍니다 PersonalStorage.Store.IsPasswordProtected 속성.

using var pst = PersonalStorage.FromFile("passwordprotectedPST.pst");
Console.WriteLine($"The storage is password protected - {pst.Store.IsPasswordProtected}");

비밀번호 검증

다음은 PersonalStorage.Store.IsPasswordValid() 메서드는 문자열 비밀번호를 매개변수로 받아 비밀번호가 맞으면 true, 틀리면 false를 반환합니다.

다음 코드 스니펫은 사용법을 보여줍니다 PersonalStorage.Store.IsPasswordValid() 메서드.

using var pst = PersonalStorage.FromFile("passwordprotectedPST.pst");
Console.WriteLine($"Password is valid - {pst.Store.IsPasswordValid("Password1")}");

비밀번호 추가/변경/제거

다음은 PersonalStorage.Store.ChangePassword 메서드는 비밀번호를 추가, 변경 또는 삭제하는 데 사용됩니다.

이를 위해 다음 단계에 따르세요:

파일 또는 스트림에서 PST를 로드합니다.
다음을 호출합니다. PersonalStorage.Store.ChangePassword 메서드. 비밀번호를 추가하거나 변경하려면 비밀번호 문자열을 매개변수로 전달하고, 비밀번호를 제거하려면 null 값을 전달합니다.

using var pst = PersonalStorage.Create("SetPasswordOnPST_out.pst", FileFormatVersion.Unicode);
// Add or change the password
const string password = "Password1";
pst.Store.ChangePassword(password);
// Remove the password
pst.Store.ChangePassword(null);

Net: PST 파일을 읽고 정보 검색

Mon, 01 Jan 0001 00:00:00 +0000

PST 파일 읽기 및 정보 가져오기

Aspose.Email for .NET은 Microsoft Outlook PST 파일을 읽기 위한 API를 제공합니다. 디스크 또는 스트림에서 PST 파일을 로드하여 다음 인스턴스에 넣을 수 있습니다: PersonalStorage 클래스와 해당 내용에 대한 정보를 가져옵니다(예: 폴더, 하위 폴더, 메시지). API는 PST 폴더에서 메시지를 탐색할 때 검색 폴더를 포함할 수 있는 기능도 제공합니다.

PST 파일 로드

Outlook PST 파일은 다음 인스턴스에 로드할 수 있습니다: PersonalStorage 클래스. 다음 코드 스니펫은 PST 파일을 로드하는 방법을 보여줍니다.

폴더 정보 표시

PST 파일을 로드한 후 PersonalStorage 클래스를 사용하면 파일 표시 이름, 루트 폴더, 하위 폴더 및 메시지 수에 대한 정보를 얻을 수 있습니다. 다음 코드 스니펫은 PST 파일 이름, 폴더 및 폴더 내 메시지 수를 표시하는 방법을 보여줍니다.

사용자 정의 폴더만 가져오기

PST/OST 파일에는 사용자가 만든 폴더가 포함될 수 있습니다. Aspose.Email은 다음을 사용하여 사용자 정의 폴더만 액세스하는 기능을 제공합니다: PersonalStorageQueryBuilder.OnlyFoldersCreatedByUser 속성입니다. 이를 설정할 수 있습니다. PersonalStorageQueryBuilder.OnlyFoldersCreatedByUser 속성을 true 로 설정하여 사용자 정의 폴더만 가져옵니다. 다음 코드 스니펫은 사용 예시를 보여줍니다. PersonalStorageQueryBuilder.OnlyFoldersCreatedByUser 사용자 정의 폴더를 가져오기 위해.

폴더가 미리 정의된 것인지 확인

PST(Personal Storage Table) 파일 내 폴더를 열고 검사할 때, 각 폴더가 사전 정의된 폴더 유형인지 혹은 사전 정의된 폴더 유형의 하위 폴더인지 확인하고 각 폴더에 대한 정보를 얻을 수 있습니다.

다음은 FolderInfo.GetPredefinedType(bool getForTopLevelParent) 메서드는 폴더가 다음에 속하는지 확인할 수 있게 합니다: StandardIpmFolder. getForTopLevelParent 매개변수가 true이면 메서드는 다음을 반환합니다: StandardIpmFolder 최상위 상위 폴더에 대한 enum 값. 이는 현재 폴더가 미리 정의된 폴더의 하위 폴더인지 여부를 결정합니다. getForTopLevelParent 매개변수가 false이면 이것을 반환합니다: StandardIpmFolder 현재 폴더에 대한 enum 값.

다음 코드 샘플은 이 기능을 프로젝트에 구현하는 방법을 보여줍니다:

PersonalStorage.FromFile("my.pst"))
        {
            FolderInfoCollection folders = pst.RootFolder.GetSubFolders();

            foreach (FolderInfo folder in folders)
            {
                Console.WriteLine($"Folder: {folder.DisplayName}");
                Console.WriteLine($"Is predefined: {folder.GetPredefinedType(false) != StandardIpmFolder.Unspecified}");
                Console.WriteLine("-----------------------------------");
            }
        }

상위 폴더 정보 검색

다음 코드 스니펫은 부모 폴더 정보를 다음으로부터 가져오는 방법을 보여줍니다: MessageInfo.

경로로 하위 폴더 검색

다음은 FolderInfo.GetSubFolder(string name, bool ignoreCase, bool handlePathSeparator) 메서드 오버로드를 통해 현재 PST 폴더에서 지정된 이름의 하위 폴더를 검색할 수 있습니다.

이 메서드는 다음 매개변수를 사용합니다:

name - 검색할 하위 폴더의 이름을 지정합니다.
ignoreCase - 하위 폴더 이름 검색이 대소문자를 구분할지 여부를 결정합니다. true 로 설정하면 검색이 대소문자를 구분하지 않으며, 그렇지 않으면 대소문자를 구분합니다.
handlePathSeparator - 지정된 폴더 이름에 백슬래시가 포함된 경우 경로로 취급할지 여부를 지정합니다. true 로 설정하면 메서드는 폴더 이름을 경로로 해석하여 해당 경로를 사용해 하위 폴더로 이동을 시도합니다. false 로 설정하면 메서드는 폴더 이름을 단순한 이름으로 처리하여 정확히 일치하는 이름의 하위 폴더를 검색합니다.

다음 코드 샘플은 프로젝트에서 이 메서드를 구현하는 방법을 보여줍니다:

var folder = pst.RootFolder.GetSubFolder(@"Inbox\Reports\Jan", true, true);
In this sample, the method will return a ‘Jan’ named folder that is located at the Inbox\Reports\ path relative to the root folder.

RSS 피드 및 검색 가능한 폴더

PersonalStorage의 표준 RSS 피드 폴더

Aspose.Email을 사용하면 RSS 피드를 보유하는 사전 정의된 폴더에 대한 참조를 얻을 수 있습니다. 이는 Outlook PST 파일에 저장된 RSS 피드에 프로그래밍으로 접근하고 조작하려는 경우에 유용합니다. RssFeeds 값을 다음에 전달하세요: StandardIpmFolder 열거형.

다음 코드 예제는 RSS 피드 폴더를 가져오는 방법을 보여줍니다.

using (var pst = PersonalStorage.FromFile("my.pst", false))
{
    var rssFolder = pst.GetPredefinedFolder(StandardIpmFolder.RssFeeds);
}

RSS 피드 폴더를 추가하려면 다음 코드 스니펫을 사용하십시오:

using (var pst = PersonalStorage.Create("my.pst", FileFormatVersion.Unicode))
{
    var rssFolder = pst.CreatePredefinedFolder("RSS Feeds", StandardIpmFolder.RssFeeds);
}

검색 가능한 폴더 구문 분석

PST/OST는 일반 폴더 외에도 검색 가능한 폴더를 포함할 수 있습니다. Aspose.Email은 다음을 제공합니다. FolderKind 해당 검색 폴더에서 메시지를 지정하기 위한 열거자와 함께 EnumerateFolders 및 GetSubFolders 메서드. 다음 코드 스니펫은 검색 가능한 폴더를 파싱하는 방법을 보여줍니다.

using (PersonalStorage pst = PersonalStorage.FromFile("my.pst"))
        {
            FolderInfoCollection folders = pst.RootFolder.GetSubFolders(FolderKind.Search | FolderKind.Normal);

            // Browse through each folder to display folder name and number of messages
            foreach (FolderInfo folder in folders)
            {
                Console.WriteLine($"Folder: {folder.DisplayName}");

                FolderInfoCollection subFolders = folder.GetSubFolders(FolderKind.Search | FolderKind.Normal);
                foreach (FolderInfo subFolder in subFolders)
                {
                    Console.WriteLine($"Sub-folder: {subFolder.DisplayName}");
                }
            }
        }

PST 파일 탐색 API

탐색 API는 원본 파일 일부 데이터가 손상된 경우에도 예외를 발생시키지 않고 가능한 한 모든 PST 항목을 추출할 수 있게 해줍니다. 다음 단계는 이 API를 사용하는 방법을 보여줍니다.

사용 PersonalStorage 생성자와 Load FromFile 메서드 대신 사용하는 메서드.

생성자를 통해 콜백 메서드를 정의할 수 있습니다.

using (var currentPst = new PersonalStorage((exception, itemId) => { /* Exception handling  code. */ }))

로드 및 탐색 중 발생한 예외는 콜백 메서드를 통해 확인할 수 있습니다.

다음은 Load 파일이 성공적으로 로드되고 추가 탐색이 가능하면 메서드는 ’true’를 반환합니다. 파일이 손상되어 탐색이 불가능한 경우 ‘false’를 반환합니다.

if (currentPst.Load(inputStream))

이를 통해 예외를 발생시키지 않고 손상된 PST 파일도 열고 탐색할 수 있습니다. 예외와 손상된 항목은 콜백 메서드에서 처리됩니다.

using (PersonalStorage pst = new PersonalStorage((exception, itemId) => { /* Exception handling  code. */ }))
{
    if (pst.Load(@"test.pst"))
    {
        GetAllMessages(pst, pst.RootFolder);
    }
}

private static void GetAllMessages(PersonalStorage pst, FolderInfo folder)
{
    foreach (var messageEntryId in folder.EnumerateMessagesEntryId())
    {
        MapiMessage message = pst.ExtractMessage(messageEntryId);
    }
    foreach (var subFolder in folder.GetSubFolders())
    {
        GetAllMessages(pst, subFolder);
    }
}

PST 파일에서 항목 카테고리 색상 검색

Aspose.Email을 사용하면 PST 파일에서 이름 및 색상을 포함한 카테고리 정보를 검색할 수 있습니다. 카테고리 데이터를 추출하여 개별 PST 항목과 매칭할 수 있습니다. 다음 API 멤버를 사용하십시오:

OutlookCategoryColor enum - 카테고리와 연결된 색상을 나타냅니다.
PstItemCategory 클래스 - 카테고리 이름과 색상에 대한 속성을 제공합니다.
GetCategories 메서드 - 이름과 색상을 포함한 카테고리 목록을 반환합니다.

다음 코드 샘플은 PST 파일에서 사용 가능한 모든 카테고리를 검색하고 특정 이메일 메시지와 연결된 카테고리를 일치시키는 방법을 보여줍니다.

PST에서 사용 가능한 카테고리 검색

using (var pst = PersonalStorage.FromFile("mailbox.pst"))
{
   var categories = pst.GetCategories();
   
   foreach(var category in categories)
   {
       Console.WriteLine(category);
   }
}

카테고리 이름을 색상과 일치시키기

using (var pst = PersonalStorage.FromFile("mailbox.pst"))
{
    // Get all categories from the PST
    var availableCategories = pst.GetCategories();
    
    // Extract a message from the PST and retrieve the list of category names for the message
    var messageCategoryList = FollowUpManager.GetCategories(pst.ExtractMessage(messageInfo));
    
    // Iterate through each category in the message and match it with the PST category list
    foreach (var messageCategory in messageCategoryList)
    {
        var category = availableCategories.Find(c => c.Name.Equals(messageCategory, StringComparison.OrdinalIgnoreCase));

        if (category != null)
        {
            // Print the category name and its associated color
            Console.WriteLine(category);
        }
        else
        {
            Console.WriteLine($"Category: {messageCategory}, Color: Not found");
        }
    }
}

Net: 손상된 PST/OST 파일 읽기

Mon, 01 Jan 0001 00:00:00 +0000

손상된 저장소 파일 처리

때때로 일부 문제로 인해 PST/OST를 읽을 수 없을 수 있습니다. 예를 들어, 일부 데이터 블록이 손상될 수 있습니다. 이러한 경우에는 메서드를 호출할 때 예외가 발생하는 경우가 많습니다 the EnumerateFolders, EnumerateMessages, GetContents, GetSubfolders, 등 메서드. 그러나 개별 메시지나 폴더는 저장소에서 손상되지 않을 수 있습니다.

항목 식별자를 찾는 메서드

다음 메서드를 사용하면 계층적으로 항목 식별자를 찾을 수 있습니다.

FindMessages(string parentEntryId) - 폴더의 메시지 식별자를 찾습니다.
FindSubfolders(string parentEntryId) - 폴더의 하위 폴더 식별자를 찾습니다.

메서드를 사용하여 얻은 식별자는 메시지와 폴더를 검색하는 데 사용할 수 있습니다.

NOTE: 장점에도 불구하고, 이러한 방법을 사용하더라도 읽을 수 없는 손상된 저장소가 있다는 점에 유의해야 합니다.

PST 파일 탐색

다음 코드 샘플은 PST 파일을 탐색하고 폴더와 메시지를 추출하는 방법을 보여줍니다. 식별자 목록을 얻으려면 FindMessages 및 FindSubfolders 메서드를 사용하십시오. 그런 다음 식별자는 the ExtractMessage 또는 GetFolderById 요소를 추출하는 메서드.

using (var pst = PersonalStorage.FromFile(fileName))
{
    ExploreCorruptedPst(pst, pst.RootFolder.EntryIdString);
}

public static void ExploreCorruptedPst(PersonalStorage pst, string rootFolderId)
{
    var messageIdList = pst.FindMessages(rootFolderId);

    foreach (var messageId in messageIdList)
    {
        try
        {
            var msg = pst.ExtractMessage(messageId);
            Console.WriteLine( "- " + msg.Subject);
        }
        catch
        {
            Console.WriteLine("Message reading error. Entry id: " + messageId);
        }
    }

    var folderIdList = pst.FindSubfolders(rootFolderId);

    foreach (var subFolderId in folderIdList)
    {
        if (subFolderId != rootFolderId)
        {
            try
            {
                FolderInfo subfolder = pst.GetFolderById(subFolderId);
                Console.WriteLine(subfolder.DisplayName);
            }
            catch
            {
                Console.WriteLine("Message reading error. Entry id: " + subFolderId);
            }

            ExplodeCorruptedPst(pst, subFolderId);
        }
    }
}

Net: 대용량 PST 파일 작업

Mon, 01 Jan 0001 00:00:00 +0000

대용량 PST 파일을 처리할 때 성능이 저하될 수 있습니다. 다음 솔루션은 대용량 저장 파일을 처리할 때 앱의 성능을 향상시키는 데 도움이 됩니다.

다음 메서드 반환을 고려하십시오: IEnumerable pst에서 폴더나 메시지를 탐색할 때

using var pst = PersonalStorage.FromFile(@"storage.pst");

foreach (var folder in pst.RootFolder.EnumerateFolders())
foreach (var messageInfo in folder.EnumerateMessages())
{
    // Do something with message
}

선호하십시오 MessageInfo 기본 메시지 속성에 접근하기 위해.

foreach (var messageInfo in folder.EnumerateMessages())
{
    Console.WriteLine($"Subject: {messageInfo.Subject}");
    Console.WriteLine($"To: {messageInfo.DisplayTo}");
    Console.WriteLine($"Importance: {messageInfo.Importance}");
    Console.WriteLine($"Message Class: {messageInfo.MessageClass}");
}

다음 사용을 피하십시오: ExtractMessage 또는 EnumerateMapiMessages 모든 속성에 접근해야 할 필요가 없는 경우, 모든 메시지에 대해 메서드를 사용하십시오.

다음 사용을 고려하십시오: EnumerateMessagesEntryId 폴더에 포함된 모든 메시지 ID를 손쉽게 가져오기 위해.

foreach (var id in folder.EnumerateMessagesEntryId())
{
  // Use id to retrieve a property (ExtractProperty),
    // extract a MapiMessage (ExtractMessage),
    // extarct message attachments (ExtractAttachments),
    // save msg to a stream(SaveMessageToStream).
}

다음 사용을 고려하십시오: ExtractProperty MessageInfo에 누락된 단일 속성을 읽기 위해.

foreach (var msgId in folder.EnumerateMessagesEntryId())
{
   var transportMessageHeaders =
       pst.ExtractProperty(Convert.FromBase64String(msgId), KnownPropertyList.TransportMessageHeaders.Tag)
           .GetString();
}

다음 사용을 고려하십시오: ExtractAttachments 첨부 파일만 필요한 경우.

foreach (var msgId in folder.EnumerateMessagesEntryId())
{
   var attachments = pst.ExtractAttachments(msgId);
}

사용 조건별 검색-기반 필터링을 사용하여 필요한 메시지를 가져옵니다.

using var pst = PersonalStorage.FromFile(@"storage.pst");

var builder = new PersonalStorageQueryBuilder();
// Unread messages
builder.HasNoFlags(MapiMessageFlags.MSGFLAG_READ);

foreach (var folder in pst.RootFolder.EnumerateFolders())
{
    var unread = folder.GetContents(builder.GetQuery());
}

다음 사용을 고려하십시오: SaveMessageToStream pst에서 메시지를 저장해야 하는 경우.

다음 사용 대신:

foreach (var id in folder.EnumerateMessagesEntryId())
{
    var msg = pst.ExtractMessage(id);
    msg.Save(@"message.msg");
}

사용:

foreach (var id in folder.EnumerateMessagesEntryId())
{
    pst.SaveMessageToStream(id, File.OpenWrite(@"message.msg"));
}

대량 메서드를 선호하십시오: 추가 또는 delete 다중 항목.

Net: Outlook 파일 읽기 및 변환

Mon, 01 Jan 0001 00:00:00 +0000

OST 파일 작업

Aspose.Email for .NET은 Microsoft Outlook OST 파일을 읽기 위한 API를 제공합니다. 디스크나 스트림에서 OST 파일을 로드하여 인스턴스로 만들 수 있습니다. Aspose.Email.Outlook.Pst.PersonalStorage 폴더, 하위 폴더 및 메시지와 같은 내용을 액세스하는 클래스입니다. Microsoft Outlook은 POP3 또는 IMAP 메일 서버를 사용할 때 이메일을 저장하기 위해 PST 파일을 생성합니다. 반면에 Microsoft Exchange가 메일 서버인 경우 OST 파일을 생성합니다. OST 파일은 PST 파일보다 큰 파일 크기도 지원합니다.

OST 파일 읽기

Aspose.Email를 사용해 OST 파일을 읽는 과정은 PST 파일을 읽는 것과 정확히 동일합니다. 동일한 코드로 PST와 OST 파일 모두를 읽을 수 있습니다: 올바른 파일 이름을 제공하기만 하면 됩니다. PersonalStorage.FromFile() 방법. 다음 코드 스니펫은 OST 파일을 읽는 방법을 보여줍니다.

OST를 PST로 변환

사용해 보세요!

무료로 이메일 및 메시지 아카이브를 온라인에서 변환하세요 Aspose.Email 변환 앱.

Aspose.Email를 사용하면 한 줄의 코드로 OST 파일을 PST로 변환할 수 있습니다. 마찬가지로 동일한 한 줄의 코드를 사용해 PST 파일에서 OST 파일을 생성할 수 있습니다. FileFormat 열거자. 현재 API는 OST 형식을 PST로 변환하는 것을 지원하지만 2013/2016/2019/2021 및 향후 버전은 제외합니다. 다음 코드 조각은 OST를 PST로 변환하는 방법을 보여줍니다.

OST 파일에 대한 다른 작업을 수행하려면 다음 페이지를 참고하십시오:

PST를 OST로 변환

Aspose.Email에서는 PST를 OST로 변환하는 것을 지원하지 않습니다. OST는 계정을 추가하고 메일 서버와 동기화할 때 Outlook에 의해 항상 생성되기 때문입니다. PST와 OST 파일의 차이는 PST는 로컬에만 존재하고, OST 내용은 이메일 서버에도 존재한다는 점입니다. 따라서 로컬 용도로 PST를 OST로 변환할 필요가 없습니다. 대신 Outlook의 가져오기/내보내기 마법사를 사용해 PST를 기존 계정으로 가져올 수 있습니다.

OLM은 Microsoft Outlook에서 로컬 데이터(이메일, 첨부 파일, 메모, 캘린더 데이터, 연락처, 작업, 기록 등)를 저장하기 위해 사용하는 특정 파일 형식입니다. OLM 파일은 Outlook for Mac에서만 호환되며, Windows용 Outlook에서는 PST 파일 형식을 사용하므로 열거나 접근할 수 없습니다.

OLM 파일 작업

OLM 파일 열기

OLM 형식 파일은 두 가지 방법으로 열 수 있습니다:

생성자 사용
정적 FromFile 메서드 사용

이 메서드들 사이에는 동작 차이가 있습니다. 아래 섹션을 참고하십시오.

생성자 사용

파일을 열려면, 다음의 생성자를 호출합니다 OlmStorage 클래스이며 전체 파일 이름이나 스트림을 인수로 전달합니다:

var fileName = "MyStorage.olm";
var olm = new OlmStorage(fileName);

FromFile 정적 메서드 사용

파일을 열려면 정적 메서드를 사용합니다 FromFile 전체 파일명 또는 스트림을 인수로 전달합니다:

var fileName = "MyStorage.olm";
var olm = OlmStorage.FromFile(fileName);

폴더 가져오기

OLM 파일의 디렉터리 구조에 접근하려면, 해당 클래스의 인스턴스를 생성합니다: OlmStorage 생성자를 사용해 클래스를 인스턴스화하고 파일 경로를 전달합니다. 파일이 열리면 해당 디렉터리 구조에 접근합니다. FolderHierarchy 속성. 이 속성은 목록을 반환합니다: OlmFolder 각 객체는 OLM 파일의 디렉터리를 나타냅니다. 디렉터리 구조를 더 탐색하려면 다음에 접근하세요: SubFolders 각 객체의 속성으로, 해당 객체의 하위 디렉터리 목록을 반환합니다. 이러한 속성을 사용하면 OLM 파일의 전체 디렉터리 계층 구조를 탐색하고 포함된 모든 디렉터리와 하위 디렉터리에 접근할 수 있습니다.

다음 예제는 계층 순서로 모든 폴더 목록을 표시합니다:

using (var olm = new OlmStorage(fileName))
{
    PrintAllFolders(olm.FolderHierarchy, string.Empty);
}

private void PrintAllFolders(List<OlmFolder> folderHierarchy, string indent)
{
    foreach (var folder in folderHierarchy)
    {
        Console.WriteLine($"{indent}{folder.Name}");
        PrintAllFolders(folder.SubFolders, indent+"-");
    }
}

사용할 때 FromFile OLM 파일을 열기 위한 메서드, the FolderHierarchy 속성은 기본적으로 초기화되지 않으며 null을 반환합니다. 이 경우 GetFolders 메서드를 명시적으로 호출하여 초기화하십시오. FolderHierarchy 속성을 사용하여 OLM 파일의 디렉터리 목록을 가져옵니다:

using (var olm = OlmStorage.FromFile(fileName))
{
    var folders = olm.GetFolders();
}

또한, 이름으로 폴더를 가져올 수도 있습니다:

호출하십시오 GetFolder 메서드.
첫 번째 인수로 폴더 이름을 전달하고, 두 번째 매개변수로 폴더 검색 시 대소문자를 무시할지 여부를 나타내는 값을 전달합니다.

using (var olm = OlmStorage.FromFile(fileName))
{
    // get inbox folder by name
    OlmFolder folder = olm.GetFolder("Inbox", true);
}

이메일 목록

OlmFolder 클래스(폴더를 나타내는)는 이메일 목록을 가져오는 다음 메서드를 제공합니다:

EnumerateMessages 폴더 내 이메일을 반복하는 기능을 구현합니다. 이 경우 각 반복은 반환합니다 OlmMessageInfo 이메일에 대한 간단한 정보를 제공하는 객체.
EnumerateMapiMessages, 폴더 내 이메일을 반복하는 기능도 구현하지만, 이 경우 각 반복은 반환합니다 MapiMessage 모든 속성을 포함한 이메일 자체를 나타내는 객체.

EnumerateMessages 메서드 사용

using (var olm = OlmStorage.FromFile(fileName))
{
    var folder = olm.GetFolder("Inbox", true);
    foreach (var messageInfo in folder.EnumerateMessages())
    {
        Console.WriteLine(messageInfo.Subject);
    }
}

EnumerateMapiMessages 메서드 사용

using (var olm = OlmStorage.FromFile(fileName))
{
    var folder = olm.GetFolder("Inbox", true);

    foreach (var msg in folder.EnumerateMapiMessages())
    {
        // save message in MSG format
        msg.Save($"{msg.Subject}.msg");
    }
}

다른 유용한 속성

OlmFolder 클래스의 다른 유용한 속성은 다음과 같습니다: HasMessages 및 MessageCount 폴더에 메시지가 있는지 여부와 메시지 개수를 반환하는 속성들.

using (var olm = OlmStorage.FromFile(fileName))
{
    var folder = olm.GetFolder("Inbox", true);

    if (folder.HasMessages)
    {
        Console.WriteLine($"Message count: {folder.MessageCount}");
    }
}

메시지의 수정 날짜 가져오기 또는 설정하기

수정 날짜는 OLM 메시지가 마지막으로 수정된 날짜와 시간을 나타냅니다. 이를 사용할 수 있습니다 OlmMessageInfo.ModifiedDate OLM 메시지의 수정 날짜 값을 가져오거나 업데이트하는 속성.

다음은 해당 속성 사용을 보여주는 예시입니다:

foreach (OlmMessageInfo messageInfo in inboxFolder.EnumerateMessages())
{
   DateTime modifiedDate = messageInfo.ModifiedDate;
}

이메일 및 항목 추출

OlmStorage 클래스에는 ExtractMapiMessage 이메일을 추출할 수 있는 메서드. 이 메서드는 OlmMessageInfo 객체.

using (var olm = OlmStorage.FromFile(fileName))
{
    var folder = olm.GetFolder("Inbox", true);

    foreach (var messageInfo in folder.EnumerateMessages())
    {
        if (messageInfo.Date == DateTime.Today)
        {
            // Extracts today's messages form Inbox
            var msg = olm.ExtractMapiMessage(messageInfo);
        }
    }
}

Traversal API 사용

원본 파일의 일부 데이터가 손상되었더라도 예외를 발생시키지 않고 가능한 한 모든 항목을 Outlook OLM 파일에서 추출할 수 있습니다. 이를 수행하려면 다음을 사용하세요. OlmStorage(TraversalExceptionsCallback callback) 생성자와 Load(string fileName) FromFile 메서드 대신 사용하는 메서드입니다. 생성자를 통해 콜백 메서드를 정의할 수 있습니다.

using (var olm = new OlmStorage((exception, id) => { /* Exception handling  code. */ }))

콜백 메서드는 로드 및 탐색 중 발생하는 예외를 제공하도록 합니다.

if (olm.Load(fileName))

다음 코드 스니펫과 단계는 이 API를 사용하는 방법을 보여줍니다:

새 인스턴스를 생성합니다 OlmStorage 클래스이며, 프로세스 중 발생하는 모든 예외를 처리하기 위해 예외 처리 콜백을 전달합니다.
다음 메서드를 호출하여 OLM 파일을 로드합니다. Load OlmStorage 인스턴스의 메서드.
OLM 파일이 성공적으로 로드되면, 호출하여 폴더 계층 구조를 얻습니다. GetFolders OlmStorage 인스턴스의 메서드입니다. 이는 OlmFolder 객체 목록을 반환합니다.
OlmStorage 인스턴스와 OlmFolder 객체 리스트를 전달하여 ExtractItems 메서드를 호출합니다.
ExtractItems 메서드에서 folders 리스트의 각 폴더를 반복합니다.
폴더에 메시지(이메일)가 포함되어 있으면, Console.WriteLine(folder)를 사용하여 폴더 이름을 콘솔에 출력합니다.
OlmStorage 인스턴스에서 EnumerateMessages 메서드를 호출하고 현재 폴더를 인수로 전달하여 현재 폴더의 메시지를 반복합니다.
Console.WriteLine(msg.Subject)를 사용하여 각 메시지의 제목을 콘솔에 출력합니다.
폴더에 하위 폴더가 있는 경우, OlmStorage 인스턴스와 현재 폴더의 하위 폴더를 전달하면서 ExtractItems 메서드를 재귀적으로 다시 호출합니다.

using (var olm = new OlmStorage((exception, id) => { /* Exception handling  code. */ }))
{
    if (olm.Load(fileName))
    {
        var folderHierarchy = olm.GetFolders();
        ExtractItems(olm, folderHierarchy);
    }
}

private static void ExtractItems(OlmStorage olm, List<OlmFolder> folders)
{
    foreach (var folder in folders)
    {
        if (folder.HasMessages)
        {
            Console.WriteLine(folder);

            foreach (var msg in olm.EnumerateMessages(folder))
            {
                Console.WriteLine(msg.Subject);
            }
        }

        if (folder.SubFolders.Count > 0)
        {
            ExtractItems(olm, folder.SubFolders);
        }
    }
}

식별자별 메시지 추출

때때로 식별자를 사용하여 선택된 메시지를 추출해야 할 경우가 있습니다. 예를 들어 애플리케이션이 데이터베이스에 식별자를 저장하고 필요할 때 메시지를 추출합니다. 이는 특정 메시지를 찾기 위해 매번 전체 저장소를 탐색하는 것을 피하는 효율적인 방법입니다. 이 기능은 OLM 저장소에서 사용할 수 있습니다. EntryId 속성 OlmMessageInfo 클래스는 메시지 엔트리 식별자를 가져옵니다. 오버로드된 ExtractMapiMessage(string id) 메서드 OlmStorage 클래스는 OLM에서 메시지를 가져옵니다.

아래 코드는 식별자를 사용하여 OLM에서 메시지를 추출하는 방법을 보여줍니다.

코드는 다음 단계를 수행합니다:

foreach 루프를 시작하여 목록을 반복합니다: OlmMessageInfo 객체. 루프는 다음을 사용합니다 EnumerateMessages olmFolder 객체의 메서드를 사용하여 현재 반복 중인 폴더의 모든 메시지 목록을 가져옵니다.
루프는 스토리지에서 해당 MapiMessage 객체를 호출하여 추출합니다. ExtractMapiMessage(string id) 메서드 OlmStorage 클래스, 전달되는 EntryId 현재 메시지를 매개변수로 사용합니다.

검색된 MapiMessage 객체를 사용하여 메시지 내용을 액세스하고 조작할 수 있습니다. 폴더의 모든 메시지가 처리될 때까지 루프가 계속됩니다.

  foreach (OlmMessageInfo msgInfo in olmFolder.EnumerateMessages())
  {
      MapiMessage msg = storage.ExtractMapiMessage(msgInfo.EntryId);
  }

폴더 경로 가져오기

OML 파일의 폴더 경로도 가져올 수 있습니다. Aspose.Email은 제공합니다 OlmFolder.Path 폴더 경로를 반환하는 속성. 다음 코드 스니펫은 사용법을 보여줍니다 OlmFolder.Path OML 파일에서 폴더 경로를 가져오는 속성.

var storage = new OlmStorage("SampleOLM.olm");
PrintPath(storage, storage.FolderHierarchy);

public static void PrintPath(OlmStorage storage, List<OlmFolder> folders)
{
    foreach (OlmFolder folder in folders)
    {
        // print the current folder path
        Console.WriteLine(folder.Path);

        if (folder.SubFolders.Count > 0)
        {
            PrintPath(storage, folder.SubFolders);
        }
    }
}

폴더 내 항목 수

폴더 내 항목 수를 셀 수도 있습니다. Aspose.Email은 제공합니다 OlmFolder.MessageCount 폴더 내 항목 수를 반환하는 속성. 다음 코드 스니펫은 사용법을 보여줍니다 OlmFolder.MessageCount OML 파일 폴더 내 항목 수를 가져오는 속성.

var storage = new OlmStorage("SampleOLM.olm");
PrintMessageCount(storage.FolderHierarchy);

public static void PrintMessageCount(List<OlmFolder> folders)
{
    foreach (OlmFolder folder in folders)
    {
        Console.WriteLine("Message Count [" + folder.Name + "]: " + folder.MessageCount);
    }
}

OlmStorage의 총 항목 수 가져오기

OlmStorage 클래스에도 있습니다 GetTotalItemsCount() OLM 저장소에 포함된 메시지 항목 총 개수를 반환하는 메서드.

  using (var olm = new OlmStorage("storage.olm"))
  {
     var count = olm.GetTotalItemsCount();
  }

Outlook 카테고리 색상 가져오기

OLM 파일에 저장된 카테고리 색상이나 Outlook 항목 카테고리를 작업하려면 Aspose.Email이 다음 솔루션을 제공합니다:

OlmItemCategory 클래스 - 이름과 16진수 형식의 색상으로 제공되는 Outlook 항목 카테고리를 나타냅니다.
GetCategories() 메서드 OlmStorage 클래스 - 카테고리 목록을 검색합니다.

다음 코드 샘플은 OML 저장소에서 사용된 모든 카테고리를 가져오는 방법을 보여줍니다:

using (var olm = OlmStorage.FromFile("storage.olm"))
{
    var categories = olm.GetCategories();
    
    foreach (var category in categories)
    {
        Console.WriteLine($"Category name: {category.Name}");
        
        //Color is represented as a hexadecimal value: #rrggbb
        Console.WriteLine($"Category color: {category.Color}");
    }
}

아래 코드 샘플은 메시지 카테고리 색상을 가져오는 방법을 보여줍니다:

foreach (var msg in olm.EnumerateMessages(folder))
{
    if (msg.Categories != null)
    {
        foreach (var msgCategory in msg.Categories)
        {
            Console.WriteLine($"Category name: {msgCategory}");
            var categoryColor = cat.First(c => c.Name.Equals(msgCategory, StringComparison.OrdinalIgnoreCase)).Color;
            Console.WriteLine($"Category color: {categoryColor}");
        }
    }
}

OLM을 PST로 변환

OLM OLM은 Microsoft Outlook for Mac 시스템에서 사용되는 데이터베이스 파일 형식입니다. OLM 파일은 이메일 메시지, 캘린더 데이터, 연락처 데이터 및 애플리케이션 설정을 저장합니다. OLM 파일은 Outlook for Windows에서 지원되지 않으며, 따라서 Outlook for Mac(OLM) 파일을 Windows용 Outlook에서 열 수 없습니다. Outlook for Mac에서 Windows용 Outlook으로 메일함을 마이그레이션하려면 Mac OLM 파일을 Outlook PST 파일 형식으로 변환해야 합니다.

코드 단계

OLM 파일을 PST로 변환하려면 아래 단계에 따르세요:

다음의 인스턴스를 생성합니다 OlmStorage 소스 OLM을 여는 클래스.
소스 OLM 파일을 엽니다.
다음으로 새 PST 파일을 생성합니다: Create 메서드.
메시지 클래스를 폴더 클래스로 매핑하는 GetContainerClass 메서드를 만듭니다.
EnumerateMapiMessages 메서드를 사용하여 OLM에서 각 폴더와 그 메시지를 재귀적으로 읽고 AddSubFolder 및 AddMessage 메서드를 사용하여 같은 순서대로 PST에 추가하는 AddToPst 메서드를 만듭니다.

코드 샘플

다음 코드 샘플은 OLM을 PST로 변환하는 방법을 보여줍니다.

Main 메서드:

// create an instance of OlmStorage class to open source OLM
using (var olm = new OlmStorage("my.olm"))
// create a new PST file
using (var pst = PersonalStorage.Create("my.pst", FileFormatVersion.Unicode))
{
    // recursively reads each folder and its messages 
    // and adds them to the PST in the same order
    foreach (var olmFolder in olm.FolderHierarchy)
    {
        AddToPst(pst.RootFolder, olmFolder);
    }
}

GetContainerClass 메서드 구현:

public string GetContainerClass(string messageClass)
{
    if (messageClass.StartsWith("IPM.Contact") || messageClass.StartsWith("IPM.DistList"))
    {
        return "IPF.Contact";
    }

    if (messageClass.StartsWith("IPM.StickyNote"))
    {
        return "IPF.StickyNote";
    }

    if (messageClass.StartsWith("IPM.Activity"))
    {
        return "IPF.Journal";
    }

    if (messageClass.StartsWith("IPM.Task"))
    {
        return "IPF.Task";
    }

    if (messageClass.StartsWith("IPM.Appointment") || messageClass.StartsWith("IPM.Schedule.meeting"))
    {
        return "IPF.Appointment";
    }

    return "IPF.Note";
}

AddToPst 메서드 구현:

public void AddToPst(FolderInfo pstFolder, OlmFolder olmFolder)
{
    FolderInfo pstSubFolder = pstFolder.GetSubFolder(olmFolder.Name);

    foreach (var msg in olmFolder.EnumerateMapiMessages())
    {
        if (pstSubFolder == null)
        {
            pstSubFolder = pstFolder.AddSubFolder(olmFolder.Name, GetContainerClass(msg.MessageClass));
        }

        pstSubFolder.AddMessage(msg);
    }

    if (pstSubFolder == null)
    {

        pstSubFolder = pstFolder.AddSubFolder(olmFolder.Name);
    }

    foreach (var olmSubFolder in olmFolder.SubFolders)
    {
        AddToPst(pstSubFolder, olmSubFolder);
    }
}