Dosya SDK'sı - E-posta .msg dosyalarını işleme (C#)
Dosya SDK'sı, .msg dosyaları için etiketleme işlemlerini, SDK'nın MSG özellik bayrağını etkinleştirmek için uygulamaya ihtiyacı olması dışında, başka herhangi bir dosya türüyle aynı şekilde destekler. Burada bu bayrağın nasıl ayarlandığını göreceğiz.
Daha önce açıklandığı gibi örneği IFileEngine
için bir ayar nesnesi FileEngineSettings
gerekir: . FileEngine Ayarlar, uygulamanın belirli bir örnek için ayarlaması gereken özel ayarlara yönelik parametreleri geçirmek için kullanılabilir. CustomSettings
FileEngineSettings
özelliği , .msg dosyalarının işlenmesini etkinleştirmek için bayrağını ayarlamak için enable_msg_file_type
kullanılır.
Ön koşullar
Henüz yapmadıysanız devam etmeden önce aşağıdaki önkoşulları tamamladığınızdan emin olun:
- Tam Hızlı Başlangıç: İlk olarak başlangıç Visual Studio çözümü oluşturan Dosya SDK'sı uygulaması başlatma (C#). Bu "Nasıl yapılır - e-posta iletisi .msg dosyalarını işleme (C#)" hızlı başlangıcı öncekini temel alır.
- E-posta dosyaları MIP SDK'sı kavramlarını gözden geçirin.
- İsteğe bağlı olarak: MIP SDK kavramlarındaki Dosya altyapılarını gözden geçirin.
- İsteğe bağlı olarak: MIP SDK kavramlarındaki Dosya işleyicilerini gözden geçirin.
.msg dosyasını etiketlemek için enable_msg_file_type ayarlayın ve Dosya SDK'sını kullanın
Dosya API'sini uygulama başlatma hızlı başlangıcının devamında, dosya altyapısı oluşturma kodunu ayarlayıp enable_msg_file_type flag
bir .msg dosyasını etiketlemek için dosya altyapısını kullanacak şekilde değiştirin.
Önceki "Hızlı Başlangıç: Dosya SDK'sı uygulaması başlatma (C#)" içinde oluşturduğunuz Visual Studio çözümünü açın.
Çözüm Gezgini kullanarak, yönteminin uygulanmasını
Main()
içeren projenizde .cs dosyasını açın. Varsayılan olarak, proje oluşturma sırasında belirttiğiniz, onu içeren projeyle aynı ada sahiptir.önceki hızlı başlangıçtan
Main()
işlev uygulamasını kaldırın. GövdeninMain()
içine aşağıdaki kodu ekleyin. Aşağıdaki kod bloğuenable_msg_file_type
bayrağı, dosya altyapısı oluşturma sırasında ayarlanır; daha sonra bir .msg dosyası, dosya altyapısı kullanılarak oluşturulan nesneler tarafındanIFileHandler
işlenebilir.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; }
Dosya işlemleri hakkında daha fazla bilgi için Dosya İşleyicisi kavramlarına bakın.
Aşağıdaki değerleri kullanarak kaynak koddaki yer tutucu değerlerini değiştirin:
Yer tutucu Değer <input-file-path> Bir test giriş iletisi dosyasının tam yolu, örneğin: c:\\Test\\message.msg
.<output-file-path> Çıkış dosyasının tam yolu; giriş dosyasının etiketli bir kopyası olacaktır, örneğin: c:\\Test\\message_labeled.msg
.<label-id> Dosya altyapısı kullanılarak alınan labelId, örneğin: 667466bf-a01b-4b0a-8bbf-a79a3d96f720
.
Uygulamayı derleme ve test etme
İstemci uygulamanızı derlemek için F6 (Derleme Çözümü) kullanın. Derleme hatanız yoksa, uygulamanızı çalıştırmak için F5 (Hata ayıklamayı başlat) kullanın.
Original file: C:\Test.msg
Labeled file: C:\Test_Labeled.msg
Label applied to file: Confidential
Press a key to continue.
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin