File SDK - Process email .msg files (C#)

2025-04-14

Zestaw SDK plików obsługuje operacje etykietowania dla plików .msg w sposób identyczny z dowolnym innym typem pliku, z tą różnicą, że zestaw SDK potrzebuje aplikacji do włączenia flagi funkcji MSG. W tym miejscu zobaczymy, jak ustawić tę flagę.

Jak wspomniano wcześniej, instancjowanie IFileEngine wymaga obiektu ustawień FileEngineSettings. FileEngineSettings może służyć do przekazywania parametrów dla ustawień niestandardowych, które aplikacja musi ustawić dla określonego wystąpienia. CustomSettings Właściwość FileEngineSettings jest używana do ustawienia flagi dla enable_msg_file_type w celu umożliwienia przetwarzania plików .msg.

Wymagania wstępne

Jeśli jeszcze tego nie zrobiono, przed kontynuowaniem upewnij się, że zostały spełnione następujące wymagania wstępne:

Complete Quickstart: File SDK application initialization (C#) first, which builds a starter Visual Studio solution. This "How to - process email message .msg files (C#)" quickstart builds on the previous one.
Zapoznaj się z pojęciami dotyczącymi MIP SDK dla plików e-mail.
Opcjonalnie: Zapoznaj się z pojęciami dotyczącymi silników plików w zestawie MIP SDK.
Opcjonalnie: Zapoznaj się z koncepcjami obsługi plików w zestawie MIP SDK.

Set enable_msg_file_type and use File SDK for labeling .msg file

In continuation of File API application initialization quickstart, modify the file engine construction code to set enable_msg_file_type flag and then use the file engine to label a .msg file.

Open the Visual Studio solution you created in the previous "Quickstart: File SDK application initialization (C#)".
Using Solution Explorer, open the .cs file in your project that contains the implementation of the Main() method. Domyślnie ma taką samą nazwę jak projekt zawierający go, który został określony podczas tworzenia projektu.

Remove the implementation of Main() function from previous quickstart. Main() Wewnątrz treści wstaw następujący kod. In below code block enable_msg_file_type flag is set during file engine creation, a .msg file can then be processed by IFileHandler objects created using the file engine.

static void Main(string[] args)
{
    // Initialize Wrapper for File SDK operations.
    MIP.Initialize(MipComponent.File);

    // Create ApplicationInfo, setting the clientID from Azure AD App Registration as the ApplicationId.
    ApplicationInfo appInfo = new ApplicationInfo()
    {
            ApplicationId = clientId,
            ApplicationName = appName,
            ApplicationVersion = "1.0.0"
    };

    // Instantiate the AuthDelegateImpl object, passing in AppInfo.
    AuthDelegateImplementation authDelegate = new AuthDelegateImplementation(appInfo);

    MipContext mipContext = MIP.CreateMipContext(appInfo,"mip_data",LogLevel.Trace,null,null);

    // Initialize and instantiate the File Profile.
    // Create the FileProfileSettings object.
    // Initialize file profile settings to create/use local state.
    var profileSettings = new FileProfileSettings(mipContext, 
                                CacheStorageType.OnDiskEncrypted, 
                                new ConsentDelegateImplementation());

    // Load the Profile async and wait for the result.
    var fileProfile = Task.Run(async () => await MIP.LoadFileProfileAsync(profileSettings)).Result;

    // Create a FileEngineSettings object, then use that to add an engine to the profile.
    var customSettings = new List<KeyValuePair<string, string>>();
    customSettings.Add(new KeyValuePair<string, string>("enable_msg_file_type", "true"));

    // Create a FileEngineSettings object, then use that to add an engine to the profile.
    var engineSettings = new FileEngineSettings("user1@tenant.com", authDelegate, "", "en-US");
    engineSettings.Identity = new Identity("user1@tenant.com");
    //set custom settings for the engine
    engineSettings.CustomSettings = customSettings;

    //Add fileEngine to profile
    var fileEngine = Task.Run(async () => await fileProfile.AddEngineAsync(engineSettings)).Result;

    //Set file paths
    string inputFilePath = "<input-file-path>"; //.msg file to be labeled
    string actualFilePath = inputFilePath;
    string outputFilePath = "<output-file-path>"; //labeled .msg file
    string actualOutputFilePath = outputFilePath;

    //Create a file handler for original file
    var fileHandler = Task.Run(async () => await fileEngine.CreateFileHandlerAsync(inputFilePath, 
                                                                actualFilePath, 
                                                                true)).Result;

    // List labels available to the user and use one of them to label the MSG file.

    foreach (var label in fileEngine.SensitivityLabels)
    {
        Console.WriteLine(string.Format("{0} - {1}", label.Name, label.Id));

        if (label.Children.Count > 0)
        {
            foreach (Label child in label.Children)
            {
                Console.WriteLine(string.Format("\t{0} - {1}", child.Name, child.Id));
            }
        }
    }

    string labelId = "<label-id>"; //label retrieved using file engine

    LabelingOptions labelingOptions = new LabelingOptions()
    {
        AssignmentMethod = options.AssignmentMethod
    };

    fileHandler.SetLabel(labelId, labelingOptions, new ProtectionSettings());

    // Commit changes, save as outputFilePath
    var result = Task.Run(async () => await fileHandler.CommitAsync(outputFilePath)).Result;

    // Create a new handler to read the labeled file metadata
    var handlerModified = Task.Run(async () => await fileEngine.CreateFileHandlerAsync(outputFilePath, 
                                                                    actualOutputFilePath, 
                                                                    true)).Result;

    Console.WriteLine(string.Format("Original file: {0}", inputFilePath));
    Console.WriteLine(string.Format("Labeled file: {0}", outputFilePath));
    Console.WriteLine(string.Format("Label applied to file: {0}", 
        handlerModified.Label.Name));
    Console.WriteLine("Press a key to continue.");
    Console.ReadKey();

    // Application Shutdown
    fileHandler = null;
    handlerModified = null;
    fileEngine = null;
    fileProfile = null;
    mipContext = null;
}

Aby uzyskać więcej informacji na temat operacji na plikach, zapoznaj się z pojęciami dotyczącymi obsługi plików.

Zastąp wartości symboli zastępczych w kodzie źródłowym przy użyciu następujących wartości:

Placeholder	Wartość
<ścieżka pliku wejściowego>	Pełna ścieżka do pliku komunikatu wejściowego testu, na przykład: `c:\\Test\\message.msg`.
<ścieżka pliku wyjściowego>	Pełna ścieżka do pliku wyjściowego, który będzie oznakowaną kopią pliku wejściowego, na przykład: `c:\\Test\\message_labeled.msg`.
<label-id>	The labelId retrieved using file engine, for example: `667466bf-a01b-4b0a-8bbf-a79a3d96f720`.

Kompilowanie i testowanie aplikacji

Skompiluj aplikację kliencą przy użyciu F6 (rozwiązanie kompilacji). Jeśli nie masz błędów kompilacji, użyj F5 (Rozpocznij debugowanie), aby uruchomić aplikację.

    Original file: C:\Test.msg
    Labeled file: C:\Test_Labeled.msg
    Label applied to file: Confidential    
    Press a key to continue.

Udostępnij za pośrednictwem

File SDK - Process email .msg files (C#)

Wymagania wstępne

Set enable_msg_file_type and use File SDK for labeling .msg file

Kompilowanie i testowanie aplikacji

Opinia

Dodatkowe zasoby