Documentation – کار با آیتم‌های Outlook

Net: ایجاد و ذخیره فایل‌های Outlook

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

Aspose.Email از ایجاد فایل‌های پیام Outlook (MSG) پشتیبانی می‌کند. این مقاله توضیح می‌دهد چگونه:

ایجاد و ذخیرهٔ پیام‌های اوتلوک

این MailMessage کلاس دارای Save() متدی که می‌تواند فایل‌های Outlook MSG را روی دیسک یا استریم ذخیره کند. کدهای نمونه زیر یک نمونه از MailMessage کلاس، ویژگی‌هایی مانند from، to، subject و body را تنظیم کنید. این Save() متد نام فایل را به‌عنوان آرگومان می‌گیرد. علاوه بر این، پیام‌های Outlook می‌توانند با یک بدنهٔ RTF فشرده با استفاده از MapiConversionOptions.

یک نمونهٔ جدید از MailMessage کلاس را می‌گیرد و ویژگی‌های From، To، Subject و Body را تنظیم می‌کند.
متد را فراخوانی کنید MapiMessage کلاس FromMailMessage متد که شیء از نوع MailMessage نوع. این FromMailMessage متد … را تبدیل می‌کند MailMessage به یک MapiMessage (MSG).
متد را فراخوانی کنید MapiMessage.Save() متد برای ذخیرهٔ فایل MSG.

کد زیر را در رویداد کلیک کنترل دکمه برنامه ویندوز بنویسید.

ایجاد فایل‌های MSG با پیوست‌ها

در مثال بالا، یک فایل MSG ساده ایجاد کردیم. Aspose.Email همچنین از ذخیرهٔ فایل‌های پیام با پیوست‌ها پشتیبانی می‌کند. تنها کاری که باید انجام دهید این است که پیوست‌ها را به MailMessage نمونه. پیوست‌ها را با فراخوانی متد Add() روی MailMessage.Attachments مجموعه اضافه می‌شوند. یک ListBox به فرم ایجاد شده در بالا اضافه کنید و دو دکمه برای افزودن و حذف پیوست‌ها اضافه کنید. برنامه‌ای که برنامه‌ها را اضافه می‌کند به این صورت کار می‌کند:

زمانی که دکمه Add Attachment کلیک می‌شود، یک Open File Dialog نمایش داده می‌شود تا به کاربران در مرور و انتخاب پیوست کمک کند.
وقتی فایلی انتخاب شد، مسیر کامل آن به یک لیست اضافه می‌شود.
هنگام ایجاد فایل MSG، مسیرهای پیوست از فهرست گرفته شده و به MailMessage.Attachments مجموعه.

کد زیر را در رویداد کلیک دکمه Add Attachment بنویسید.

وقتی دکمه Remove Attachment کلیک می‌شود، موارد انتخاب شده را از ListBox حذف کنید. کد زیر را در رویداد کلیک دکمه Remove Attachment بنویسید.

کد افزودن پیوست‌ها را به MailMessage نمونه. کد نهایی برای تابع Write Msg به صورت زیر نوشته شده است.

ایجاد فایل‌های MSG با بدنهٔ RTF

می‌توانید با Aspose.Email فایل‌های پیام Outlook (MSG) با بدنهٔ متن غنی (RTF) نیز ایجاد کنید. بدنه RTF از قالب‌بندی متن پشتیبانی می‌کند. برای ایجاد یک فایل، مقادیر مورد نیاز را تنظیم کنید. MailMessage.HtmlBody ویژگی. وقتی یک MailMessage نمونه به یک MapiMessage در این نمونه، بدنه HTML به RTF تبدیل می‌شود. به این ترتیب، قالب‌بندی بدنهٔ ایمیل حفظ می‌شود.

مثال زیر یک فایل MSG با بدنه RTF ایجاد می‌کند. یک سرعنوان وجود دارد که قالب‌بندی بولد و زیرخط در بدنه HTML اعمال شده است. این قالب‌بندی هنگام تبدیل HTML به RTF حفظ می‌شود.

فشرده‌سازی RTF برای بدنه پیام MAPI

توجه: فرآیند فشرده‌سازی می‌تواند هنگام ایجاد پیام‌ها عملکرد را کند کند. با درک این نکته و پیکربندی فلگ فشرده‌سازی بر اساس نیازهای خاص و تعادل بین حجم فایل و عملکرد، توسعه‌دهندگان می‌توانند به‌صورت مؤثر ایجاد فایل‌های MSG و PST را هنگام کار با پیام‌های ایمیل مدیریت کنند.

فشرده‌سازی RTF با هدف کاهش حجم پیام و همچنین فایل‌های PST (Personal Storage Table) که مایکروسافت اوتلوک برای ذخیره پیام‌های ایمیل و داده‌های دیگر استفاده می‌کند، طراحی شده است. با استفاده از فشرده‌سازی RTF هنگام پیکربندی بدنه پیام، توسعه‌دهندگان می‌توانند مقدار حافظه مورد نیاز برای ذخیره پیام‌های ایمیل را کاهش دهند یا پهنای باند شبکه را هنگام انتقال پیام‌ها بهینه کنند.

برای این منظور، دو متد overload شده طراحی شده‌اند:

MapiMessageItemBase.SetBodyContent(string content, BodyContentType contentType, bool compression): این متد به شما امکان می‌دهد محتویات بدنه پیام را با استفاده از رشته مشخص شده تنظیم کنید و نوع محتویات بدنه (مثلاً متن ساده، HTML و غیره) را تعیین کنید. پارامتر اختیاری compression مقداری است که تعیین می‌کند آیا محتوا باید با فشرده‌سازی RTF فشرده شود یا نه. اگر این پارامتر true باشد، محتوا فشرده می‌شود و منجر به پیام کوچکتر می‌شود.
MapiMessageItemBase.SetBodyRtf(string content, bool compression): این متد به‌طور خاص محتویات بدنه پیام را در قالب RTF تنظیم می‌کند. پارامتر content یک رشته است که محتوای RTF را نشان می‌دهد که به عنوان بدنه پیام تنظیم می‌شود. همانند متد قبلی، پارامتر compression تعیین می‌کند آیا فشرده‌سازی RTF باید روی محتوا اعمال شود یا نه. اگر compression برابر true باشد، محتوای RTF فشرده می‌شود تا حجم کاهش یابد.

نمونه کد زیر نشان می‌دهد چگونه بدنه HTML را تنظیم کنید و فشرده نگه دارید:

var msg = new MapiMessage("from@doamin.com", "to@domain.com", "subject", "body");
// set the html body and keep it compressed
// this will reduce the message size
msg.SetBodyContent(htmlBody, BodyContentType.Html, true);

همچنین یک MapiConversionOptions.UseBodyCompression ویژگی. وقتی این ویژگی فعال باشد، فشرده‌سازی بدنه RTF در طول تبدیل MailMessage به MapiMessage اعمال می‌شود و منجر به کاهش حجم فایل MSG می‌شود. در نمونه کد زیر نشان داده شده است:

var message = MailMessage.Load(fileName);
var options = new MapiConversionOptions();
options.UseBodyCompression = true;
var msg = MapiMessage.FromMailMessage(message, options);

ذخیره پیام در وضعیت پیش‌نویس

ایمیل‌ها به‌عنوان پیش‌نویس ذخیره می‌شوند زمانی که کاربری شروع به ویرایش آن‌ها کرده اما می‌خواهد برای تکمیل بعداً به آنها برگردد. Aspose.Email با تنظیم یک پرچم پیام، امکان ذخیرهٔ پیام‌های ایمیل در وضعیت پیش‌نویس را فراهم می‌کند. در زیر نمونه کدی برای ذخیرهٔ یک پیام ایمیل Outlook (MSG) به‌عنوان پیش‌نویس آورده شده است.

Net: بارگذاری و تجزیهٔ فایل‌های MSG

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

با استفاده از Aspose.Email for .NET، توسعه‌دهندگان می‌توانند محتویات فایل‌های پیام Outlook را بارگذاری و تجزیه کنند.

برای بارگذاری فایل‌های MSG از دیسک، از ایستای MapiMessage.Load متد از MapiMessage کلاس. این کلاس چندین تابع بارگذاری ایستا برای سناریوهای مختلف ارائه می‌دهد.
برای تجزیه محتویات فایل MSG، MapiMessage تعداد زیادی از متدها و ویژگی‌ها را افشا می‌کند.

در این مقاله خواهید آموخت چگونه یک فایل MSG را بارگذاری و تجزیه کنید تا محتوای آن را نمایش دهید. نمونه‌های کد همراه با گام‌ها درک واضحی از نحوه پیاده‌سازی عملکرد بارگذاری و تجزیه فایل‌های MSG Outlook در پروژه‌تان به شما می‌دهد.

ابتدا یاد بگیرید چگونه فایل‌های MSG را از فایل یا از استریم بارگذاری کنید.

بارگذاری فایل‌های MSG

قطعه کد زیر نشان می‌دهد چگونه فایل‌های MSG را بارگذاری کنید.

// Create an instance of MapiMessage from file
var msg = MapiMessage.Load(@"message.msg");

// Get subject
Console.WriteLine("Subject:" + msg.Subject);

// Get from address
Console.WriteLine("From:" + msg.SenderEmailAddress);

// Get body
Console.WriteLine("Body" + msg.Body);

// Get recipients information
Console.WriteLine("Recipient: " + msg.Recipients);

// Get attachments
foreach (var att in msg.Attachments)
{
    Console.Write("Attachment Name: " + att.FileName);
    Console.Write("Attachment Display Name: " + att.DisplayName);
}

مثال کد زیر نشان می‌دهد چگونه از MailMessage برای بارگذاری یک پیام در فرمت MSG استفاده کنید.


var eml = MailMessage.Load("message.msg");

شایان ذکر است که پیام حاصل به فرمت EML تبدیل می‌شود، از جمله پیوست‌های پیام توکار. از این روش بارگذاری استفاده نکنید اگر می‌خواهید برخی از ویژگی‌های خاص فرمت msg پیام اصلی را حفظ کنید.

برای حفظ فرمت اصلی پیوست‌های پیام توکار، از … استفاده کنید. msgLoadOptions.PreserveEmbeddedMessageFormat ویژگی.


var msgLoadOptions = new MsgLoadOptions();
msgLoadOptions.PreserveEmbeddedMessageFormat = true;
var msg = MailMessage.Load(stream, msgLoadOptions);

بارگذاری از استریم

قطعه کد زیر نشان می‌دهد چگونه فایل را از جریان (stream) بارگذاری کنید.

// Create an instance of MapiMessage from file
byte[] bytes = File.ReadAllBytes(@"message.msg");

using (MemoryStream stream = new MemoryStream(bytes))
{
    stream.Seek(0, SeekOrigin.Begin);
    // Create an instance of MapiMessage from file
    MapiMessage msg = MapiMessage.Load(stream);

    // Get subject
    Console.WriteLine("Subject:" + msg.Subject);

    // Get from address
    Console.WriteLine("From:" + msg.SenderEmailAddress);

    // Get body
    Console.WriteLine("Body" + msg.Body);

}

تبدیل EML به MSG در حالی که فرمت EML جاسازی‌شده حفظ می‌شود

فایل‌های EML می‌توانند به داخل … بارگذاری شوند MapiMessage کلاس با ایجاد یک MailMessage آبجکت و پاس دادن آن به MapiMessage.FromMailMessage متد. اگر فایل EML شامل فایل‌های EML توکار باشد، از … استفاده کنید. MapiConversionOptions.PreserveEmbeddedMessageFormat برای حفظ فرمت فایل‌های EML توکار. قطعه کد زیر نشان می‌دهد چگونه فایل‌های EML را به داخل … بارگذاری کرد. MapiMessage در حالی که فرمت فایل‌های EML توکار حفظ می‌شود.

// Load the EML file into a MailMessage object
var mailMessage = MailMessage.Load(emlFilePath);

// Set conversion options to preserve the format of embedded EML messages
var options = new MapiConversionOptions
    {
        PreserveEmbeddedMessageFormat = true
    };

// Convert MailMessage to MapiMessage, preserving embedded EML files
var mapiMessage = MapiMessage.FromMailMessage(mailMessage, options);

// Save the converted message in MSG format
mapiMessage.Save(msgFilePath);

امتحان کنید!

ایمیل‌ها و آرشیو پیام‌ها را به‌صورت آنلاین با رایگان برنامه تبدیل Aspose.Email.

تجزیه فایل‌های پیام Outlook

Aspose.Email for .NET فراهم می‌کند MapiMessage کلاسی که برای باز کردن و تجزیه یک فایل MSG استفاده می‌شود. از آنجایی که ممکن است گیرندگان زیادی در یک فایل MSG باشند، MapiMessage کلاس موارد زیر را در دسترس قرار می‌دهد گیرندگان ویژگی که یک مقدار برمی‌گرداند MapiRecipientCollection که نمایانگر یک مجموعه از MapiRecipient اشیاء. MapiRecipient این شیء متدهای بیشتری برای کار با ویژگی‌های گیرنده فراهم می‌کند.

دنباله گام‌های زیر برای این منظور استفاده می‌شود:

یک نمونه از MapiMessage کلاس با استفاده از MapiMessage.Load متد استاتیک.
نمایش نام فرستنده، موضوع و بدنه از فایل MSG با استفاده از SenderName, Subject و بدنه خواص.
از گیرندگان ویژگی برای دریافت مرجع به مجموعهٔ MapiRecipient اشیاء مرتبط با فایل MSG.
در حلقه بگردید در MapiRecipientCollection کلکسیونی برای نمایش محتویات برای هر MapiRecipient شیء از طریق متدهای عمومی آن.

//Instantiate an MSG file to load an MSG file from disk
var outlookMessageFile = MapiMessage.Load(dataDir + "message.msg");
//Display sender's name
Console.WriteLine("Sender Name : " + outlookMessageFile.SenderName);
//Display Subject
Console.WriteLine("Subject : " + outlookMessageFile.Subject);
//Display Body
Console.WriteLine("Body : " + outlookMessageFile.Body);
//Display Recipient's info
Console.WriteLine("Recipients : \n");

//Loop through the recipients collection associated with the MapiMessage object
foreach (var rcp in outlookMessageFile.Recipients)
{
	//Display recipient email address
	Console.WriteLine("Email : " + rcp.EmailAddress);
	//Display recipient name
	Console.WriteLine("Name : " + rcp.DisplayName);
	//Display recipient type
	Console.WriteLine("Recipient Type : " + rcp.RecipientType);
}

امتحان کنید!

فایل‌های ایمیل را به‌صورت آنلاین با رایگان Aspose.Email Parser App.

Net: مدیریت پیام‌های اوتلوک

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

ذخیره ایمیل‌ها به‌صورت HTML

Aspose.Email امکان ذخیره منابع ایمیل با مسیرهای نسبی را هنگام خروجی به فرمت HTML فراهم می‌کند. این ویژگی انعطاف‌پذیری بیشتری در نحوه ارجاع منابع در فایل HTML خروجی می‌دهد و به اشتراک‌گذاری و نمایش ایمیل‌های ذخیره‌شده در سیستم‌های مختلف را آسان می‌کند. برای ذخیره منابع با مسیرهای نسبی، از HtmlSaveOptions.UseRelativePathToResources property. مقدار پیش‌فرض این ویژگی false است (منابع با مسیرهای مطلق ذخیره می‌شوند). وقتی به true تنظیم شود، منابع با مسیرهای نسبی ذخیره می‌شوند.

فایل‌های HTML با مسیرهای نسبی قابل حمل‌تر هستند و می‌توانند در هر ساختار فایل میزبانی به‌درستی نمایش داده شوند. می‌توانید بین مسیرهای مطلق و نسبی بسته به نیازها انتخاب کنید. می‌توانید مسیرهای سفارشی برای منابع با استفاده از ویژگی تعریف کنید. مقدار پیش‌فرض این ویژگی false است (منابع با مسیرهای مطلق ذخیره می‌شوند). وقتی به true تنظیم شود، منابع با مسیرهای نسبی ذخیره می‌شوند. ResourceHtmlRendering رویداد.

نمونه کد زیر نشان می‌دهد چگونه یک ایمیل را با مسیر نسبی پیش‌فرض به منابع ذخیره کنید:

var msg = MapiMessage.Load(sourceFileName);

var htmlSaveOptions = new HtmlSaveOptions
{
    ResourceRenderingMode = ResourceRenderingMode.SaveToFile,
    UseRelativePathToResources = true
};

msg.Save(Path.Combine("target_files"), htmlSaveOptions);

در این حالت، منابع در پوشه [نام فایل html]_files، در همان مسیر فایل .html ذخیره می‌شوند و HTML منابع را از طریق مسیرهای نسبی ارجاع می‌دهد.

نمونه کد زیر نشان می‌دهد چگونه با مسیر مطلق به منابع ذخیره شود:

var msg = MapiMessage.Load(sourceFileName);

var htmlSaveOptions = new HtmlSaveOptions
{
    ResourceRenderingMode = ResourceRenderingMode.SaveToFile,
    UseRelativePathToResources = false
};

msg.Save(Path.Combine("target_files"), htmlSaveOptions);

همان‌طور که در مورد اول بوده، به‌طور پیش‌فرض منابع در پوشه [نام فایل html]_files ذخیره می‌شوند، اما HTML منابع را با مسیرهای مطلق ارجاع می‌دهد.

با استفاده از ResourceHtmlRendering رویداد، می‌توانید مسیرهای نسبی یا مطلق سفارشی برای منابع تنظیم کنید. هنگام سفارشی‌سازی مسیرها با ResourceHtmlRendering هندلر رویداد، و چون UseRelativePathToResources اگر روی true تنظیم شود، باید مسیر نسبی را به PathToResourceFile ویژگی برای اطمینان از ارجاع صحیح.

نمونه کد زیر نشان می‌دهد چگونه مسیر نسبی سفارشی با استفاده از رویداد ResourceHtmlRendering

var msg = MapiMessage.Load(sourceFileName);

var htmlSaveOptions = new HtmlSaveOptions
{
    ResourceRenderingMode = ResourceRenderingMode.SaveToFile,
    UseRelativePathToResources = true
};

htmlSaveOptions.ResourceHtmlRendering += (o, args) =>
{
    if (o is AttachmentBase attachment)
    {
	    // Since UseRelativePathToResources = true, you should assign a relative path to the PathToResourceFile property.
        args.PathToResourceFile = $@"images\{attachment.ContentType.Name}";
    }
};

msg.Save(Path.Combine(targetPath, "A Day in the Park.html"), htmlSaveOptions);

تبدیل MSG به پیام‌های MIME

API Aspose.Email امکان تبدیل فایل‌های MSG به پیام‌های MIME را با استفاده از ToMailMessage متد.

تنظیم زمان‌سنجی برای تبدیل و بارگذاری پیام

ویژگی‌های زیر به شما امکان می‌دهند زمان‌سنجی را به میلی‌ثانیه برای فرآیند تبدیل و بارگذاری تنظیم کنید:

MailConversionOptions.Timeout property- زمان را به میلی‌ثانیه هنگام تبدیل پیام محدود می‌کند.
MailConversionOptions.TimeoutReached - در صورتی که زمان هنگام تبدیل به MailMessage تمام شود، رخ می‌دهد.
MsgLoadOptions.Timeout - زمان را به میلی‌ثانیه در حین تبدیل پیام محدود می‌کند.
MsgLoadOptions.TimeoutReached - در صورتی که زمان هنگام تبدیل به MailMessage تمام شود، رخ می‌دهد.

نمونه کد زیر نشان می‌دهد چگونه در حین تبدیل یک پیام، زمان‌سنجی (timeout) را تنظیم کنید:

var options = new MailConversionOptions();
// Set the timeout to 5 seconds
options.Timeout = 5000;

options.TimeoutReached += (object sender, EventArgs args) =>
{
    string subj = (sender as MailMessage).Subject;
	 // Set a flag indicating the timeout was reached
    isTimedOut = true;
};

var mailMessage = mapiMessage.ToMailMessage(options);

تبدیل MSG به EML با حفظ بدنه RTF

تبدیل یک فایل MSG به EML با حفظ بدنه RTF می‌تواند به دو روش انجام شود:

با استفاده از MsgLoadOptions.PreserveRtfContent ویژگی MsgLoadOptions class;
با استفاده از MailConversionOptions.PreserveRtfContent ویژگی MailConversionOptions class;

هر دو ویژگی مقدار دریافت یا تعیین می‌کند که آیا بدنه rtf در MailMessage نگهداری شود یا نه.

قطعه کدهای زیر نشان می‌دهند چگونه یک فایل MSG را به EML تبدیل و بدنه RTF را حفظ کنید:

var loadOptions = new MsgLoadOptions
{
    PreserveRtfContent = true
};

var eml = MailMessage.Load("my.msg", loadOptions);

var conversionOptions = new MailConversionOptions
{
    PreserveRtfContent = true
};

var msg = MapiMessage.Load("my.msg");

var eml = msg.ToMailMessage(conversionOptions);

مدیریت فایل‌های قالب Outlook (.OFT)

قالب‌های Outlook وقتی می‌خواهید پیام ایمیلی مشابه را بارها ارسال کنید بسیار مفید هستند. به‌جای آماده‌سازی پیام از صفر هر بار، ابتدا پیام را در Outlook آماده کنید و به‌عنوان قالب Outlook (OFT) ذخیره کنید. پس از آن، هر زمان که نیاز به ارسال پیام داشتید، می‌توانید آن را از قالب ایجاد کنید و زمان نوشتن متن مشابه در بدنه یا موضوع، تنظیم قالب‌بندی و غیره را صرفه‌جویی کنید. Aspose.Email’s MailMessage کلاس می‌تواند برای بارگذاری و خواندن یک فایل قالب آوتلوک (OFT) استفاده شود. پس از بارگذاری قالب آوتلوک در یک نمونه از MailMessage کلاس، می‌توانید فرستنده، گیرنده، بدنه، موضوع و سایر ویژگی‌ها را به‌روزرسانی کنید. پس از به‌روزرسانی ویژگی‌ها:

ارسال ایمیل با استفاده از SmtpClient کلاس یا
ذخیره پیام به‌صورت MSG و انجام به‌روزرسانی‌ها/اعتبارسنجی‌های بیشتر با استفاده از Microsoft Outlook.

در نمونه‌های کد زیر، ما:

بارگذاری قالب با استفاده از MailMessage کلاس.
به‌روزرسانی برخی از ویژگی‌ها.
ذخیره پیام در قالب MSG.

قطعه کد زیر نشان می‌دهد چگونه فایل OFT را بارگذاری کنید، پیام را به‌روز کنید و در قالب MSG ذخیره کنید.

ذخیره فایل‌های MSG به‌عنوان قالب‌ها

قطعه کد زیر نشان می‌دهد چگونه فایل MSG آوتلوک را به‌عنوان قالب ذخیره کنید.

تعیین نوع پیام MAPI (OFT یا MSG)

هنگام بارگذاری یک شیء MapiMessage از فایل، ممکن است نیاز داشته باشید تعیین کنید آیا پیام بارگذاری شده یک فایل الگو است یا یک ایمیل عادی. با استفاده از IsTemplate ویژگی MapiMessage کلاس، می‌توانید به‌دقت تشخیص دهید آیا ایمیل یک الگو است یا خیر. این قابلیت هنگام پردازش انواع مختلف فایل‌های ایمیل در برنامه‌ها و سیستم‌ها مفید است.

مثال کد زیر نشان می‌دهد چگونه تعیین کنیم آیا MapiMessage به صورت OFT است یا MSG:

var msg = MapiMessage.Load("message.msg");
var isOft = msg.IsTemplate; // returns false

var msg = MapiMessage.Load("message.oft");
var isOft = msg.IsTemplate; // returns true

ذخیره MapiMessage یا MailMessage در قالب OFT

این SaveOptions کلاس امکان تعیین گزینه‌های اضافی هنگام ذخیره MailMessage یا MapiMessage در قالب خاصی را فراهم می‌کند.

نمونه کد زیر نشان می‌دهد چگونه یک پیام را به قالب OFT ذخیره کنید:

// Save the MailMessage to OFT format
using (var eml = MailMessage.Load("message.eml"))
{
    eml.Save("message.oft", SaveOptions.DefaultOft);
	
	// or alternative way #2
	var saveOptions = new MsgSaveOptions(MailMessageSaveType.OutlookTemplateFormat);
    eml.Save("message.oft", saveOptions);
	
	// or alternative  way #3
	saveOptions = SaveOptions.CreateSaveOptions(MailMessageSaveType.OutlookTemplateFormat);
    eml.Save("message.oft", saveOptions);

}

// Save the MapiMessage to OFT format
using (var msg = MapiMessage.Load("message.msg"))
{
    msg.Save("message.oft", SaveOptions.DefaultOft);
	
	// or alternative way #2
	var saveOptions = new MsgSaveOptions(MailMessageSaveType.OutlookTemplateFormat);
    msg.Save("message.oft", saveOptions);
	
	// or alternative  way #3
	saveOptions = SaveOptions.CreateSaveOptions(MailMessageSaveType.OutlookTemplateFormat);
    msg.Save("message.oft", saveOptions);
}

مدیریت پیام‌های امضاشده دیجیتالی

Aspose.Email الگوریتم کامل شیء ایمیل S/MIME را پیاده‌سازی می‌کند. این به API قدرت کامل برای حفظ امضاهای دیجیتال هنگام تبدیل پیام‌ها بین فرمت‌ها می‌دهد.

حفظ امضا در هنگام تبدیل EML به MSG

Aspose.Email امضای دیجیتال را هنگام تبدیل از EML به MSG حفظ می‌کند. قطعه کد زیر نشان می‌دهد چگونه از EML به MSG تبدیل کنید.

تبدیل پیام‌های S/MIME از MSG به EML

Aspose.Email امضای دیجیتال را هنگام تبدیل از MSG به EML حفظ می‌کند همان‌طور که در قطعه کد زیر نشان داده شده است.

بررسی امضاهای ایمیل‌های امن

ویژگی‌های زیر برای بررسی امضای اشیاء MapiMessage موجود هستند.

SecureEmailManager کلاس برای بررسی امضای ایمیل‌های امن.
SmimeResult کلاس برای ذخیره نتایج بررسی.
SecureEmailManager.CheckSignature(MapiMessage msg) متد.
SecureEmailManager.CheckSignature(MapiMessage msg, X509Certificate2 certificateForDecrypt) متد.
SecureEmailManager.CheckSignature(MapiMessage msg, X509Certificate2 certificateForDecrypt, X509Store store) متد.

نمونه کد زیر نشان می‌دهد چگونه ویژگی‌ها را در پروژه خود پیاده‌سازی کنید:

var msg = MapiMessage.Load(fileName, new EmlLoadOptions());
var result = new SecureEmailManager().CheckSignature(msg);

var certFileName = "cert.pfx";
var cert = new X509Certificate2(certFileName, "pass");
var eml = MapiMessage.Load(fileName);
var store = new X509Store();
store.Open(OpenFlags.ReadWrite);
store.Add(cert);
store.Close();

var result = new SecureEmailManager().CheckSignature(eml, cert, store);

حذف امضاها از MapiMessage‌ها

برای سازگاری بهتر، MapiMessage.RemoveSignature متد و MapiMessage.IsSigned دارای ویژگی‌ها برای حذف امضای دیجیتالی از یک پیام استفاده می‌شوند.

قطعه کد زیر نشان می‌دهد چگونه این ویژگی‌ها را در پروژه خود پیاده‌سازی کنید:

var msg = MapiMessage.Load(fileName);

if (msg.IsSigned)
{
    var unsignedMsg = msg.RemoveSignature();
}

رمزگشایی MapiMessage‌ها با گواهی‌نامه‌ها

اگر پیام‌های MAPI رمزگذاری شده دارید و نیاز به رمزگشایی آن‌ها با کلید خصوصی ذخیره‌شده در یک گواهی‌نامه دارید، ویژگی‌های زیر Aspose.Email می‌توانند مفید باشند:

MapiMessage.IsEncrypted - مقدار نشان‌دهنده این که آیا پیام رمزنگاری شده است یا خیر را برمی‌گرداند.
MapiMessage.Decrypt() - این پیام را رمزگشایی می‌کند (متد جستجوی گواهی‌نامه و کلید خصوصی مناسب در مخازن My کاربر و کامپیوتر جاری).
MapiMessage.Decrypt(X509Certificate2 certificate) - این پیام را با گواهی‌نامه رمزگشایی می‌کند.

قطعه کد زیر نشان می‌دهد چگونه با پیام‌های MAPI رمزگذاری شده کار کنید:

var privateCert = new X509Certificate2(privateCertFile, "password");
var msg = MapiMessage.Load("encrypted.msg");

if (msg.IsEncrypted);
{
    var decryptedMsg = msg.Decrypt(privateCert);
}

تنظیم دسته‌بندی‌های رنگی برای فایل‌های MSG

یک دسته رنگی یک پیام ایمیل را برای نوعی اهمیت یا دسته‌بندی علامت‌گذاری می‌کند. Microsoft Outlook به کاربران اجازه می‌دهد تا دسته‌های رنگی را برای تمایز ایمیل‌ها اختصاص دهند. برای مدیریت دسته رنگی، از FollowUpManager. شامل توابعی مانند AddCategory, RemoveCategory, ClearCategories و GetCategories.

AddCategory می‌گیرد MapiMessage و رشته دسته رنگی، برای مثال "دسته بنفش" یا "دسته قرمز" به عنوان آرگومان.
RemoveCategory می‌گیرد MapiMessage و رشته دسته رنگی که باید از پیام حذف شود.
ClearCategories برای حذف تمام دسته‌های رنگی از پیام استفاده می‌شود.
GetCategories برای بازیابی تمام دسته‌های رنگی از یک پیام خاص استفاده می‌شود.

مثال زیر کارهای زیر را انجام می‌دهد:

اضافه کردن یک دسته رنگی.
اضافه کردن یک دسته رنگی دیگر.
دریافت لیست تمام دسته‌ها.
حذف تمام دسته‌ها.

دسترسی به اطلاعات پیگیری در فایل‌های MSG

API Aspose.Email امکان دسترسی به اطلاعات پیگیری را از پیام ارسال‌شده یا دریافت‌شده فراهم می‌کند. می‌تواند اطلاعات دریافت، دریافت تحویل و نتایج نظرسنجی را از یک فایل پیام بازیابی کند.

دریافت اطلاعات دریافت خواندن و تحویل

قطعه کد زیر نشان می‌دهد چگونه اطلاعات دریافت و تحویل رسیدها را بازیابی کنید.

ایجاد پیام‌های فوروارد و پاسخ

API Aspose.Email امکان ایجاد و قالب‌بندی پیام‌های فوروارد و پاسخ را فراهم می‌کند. ReplyMessageBuilder و ForwardMessageBuilder کلاس‌های این API به‌صورت جداگانه برای ایجاد پیام‌های Reply و Forward استفاده می‌شوند. یک پیام Reply یا Forward می‌تواند با استفاده از هر یک از حالت‌های OriginalMessageAdditionMode enum. این enum مقادیر زیر را دارد:

OriginalMessageAdditionMode.None - پیام اصلی در پیام پاسخ گنجانده نشده است.
OriginalMessageAdditionMode.Attachment - پیام اصلی به‌عنوان پیوست در پیام پاسخ گنجانده می‌شود
OriginalMessageAdditionMode.Textpart - پیام اصلی به‌صورت متن در بدنه پیام پاسخ گنجانده می‌شود

ایجاد پیام‌های پاسخ

قطعه کد زیر نشان می‌دهد چطور یک پیام پاسخ ایجاد کنید.

ایجاد پیام‌های فوروارد

کد زیر نشان می‌دهد چگونه یک پیام Forward ایجاد کنید.

Net: استفاده از کنترل Aspose Outlook برای کشیدن و رها کردن پیام‌های Outlook به فرم‌های ویندوز

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

Aspose.Email از ویژگی کشیدن و رها کردن در Microsoft Outlook پشتیبانی می‌کند. این امکان به توسعه‌دهندگان اجازه می‌دهد به‌سادگی عناصر UI بسازند که به رویدادهای کشیدن‑رهاییدن Outlook واکنش نشان دهند. نمونه زیر نشان می‌دهد چگونه یک پنل ایجاد کنید که کاربر بتواند پیام را از Outlook بکشاند و رها کند و برنامه پیام‌ها را به فایل‌های MSG ذخیره کند. قطعه کد زیر نشان می‌دهد چگونه یک کنترل Outlook Aspose راه‌اندازی کنید که بتواند پیام‌های Microsoft Outlook رها‑شده را دریافت کند.

یک برنامه Windows Form ایجاد کنید.
یک ارجاع به اسمبلی Aspose.Email اضافه کنید.
به فایل Aspose.Email.dll بروید و OK را کلیک کنید.

عنصر UI ایجاد شده در این نمونه یک پنل است. برای ایجاد یک پنل:

روی پروژهٔ خود در پنل راه‌حل کلیک راست کنید و سپس Add و بعد New item را از منو انتخاب کنید.
یک کلاس به نام MyPanel ایجاد کنید:
اجازه دهید MyPanel زیرکلاس System.Windows.Form.Panel باشد و یک ویژگی Aspose.Email.Windows.Forms.FileDropTargetManager به MyPanel اضافه کنید:

متدهای OnHandleCreated و OnHandleDestroyed را بازنویسی کنید تا MyPanel را با استفاده از Aspose.Email.Windows.Forms.FileDropTargetManager ثبت کنید:

پروژه را بسازید.

MyPanel آماده استفاده است. این پنل رویدادهای کشیدن‑رها کردن از Outlook را می‌پذیرد.

پنل جعبه‌ابزار خود را باز کنید و MyPanel را به فرم ویندوزی خود بکشید:

یک مدیریت‌گر رویداد به رویداد DragDrop خود MyPanel اضافه کنید. (فراموش نکنید ویژگی AllowDrop را از پنل خواص به true تنظیم کنید و رنگ پس‌زمینه MyPanel را به دلخواه خود تغییر دهید.)

خط زیر را در متد InitializeComponent() فرم اصلی اضافه کنید:

مدیریت‌گر رویداد DragDrop را پیاده‌سازی کنید تا پیام‌های کشیده‌شده از Outlook را در فایل‌های MSG ذخیره کنید.
DragEventArgs را به Aspose.Email.Windows.Forms.FileDragEventArgs تبدیل کنید که شامل یک آرایهٔ Files است که هدف کشیدن کاربر را نشان می‌دهد.

اگر کاربر چندین پیام را از Outlook بکشاند و بر روی MyPanel رها کند، مقدار Files.Count تعداد پیام‌هاست و برای هر پیام Files i تکرار می‌شود.

پروژه را اجرا کنید و تست کنید.

حالا می‌توانید پیام‌ها را از Outlook بکشید و در برنامهٔ خود رها کنید. برنامه از شما می‌خواهد تا این پیام‌ها را به فایل‌های MSG ذخیره کنید.

Net: کار با گزینه‌های رأی‌گیری و واکنش‌ها در MSG

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

ایجاد گزینه‌های رأی‌گیری با MapiMessage

Microsoft Outlook ویژگی ایجاد نظرسنجی هنگام نوشتن یک ایمیل جدید را فراهم می‌کند، که به کاربران امکان افزودن گزینه‌های رأی‌گیری مانند بله، خیر، شاید و غیره را می‌دهد. Aspose.Email عملکرد مشابهی را هنگام ایجاد پیام Outlook به‌صورت برنامه‌نویسی فراهم می‌کند. The FollowUpOptions کلاس فراهم می‌کند VotingButtons ویژگی‌ای که می‌توان برای تنظیم یا دریافت گزینه‌های رأی‌گیری استفاده کرد. MapiMessage به کلاسی در فضای نام Aspose.Email اشاره دارد که نمایانگر یک پیام ایمیل در قالب رابط برنامه‌نویسی پیام‌رسان (MAPI) است که معمولاً توسط Microsoft Outlook استفاده می‌شود. با استفاده از کلاس MapiMessage، توسعه‌دهندگان می‌توانند دکمه‌های نظرسنجی را به ایمیل اضافه کنند. این مقاله یک مثال دقیق از نحوه ایجاد یک MapiMessage با گزینه‌های رأی‌گیری برای ساخت نظرسنجی ارائه می‌دهد.

ایجاد نظرسنجی‌ها

کد نمونه زیر نحوه ایجاد یک نظرسنجی در پیام Outlook با استفاده از Aspose.Email را نشان می‌دهد. FollowUpManager کلاس امکان تنظیم گزینه‌های رأی‌گیری را فراهم می‌کند.

// Create a MapiMessage with the sender, recipient, subject, and body
var msg = new MapiMessage(
    "from@test.com",
    "to@test.com",
    "Flagged message",
    "Make it nice and short, but descriptive. The description may appear in search engines' search results pages..."
);

// Create FollowUpOptions and set the voting buttons
var options = new FollowUpOptions
{
    VotingButtons = "Yes;No;Maybe;Exactly!"
};

// Apply the follow-up options to the message
FollowUpManager.SetOptions(msg, options);

FollowUpOptions: ویژگی‌هایی را برای پیکربندی اقدامات پیگیری مانند دکمه‌های رأی‌گیری فراهم می‌کند.
VotingButtons: ویژگی رشته‌ای که در آن گزینه‌های مختلف رأی‌گیری با نقطه‌ویرگول جدا شده‌اند.
FollowUpManager.SetOptions: گزینه‌های پیگیری مشخص‌شده را بر پیام اعمال می‌کند.

خواندن گزینه‌های رأی‌گیری

برای بازیابی گزینه‌های رأی‌گیری از یک MapiMessage، می‌توانید استفاده کنید GetOptions متد. این متد نه تنها دکمه‌های رأی‌گیری را بازیابی می‌کند بلکه می‌تواند پارامترهای اضافی مانند دسته‌بندی‌ها را در صورت نیاز ارائه دهد.

// Retrieve follow-up options from the message
var options = FollowUpManager.GetOptions(msg);

// Voting buttons are returned as a string with a semicolon separator
string votingButtons = options.VotingButtons;

// Display the voting buttons
Console.WriteLine($"Voting Options: {votingButtons}");

GetOptions: مقدار FollowUpOptions شیء‌ای از پیام که شامل دکمه‌های رأی‌گیری و احتمالاً سایر ویژگی‌ها می‌شود.
VotingButtons: گزینه‌ها به‌صورت رشته‌ای جدا شده با نقطه‌ویرگول استخراج می‌شوند که نمایش یا دستکاری آسان را فراهم می‌کند.

خواندن دکمه‌های رأی‌گیری

اگر فقط نیاز دارید به دکمه‌های رأی‌گیری به‌عنوان لیستی از رشته‌های جداگانه دسترسی پیدا کنید، می‌توانید از GetVotingButtons متد که آنها را به‌صورت مجموعه برمی‌گرداند.

// Read only voting buttons as a collection of string values
var votingButtons = FollowUpManager.GetVotingButtons(msg);

// Display each voting button
foreach (var button in votingButtons)
{
    Console.WriteLine($"Voting Button: {button}");
}

GetVotingButtons: مجموعه‌ای از رشته‌های دکمهٔ رأی‌گیری را برمی‌گرداند که گردش در آنها و انجام عملیات مانند نمایش یا تغییر آسان است.

افزودن دکمه‌های رأی‌گیری

شما می‌توانید دکمه‌های رأی‌گیری اضافی را به یک پیام موجود اضافه کنید با استفاده از AddVotingButton متد. این می‌تواند برای به‌روزرسانی پویا گزینه‌های رأی‌گیری مفید باشد.

// Add a new voting button to the existing message
FollowUpManager.AddVotingButton(msg, "Indeed!");

AddVotingButton: گزینهٔ رأی‌گیری جدیدی به دکمه‌های رأی‌گیری موجود پیام اضافه می‌کند و امکان سفارشی‌سازی پویا نظرسنجی‌ها را فراهم می‌آورد.

حذف دکمه‌های رأی‌گیری

ممکن است بخواهید دکمه‌های رأی‌گیری خاصی را حذف کنید یا تمام دکمه‌ها را از یک پیام پاک کنید. کد زیر هر دو عمل را با استفاده از RemoveVotingButton و ClearVotingButtons متدها.

// Delete a specific voting button
FollowUpManager.RemoveVotingButton(msg, "Exactly!");

// Or delete all voting buttons from the MapiMessage
FollowUpManager.ClearVotingButtons(msg);

RemoveVotingButton: دکمه رأی‌گیری خاصی را بر اساس نام حذف می‌کند.
ClearVotingButtons: تمام دکمه‌های رأی‌گیری را حذف می‌کند و به‌صورت مؤثر گزینه‌های رأی‌گیری را بازنشانی می‌نماید.

خواندن نتایج رأی‌گیری

Aspose.Email همچنین امکان خواندن نتایج رأی‌گیری از گیرندگان پیام را می‌دهد. می‌توانید به ویژگی‌هایی مانند پاسخ گیرنده و زمان پاسخ دسترسی داشته باشید.

// Load a MapiMessage from a file
var msg = MapiMessage.Load("sample.msg");

// Iterate through each recipient and display their vote information
foreach (var recipient in msg.Recipients)
{
    Console.WriteLine($"Recipient: {recipient.DisplayName}");

    // Get the recipient's response using the appropriate MapiPropertyTag
    var response = recipient.Properties[MapiPropertyTag.PR_RECIPIENT_AUTORESPONSE_PROP_RESPONSE].GetString();
    Console.WriteLine($"Response: {response}");

    // Get the response time
    var responseTime = recipient.Properties[MapiPropertyTag.PR_RECIPIENT_TRACKSTATUS_TIME].GetDateTime();
    Console.WriteLine($"Response time: {responseTime}\n");
}

MapiRecipient: نمایندهٔ یک گیرنده در MapiMessage، که دسترسی به داده‌های پاسخ فردی را فراهم می‌کند.
*PR_RECIPIENT_AUTORESPONSE_PROP_RESPONSE: برچسب ویژگی که پاسخ رأی گیرنده را ذخیره می‌کند.
PR_RECIPIENT_TRACKSTATUS_TIME: برچسب ویژگی که زمان پاسخ گیرنده را ثبت می‌کند.

دریافت اطلاعات واکنش از MSG

این GetReactions متد از FollowUpManager کلاس به شما امکان می‌دهد فهرستی از واکنش‌ها بر روی یک پیام MAPI بازیابی کنید، که تحلیل تعامل کاربران را آسان می‌سازد. نمونه کد زیر نشان می‌دهد چگونه واکنش‌های موجود برای یک پیام مشخص را دریافت کنید و بینشی درباره تعاملات کاربر فراهم می‌آورد:

// Load the message file
var msg = MapiMessage.Load(fileName);

// Retrieve the list of reactions on the message
var reactions = FollowUpManager.GetReactions(msg);

// Iterate through each reaction and output the details to the console
foreach (var reaction in reactions)
{
    Console.WriteLine($"User: {reaction.Name}, Email: {reaction.Email}, Reaction: {reaction.Type}, Date: {reaction.ReactionDateTime}");
}

Net: مدیریت پیگیری و تاریخ‌های سررسید برای فایل‌های MSG در Outlook

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

تنظیم پیگیری و تاریخ‌های سررسید برای فایل‌های MSG

یک پرچم پیگیری یک پیام ایمیل را برای انجام عملی مشخص می‌کند. Microsoft Outlook به کاربران اجازه می‌دهد پیام‌ها را پرچم‌گذاری کنند و در تنظیم پرچم، تاریخ سررسید برای پیگیری را تعیین کنند. Microsoft Outlook یک یادآوری به دریافت‌کننده می‌فرستد تا او را به پیگیری ایمیل تشویق کند. پرچم‌گذاری ایمیل‌ها و تنظیم تاریخ سررسید به‌صورت برنامه‌نویسی به توسعه‌دهندگان نرم‌افزار امکان می‌دهد ایمیل‌های خاصی را خودکار کنند و به دریافت‌کنندگان کمک کنند تا عمل موردنظر را به یاد داشته باشند. برای مثال، می‌توان از آن برای ارسال پیام‌های ماهانه به تیم فروش برای یادآوری تکمیل گزارش‌ها استفاده کرد؛ یا برای ارسال پیامی به تمام کارکنان جهت یادآوری جلسه شرکت. Aspose.Email برای .NET از تنظیم پرچم پیگیری و تاریخ سررسید برای MapiMessage اشیاء با استفاده از FollowUpManager و FollowUpOptions. چندین نوع مختلف برای تنظیم پرچم پیگیری بر روی یک پیام وجود دارد. همه آن‌ها در نمونه کد زیر استفاده شده‌اند:

تنظیم پرچم پیگیری برای پیام
افزودن تاریخ سررسید و تاریخ یادآوری به پیام
افزودن پرچم به پیام گیرنده.
علامت‌گذاری به‌عنوان تکمیل‌شده.
حذف پرچم.
خواندن گزینه‌های پیگیری.

تنظیم پرچم‌های پیگیری

قطعه کد زیر نشان می‌دهد چطور یک پرچم پیگیری تنظیم کنید.

تنظیم پیگیری برای گیرندگان

قطعه کد زیر نشان می‌دهد چطور پیگیری را برای گیرندگان تنظیم کنید.

علامت‌گذاری پرچم‌های پیگیری به‌عنوان تکمیل‌شده

قطعه کد زیر نشان می‌دهد چطور پرچم پیگیری را به عنوان تکمیل شده علامت‌گذاری کنید.

حذف پرچم‌های پیگیری

قطعه کد زیر نشان می‌دهد چطور پرچم پیگیری را حذف کنید.

خواندن گزینه‌های پرچم پیگیری

قطعه کد زیر نشان می‌دهد چطور گزینه‌های پرچم پیگیری را برای یک پیام بخوانید.

Net: کار با ویژگی‌های MAPI

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

دسترسی و تنظیم ویژگی MAPI در Outlook

این MapiProperty کلاس نمایانگر یک ویژگی MAPI است که شامل:

Name: رشته‌ای که ویژگی نام را نشان می‌دهد.
Tag: مقدار از نوع long که برچسب ویژگی را نشان می‌دهد.
Data: آرایه بایتی که ویژگی داده را نشان می‌دهد.

دریافت ویژگی‌های MAPI با استفاده از برچسب‌های ویژگی

برای دریافت ویژگی‌های MAPI:

یک نمونه از MapiMessage توسط بارگذاری از فایل‌ها یا جریان.
دریافت MapiProperty از MapiMessage.Properties توسط MapiPropertyTag کلیدها.

قطعه کد زیر نشان می‌دهد چگونه ویژگی MAPI را با استفاده از برچسب ویژگی MAPI دریافت کنید.

تنظیم ویژگی‌های MAPI

قطعه کد زیر نشان می‌دهد چگونه ویژگی‌های MAPI را تنظیم کنید.

که در آن تعریف متد convertDateTime به صورت زیر است:

ویژگی‌های افزوده

قطعه کد زیر نشان می‌دهد چگونه ویژگی‌های اضافی MAPI را تنظیم کنید.

خواندن ویژگی‌های MAPI نام‌گذاری شده از فایل‌های MSG

قطعه کد زیر نشان می‌دهد چگونه ویژگی‌های نام‌گذاری شده MAPI را از فایل MSG بخوانید.

خواندن ویژگی‌های MAPI نام‌گذاری شده از پیوست‌ها

Aspose.Email همچنین به شما امکان می‌دهد از طریق ویژگی‌های یک MapiAttachment و جستجوی یک ویژگی نام‌دار، به طریقی مشابه مثال بالا، برای MapiMessage. قطعه کد زیر نشان می‌دهد چگونه یک ویژگی نام‌دار را از طریق مجموعه ویژگی‌های پیوست جستجو کنید.

حذف ویژگی‌ها از MSGها و پیوست‌ها

قطعه کد زیر نشان می‌دهد چگونه ویژگی‌ها را از MSGها و پیوست‌ها حذف کنید.

Net: مدیریت پیوست‌های پیام

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

مدیریت پیوست‌ها در Outlook

ایجاد و ذخیره فایل‌های پیام Outlook (MSG) نحوه ایجاد و ذخیره پیام‌ها و چگونگی ساخت فایل‌های MSG با پیوست‌ها را توضیح می‌دهد. این مقاله نحوه مدیریت پیوست‌های Microsoft Outlook با Aspose.Email را شرح می‌دهد. پیوست‌های یک فایل پیام با استفاده از به دیسک دسترسی پیدا کرده و ذخیره می‌شوند MapiMessage کلاس پیوست‌ها ویژگی. این پیوست‌ها ویژگی یک مجموعه از نوع است MapiAttachmentCollection کلاس.

بررسی نوع پیوست (درون‌خطی یا عادی)

پیوست‌های درون‌خطی و عادی اهداف متفاوتی دارند. پیوست‌های درون‌خطی به صورت بصری در پیام ایمیل یکپارچه می‌شوند و معمولاً تصاویر یا فایل‌های رسانه‌ای هستند. در حالی که پیوست‌های عادی فایل‌های جداگانه‌ای هستند که به ایمیل پیوست می‌شوند و می‌توانند انواع مختلفی از فایل‌ها را شامل شوند. The MapiAttachment.IsInline ویژگی MapiAttachment کلاس مقداری را دریافت می‌کند که نشان می‌دهد پیوست به‌صورت inline است یا معمولی.

نمونه کد زیر اطلاعات هر پیوست در MapiMessage بارگذاری شده را استخراج و نمایش می‌دهد، از جمله نام‌های نمایشی آنها و اینکه آیا پیوست‌های درون‌خطی هستند یا خیر.

var message = MapiMessage.Load(fileName);

foreach (var attach in message.Attachments)
{
    Console.WriteLine($"{attach.DisplayName0} : {attach.IsInline)}");
}

بررسی نوع پیوست (IsReference)

این MapiAttachment کلاس شامل IsReference ویژگیتی که به توسعه‌دهندگان امکان شناسایی پیوست‌های مرجع در یک پیام را می‌دهد. با نمونه کد زیر، می‌توانید بررسی کنید که آیا یک پیوست، پیوست مرجع است یا خیر:

foreach (var attachment in msg.Attachments)
{
    if (attachment.IsReference)
    {
        // Process reference attachment
    }
}

ذخیره پیوست‌ها از فایل‌های MSG

برای ذخیره پیوست‌ها از یک فایل MSG:

درون MapiAttachmentCollection مجموعه را فراخوانی کنید و پیوست‌های جداگانه را دریافت کنید.
برای ذخیره پیوست‌ها، متد Save() کلاس MapiAttachment را فراخوانی کنید.

قطعه کد زیر نشان می‌دهد که چگونه پیوست‌ها را در دیسک محلی ذخیره کنید.

استخراج پیوست‌ها از فایل‌های MSG با فرمت RTF

برای پیام‌هایی که به صورت RTF قالب‌بندی شده‌اند، می‌توان از کد زیر برای تمایز و استخراج پیوست‌هایی که یا درون‌خطی هستند یا به‌صورت آیکن در بدنه پیام ظاهر می‌شوند استفاده کرد. قطعه کد زیر نشان می‌دهد چگونه یک پیوست جاسازی‌شده را از MSG فرمت RTF شناسایی و استخراج کنید.


var eml = MapiMessage.Load("MSG file with RTF Formatting.msg");

foreach (var attachment in eml.Attachments)
{
    if (IsAttachmentInline(attachment))
    {
        try
        {
            SaveAttachment(attachment, Data.Out/new Guid().ToString());
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
    }
}

static bool IsAttachmentInline(MapiAttachment attachment)
{
    foreach (var property in attachment.ObjectData.Properties.Values)
    {
        if (property.Name == "\x0003ObjInfo")
        {
            var odtPersist1 = BitConverter.ToUInt16(property.Data, 0);
            return (odtPersist1 & (1 << (7 - 1))) == 0;
        }
    }
    return false;
}

static void SaveAttachment(MapiAttachment attachment, string fileName)
{
    foreach (var property in attachment.ObjectData.Properties.Values)
    {
        if (property.Name == "Package")
        {
            using var fs = new FileStream(fileName, FileMode.Create, FileAccess.Write);
            fs.Write(property.Data, 0, property.Data.Length);
        }
    }
}

دریافت پیوست‌های پیام ایمیل تو در تو

پیوست‌های OLE جاسازی‌شده نیز در MapiMessage کلاس مجموعهٔ Attachment. مثال کد زیر یک فایل پیام را برای پیوست‌های پیام درون‌ریزی‌شده تجزیه می‌کند و آن را بر روی دیسک ذخیره می‌نماید. The MapiMessage متد ایستا FromProperties() کلاس می‌تواند پیام جدیدی از پیوست درون‌ریزی‌شده ایجاد کند. قطعه کد زیر نشان می‌دهد که چگونه پیوست‌های پیام ایمیل تو در تو را دریافت کنید.

حذف پیوست‌ها

کتابخانه Aspose Outlook امکان حذف پیوست‌ها از فایل‌های پیام Microsoft Outlook (.msg) را فراهم می‌کند:

متد RemoveAttachments() را فراخوانی کنید. این متد مسیر فایل پیام را به‌ عنوان پارامتر می‌گیرد. به عنوان یک متد عمومی استاتیک پیاده‌سازی شده است، بنابراین نیازی به ساخت نمونه شیء ندارید.

قطعه کد زیر نشان می‌دهد چگونه پیوست‌ها را حذف کنید.

شما می‌توانید MapiMessage متد ایستای کلاس DestroyAttachment(). این روش سریع‌تر از RemoveAttachment() عمل می‌کند، زیرا متد RemoveAttachment() فایل پیام را تجزیه می‌کند.

افزودن پیوست‌های MSG

یک پیام Outlook می‌تواند پیام‌های دیگر Microsoft Outlook را به‌عنوان پیوست، چه به‌صورت عادی و چه به‌صورت جاسازی‌شده، شامل شود. The MapiAttachmentCollection متدهای overload شدهٔ متد Add را فراهم می‌کند تا پیام‌های Outlook را با هر دو نوع پیوست ایجاد کند.

امتحان کنید!

پیوست‌های ایمیل را با نسخهٔ رایگان اضافه یا حذف کنید Aspose.Email Editor App.

افزودن پیوست‌های مرجع به MapiMessages

این ReferenceAttachmentOptions کلاس افزودن پیوست‌های مرجع را با جمع‌آوری تمام ویژگی‌های لازم در یک شیء ساده می‌کند.

پارامترهای ReferenceAttachmentOptions:

sharedLink: لینک به‌طور کامل مشخص‌شدهٔ اشتراکی به پیوست که توسط سرویس وب میزبانی فایل ارائه می‌شود.
url: مکان فایل یا URL منبع.
providerName: نام ارائه‌دهندهٔ پیوست مرجع (مثلاً Google Drive, Dropbox).
مثال: افزودن پیوست مرجع با ReferenceAttachmentOptions

var options = new ReferenceAttachmentOptions(
    "https://drive.google.com/file/d/1HJ-M3F2qq1oRrTZ2GZhUdErJNy2CT3DF/",
    "https://drive.google.com/drive/my-drive",
    "GoogleDrive");

// Add reference attachment
msg.Attachments.Add("Document.pdf", options);

جاسازی پیام‌ها به‌عنوان پیوست

قطعه کد زیر نشان می‌دهد چگونه یک پیوست فایل MSG را به یک پیام جاسازی کنید.

خواندن پیام‌های توکار از پیوست‌ها

قطعه کد زیر نشان می‌دهد چگونه پیام‌های توکار را از پیوست‌ها بخوانید.

درج و جایگزینی پیوست

API Aspose.Email امکان درج پیوست‌ها در ایندکس خاص داخل پیام والد را فراهم می‌کند. همچنین امکان جایگزینی محتوای یک پیوست با پیوست پیام دیگری را فراهم می‌آورد.

امتحان کنید!

اجرای ReplaceAttach پروژهٔ برنامهٔ ساده‌ای ایجاد کنید و قابلیت‌های Aspose.Email را برای جایگزینی پیوست‌ها در عمل امتحان کنید.

درج پیوست‌ها در مکان‌های خاص

API Aspose.Email امکان درج یک پیوست MSG به یک MSG والد را با استفاده از متد Insert از MapiAttachmentCollection فراهم می‌کند: MapiAttachmentCollection Insert(int index, string name, MapiMessage msg). قطعه کد زیر نشان می‌دهد چگونه یک پیوست را در مکان خاصی وارد کنید.

جایگزین کردن محتوای پیوست

این می‌تواند برای جایگزینی محتوای پیوست‌های توکار با موارد جدید با استفاده از متد Replace مورد استفاده قرار گیرد. اما نمی‌توان از آن برای افزودن پیوست با PR_ATTACH_NUM = 4 (به عنوان مثال) در مجموعه‌ای که تعداد آن 2 باشد استفاده کرد. قطعه کد زیر نشان می‌دهد چگونه محتوای پیوست را جایگزین کنید.

تغییر نام پیوست‌ها در MapiMessage

امکان ویرایش مقدار ویژگی DisplayName در پیوست‌های MapiMessage وجود دارد.

var msg = MapiMessage.Load(fileName);
msg.Attachments[0].DisplayName = "New display name 1";
msg.Attachments[1].DisplayName = "New display name 2";

ذخیره پیوست‌ها از پیام‌های امضا دیجیتال

API Aspose.Email امکان دریافت یا تنظیم مقداری را فراهم می‌کند که نشان می‌دهد آیا پیام با امضای واضح رمزگشایی خواهد شد یا نه.

Net: مدیریت مخاطبین Outlook

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

مانند MapiMessage، Aspose.Email به شما امکان می‌دهد مخاطبین Outlook را ایجاد کنید. MapiContact کلاس تمام ویژگی‌های مرتبط با مخاطب مورد نیاز برای ایجاد یک مخاطب Outlook را فراهم می‌کند. این مقاله نشان می‌دهد چگونه یک مخاطب Outlook را ایجاد، ذخیره و خوانده شود با استفاده از MapiContact کلاس.

ایجاد و ذخیره مخاطب Outlook

برای ایجاد یک مخاطب و ذخیره آن بر روی دیسک:

یک شیء جدید از MapiContact کلاس.
اطلاعات خصوصیات مخاطب را وارد کنید.
داده‌های عکس را اضافه کنید (در صورت وجود).
مخاطب را به صورت فرمت MSG یا VCard ذخیره کنید.

قطعه کد زیر نشان می‌دهد چگونه یک مخاطب Outlook ایجاد و ذخیره کنید.

ذخیره لیست‌های توزیع MAPI در فایل‌های VCF

نمونه کد زیر نشان می‌دهد چگونه یک لیست توزیع را در یک فایل VCF چند مخاطبی ذخیره کنید:

// convert the `msg` object to a `MapiMessage` object
var dlist = (MapiDistributionList)msg.ToMapiMessageItem();

//save the distribution list
var options = new MapiDistributionListSaveOptions(ContactSaveFormat.VCard);
dlist.Save("distribution_list.vcf", options);

تبدیل فایل‌های VCF چند مخاطبی به MapiDistributionList

Aspose.Email از تبدیل فایل‌های VCF چند مخاطبی به MapiDistributionList اشیا، که مدیریت و وارد کردن چندین مخاطب را مستقیماً به برنامه‌های شما آسان می‌کند. این ویژگی از طریق متدهای استاتیک زیر در MapiDistributionList کلاس:

نمونه کد زیر نشان می‌دهد چگونه از این ویژگی استفاده کنید:

// Convert a multi-contact VCF file to a MapiDistributionList
MapiDistributionList dlist = MapiDistributionList.FromVCF(fileName);

ذخیره مخاطبین در قالب VCF

برای ذخیره مخاطب در فرمت VCF نسخه 3، از … استفاده کنید. VCardVersion قابل شمارش برای تنظیم VCardSaveOptions.Version ویژگی. کد نمونه زیر نحوه استفاده از را نشان می‌دهد VCardVersion قابل‌تجمیع برای ذخیره تماس در قالب VCF نسخه ۳:

var options = new MapiDistributionListSaveOptions(ContactSaveFormat.VCard);
options.Version = VCardVersion.V30;
dlist.Save("distribution_list.vcf", options);

خواندن مخاطبین MAPI

این MapiContact کلاس می‌تواند برای بارگذاری مخاطبین فرمت‌های Outlook MSG و VCard استفاده شود. قطعه کد زیر نشان می‌دهد چگونه مخاطبین Outlook ذخیره‌شده به صورت MSG و VCF را به یک MapiContact.

بارگذاری مخاطبین از فایل‌های MSG

قطعه کد زیر نشان می‌دهد چگونه مخاطبین را از MSG بارگذاری کنید.

بارگذاری مخاطبین از VCardها

قطعه کد زیر نشان می‌دهد چگونه مخاطبین را از VCard بارگذاری کنید.

بارگذاری مخاطبین MAPI از vCard با گزینه‌های سفارشی

برای فراهم کردن انعطاف بیشتر هنگام تبدیل فایل‌های vCard (.vcf) به مخاطبین MAPI، Aspose.Email برای .NET یک overload ارائه می‌دهد MapiContact.FromVCard(string filePath, VCardLoadOptions options) متدی که یک VCardLoadOptions شیء. این امکان کنترل بهبود یافته‌ای را بر تفسیر فایل‌های vCard فراهم می‌کند - به‌ویژه هنگام کار با فرمت‌ها، رمزگذاری‌ها یا سناریوهای پیشرفتهٔ تجزیه vCard.

نمونه کد زیر نشان می‌دهد چگونه یک فایل تماس .vcf را به یک MapiContact شیء با استفاده از overloadی که می‌پذیرد VCardLoadOptions. تماس بارگذاری‌شده می‌تواند سپس در فایل‌های PST، خروجی MSG یا سایر فرمت‌های سازگار با Outlook استفاده شود.

var mapiContact = MapiContact.FromVCard("contact.vcf", new VCardLoadOptions());
Console.WriteLine(mapiContact.NameInfo.DisplayName);

بارگذاری مخاطبین از VCardها با رمزگذاری مشخص

قطعه کد زیر نشان می‌دهد چگونه مخاطبان را از VCard با رمزگذاری مشخص بارگذاری کنید.

ذخیره موارد تماس VCard با رمزگذاری مشخص

رفتار ذخیره‌سازی را هنگام کار با فایل‌های VCard با استفاده از VCardSaveOptions کلاس. PreferredTextEncoding ویژگی کلاس تعیین می‌کند که کدام رمزگذاری هنگام ذخیرهٔ موارد تماس VCard استفاده شود.

نمونه کد زیر نشان می‌دهد چگونه این ویژگی را در پروژه خود پیاده‌سازی کنید:

var cont = VCardContact.Load(fileName, Encoding.UTF8);
var opt = new VCardSaveOptions();
opt.PreferredTextEncoding = Encoding.UTF8;
cont.Save("my.vcard", opt);

ذخیره فایل‌های VCard با فیلدهای افزوده

این UseExtensions ویژگی امکان کنترل استفاده از فیلدهای گسترده هنگام ذخیره‌سازی فایل‌های vCard را می‌دهد. وقتی به true (پیش‌فرض) تنظیم شود، افزونه‌ها مجاز هستند و سازگاری با فیلدهای سفارشی و اطلاعات تکمیلی مخاطب را فراهم می‌کنند.

خواندن چندین مخاطب در فرمت VCard

کتابخانهٔ ما امکان دریافت فهرست تمام مخاطبین از یک VCard را فراهم می‌کند. این کار می‌تواند با استفاده از متدها و مراحل زیر انجام شود:

// Checks whether VCard source stream contains multiple contacts.
VCardContact.IsMultiContacts(Stream stream)

// Loads list of all contacts from VCard file.
VCardContact.LoadAsMultiple(string filePath, Encoding encoding)

// Loads list of all contacts from VCard stream.
VCardContact.LoadAsMultiple(Stream stream, Encoding encoding)

قطعه کد زیر نشان می‌دهد چگونه فایل‌های VCard که شامل چندین مخاطب هستند را مدیریت کنید:

using (FileStream stream = new FileStream("test.vcf", FileMode.Open, FileAccess.Read))
{
    if(VCardContact.IsMultiContacts(stream))
    {
        List<VCardContact> contacts = VCardContact.LoadAsMultiple(stream, Encoding.UTF8);
    }
}

بارگذاری مخاطبین vCard به‌صورت ناهمگام

این VCardContact کلاس در Aspose.Email برای .NET از بارگذاری ناهمگام فایل‌های vCard پشتیبانی می‌کند. این امکان به برنامه‌ها اجازه می‌دهد به‌صورت کارآمد یک یا چند مخاطب را از فایل‌های .vcf یا جریان‌ها بدون مسدود کردن رشتهٔ اصلی بخوانند - ایده‌آل برای برنامه‌های دسکتاپ، وب یا موبایل مدرن که با فهرست‌های بزرگ مخاطب سروکار دارند. متدهای زیر این کار را انجام می‌دهند:

LoadAsync
LoadAsMultipleAsync

نمونه کد زیر نشان می‌دهد چگونه به‌صورت ناهمگام چندین مخاطب vCard را از یک فایل .vcf با استفاده از VCardContact.LoadAsMultipleAsync بارگذاری کنید. مخاطبین بارگذاری‌شده در یک حلقه پردازش می‌شوند و نام نمایشی هر مخاطب در کنسول چاپ می‌شود. رویکرد ناهمگام اطمینان می‌دهد که برنامه حتی هنگام خواندن فایل‌های بزرگ پاسخگو باقی بماند.

var contacts = await VCardContact.LoadAsMultipleAsync("contacts.vcf", new VCardLoadOptions(), CancellationToken.None);

foreach (var contact in contacts)
{
    Console.WriteLine(contact.IdentificationInfo.DisplayName);
}

رندر اطلاعات مخاطب به MHTML

مخاطب Outlook می‌تواند با استفاده از Aspose.Email API به MHTML تبدیل شود. این مثال نشان می‌دهد چگونه یک VCard به داخل … بارگذاری می‌شود. MapiContact و سپس با کمک … به MHTML تبدیل می‌شود MailMessage API.

//Load VCF Contact and convert to MailMessage for rendering to MHTML
var contact = MapiContact.FromVCard("Contact.vcf");

MemoryStream ms = new MemoryStream();
contact.Save(ms, ContactSaveFormat.Msg);
ms.Position = 0;
MapiMessage msg = MapiMessage.Load(ms, new MsgLoadOptions());
MailConversionOptions op = new MailConversionOptions();
MailMessage eml = msg.ToMailMessage(op);

//Prepare the MHT format options
MhtSaveOptions mhtSaveOptions = new MhtSaveOptions();
mhtSaveOptions.CheckBodyContentEncoding = true;
mhtSaveOptions.PreserveOriginalBoundaries = true;
MhtFormatOptions formatOp = MhtFormatOptions.WriteHeader | MhtFormatOptions.RenderVCardInfo;
mhtSaveOptions.RenderedContactFields = ContactFieldsSet.NameInfo | ContactFieldsSet.PersonalInfo | ContactFieldsSet.Telephones | ContactFieldsSet.Events;
mhtSaveOptions.MhtFormatOptions = formatOp;
eml.Save("ContactMhtml_out.mhtml", mhtSaveOptions);

Net: کار با لیست‌های توزیعی

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

با استفاده از Aspose.Email API می‌توان لیست توزیع (Distribution list) ایجاد کرد که مجموعه‌ای از چندین مخاطب است. یک لیست توزیع می‌تواند در قالب Outlook MSG روی دیسک ذخیره شود و با باز کردن آن در MS Outlook قابل مشاهده/دستکاری باشد.

ایجاد و ذخیرهٔ فهرست توزیع

کد نمونه زیر نشان می‌دهد چگونه یک لیست توزیعی ایجاد و ذخیره کنید.

خواندن فهرست توزیع از فایل‌های PST

کد نمونه زیر نشان می‌دهد چگونه یک لیست توزیعی را از یک فایل PST بخوانید.

Net: ایجاد، ذخیره و خواندن کارهای Outlook

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

ایجاد کارهای Outlook

Aspose.Email برای .NET به شما امکان ایجاد کارهای Outlook و ذخیره آن‌ها در قالب MSG را می‌دهد. MapiTask کلاس تعدادی ویژگی مانند را فراهم می‌کند PercentComplete, EstimatedEffort, ActualEffort, History, LastUpdate, و دیگران، برای انطباق و تنظیم اطلاعات مورد نیاز برای یک کار Outlook. این مقاله نشان می‌دهد چگونه یک … ایجاد، ذخیره و خواندن کنید MapiTask از دیسک. برای ایجاد و ذخیره یک کار بر روی دیسک:

یک شیء جدید از MapiTask کلاس.
اطلاعات ویژگی‌های وظیفه را وارد کنید.
وظیفه را در فرمت MSG روی دیسک ذخیره کنید.

قطعه کد زیر نشان می‌دهد چگونه وظایف را ایجاد، ذخیره و بخوانید.

خواندن کارهای MAPI

کارهای ذخیره‌شده در قالب MSG می‌توانند بارگذاری شوند به MapiMessage و سپس تبدیل به MapiTask با دسترسی به ویژگی‌های خاص آن‌ها، مانند موضوع و وضعیت. نمونه کد زیر نشان می‌دهد چگونه جزئیات کار را از فایل‌های MSG ذخیره‌شده بخوانید و دستکاری کنید:

خواندن وظایف VToDo

کارهای Outlook که به فرمت iCalendar به عنوان رویدادهای VToDo صادر شده‌اند می‌توانند با استفاده از MapiTask کلاس همان‌طور که در نمونه کد زیر نشان داده شده است. قطعه کد زیر نشان می‌دهد چگونه یک کار VToDo را بخوانید.

افزودن اطلاعات یادآور به کارهای MAPI

مشابه Microsoft Outlook، Aspose.Email می‌تواند اطلاعات یادآوری را به یک MapiTask. کد نمونه زیر نشان می‌دهد چگونه اطلاعات یادآوری را به یک MapiTask.

افزودن پیوست‌ها به کارهای MAPI

کد نمونه زیر نشان می‌دهد چگونه پیوست‌ها را به یک MapiTask.

افزودن تکرار به کارهای MAPI

Aspose.Email امکان ایجاد یک کار تکراری را فراهم می‌کند که تکرار می‌تواند روزانه، هفتگی، ماهانه یا سالانه باشد. قطعه کد زیر نشان می‌دهد چگونه یک کار با انواع تکرار مختلف ایجاد کنید.

تبدیل وظایف به MHT

Aspose.Email می‌تواند تولید کند MailMessage مانند خروجی هنگام تبدیل یک MapiTask به MHT.

تبدیل MSG به HTML با حفظ فیلدهای کار

این HtmlFormatOptions.RenderTaskFields enumeration اجازه می‌دهد تعیین کنید که فیلدهای کار باید در سرصفحه فایل HTML ذخیره شده گنجانده شوند. قطعه کد زیر نشان می‌دهد چگونه فیلدهای کار را در سرصفحه هنگام ذخیره فایل html حفظ کنید:

var msg = MapiMessage.Load("task.msg");
HtmlSaveOptions opt = SaveOptions.DefaultHtml;
opt.HtmlFormatOptions = HtmlFormatOptions.WriteHeader | HtmlFormatOptions.RenderTaskFields;
msg.Save("task.html", opt);

Net: ایجاد، ذخیره و خواندن یادداشت‌های Outlook

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

ایجاد و ذخیرهٔ یادداشت‌های اوتلوک

Aspose.Email امکان ایجاد یادداشت‌های Outlook و ذخیره آن‌ها بر روی دیسک در قالب MSG را فراهم می‌کند. MapiNote کلاس ویژگی‌ها و متدهایی برای تنظیم اطلاعات کار فراهم می‌کند. این مقاله نشان می‌دهد چگونه یک … ایجاد، ذخیره و خواندن کنید MapiNote از دیسک.

مراحل زیر می‌تواند برای ایجاد و ذخیره یک یادداشت بر روی دیسک استفاده شود:

یک شیء از MapiNote کلاس.
تنظیم ویژگی‌های مختلف.
یادداشت را به عنوان فایل MSG بر روی دیسک ذخیره کنید.

قطعه کد زیر نشان می‌دهد چگونه یک یادداشت Outlook ایجاد و ذخیره کنید.

خواندن یادداشت‌های MAPI

این MapiNote آبجکت کلاس برای تبدیل … استفاده می‌شود. MapiMessage شیئی که یک یادداشت را از دیسک با فرمت MSG بارگذاری می‌کند. قطعه کد زیر نشان می‌دهد چگونه یک … بخوانید MapiNote.

Net: مدیریت موارد تقویم Outlook

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

Aspose.Email MapiCalendar کلاس متدها و ویژگی‌هایی را برای تنظیم خواص مختلف یک آیتم تقویم فراهم می‌کند. این بخش نمونه‌های کدی را برای موارد زیر ارائه می‌دهد:

ایجاد و ذخیره موارد تقویم

کد نمونهٔ زیر نشان می‌دهد چگونه می‌توانید یک مورد تقویم را در قالب ICS ایجاد و ذخیره کنید.

ذخیره آیتم‌های تقویم به‌صورت فایل‌های MSG

کد نمونهٔ زیر نشان می‌دهد چگونه می‌توانید مورد تقویم را به صورت MSG ذخیره کنید.

ذخیره شناسه‌های محصول برای آیتم‌های تقویم MAPI به ICS

این ProductIdentifier ویژگی MapiCalendarIcsSaveOptions کلاس برای ذخیره یک مورد تقویم MAPI به فایل iCalendar (ICS) استفاده می‌شود به‌طوری که اطلاعات تاریخ و زمان اصلی و همچنین شناسهٔ محصول سفارشی حفظ شود. این ویژگی شناسهٔ محصولی که شیء iCalendar را ایجاد کرده است را مشخص می‌کند.

نمونه کد زیر نشان می‌دهد چگونه با داده‌های iCalendar (ICS) درون یک شیء تقویم MAPI کار کنید:

var icsSaveOptions = new MapiCalendarIcsSaveOptions
{
    KeepOriginalDateTimeStamp = true,
    ProductIdentifier = "Foo Ltd"
};

mapiCalendar.Save("my.ics", icsSaveOptions);

دریافت تعداد کل رویدادها

کلاس CalendarReader امکان پردازش آسان رویدادهای تقویم را فراهم می‌کند. ویژگی‌ها و متد زیر به شما اجازه می‌دهند با چندین رویداد کار کنید:

CalendarReader.Count - ویژگی Count کلاس CalendarReader به شما امکان می‌دهد تعداد اجزای Vevent (رویدادها) موجود در تقویم را بازیابی کنید و پیگیری کل تعداد رویدادها را آسان می‌سازد.
CalendarReader.IsMultiEvents - این ویژگی تعیین می‌کند آیا تقویم شامل چندین رویداد است یا خیر. این مقدار بولی نشان می‌دهد آیا تقویم بیش از یک رویداد دارد و به شناسایی تقویم‌های تک یا چندرویدادی کمک می‌کند.
CalendarReader.Method - ویژگی Method نوع متد iCalendar مرتبط با شی تقویم را به دست می‌آورد. این متد نوع متد را برمی‌گرداند، مانند “REQUEST”، “PUBLISH” یا “CANCEL”، که بینش ارزشمندی درباره هدف تقویم ارائه می‌دهد.
CalendarReader.Version - نسخه iCalendar را دریافت می‌کند.
CalendarReader.LoadAsMultiple() این متد امکان بارگذاری فهرست رویدادها از تقویمی که شامل چندین رویداد است را فراهم می‌کند. این متد یک فهرست از اشیاء Appointment را برمی‌گرداند که دسترسی و پردازش هر رویداد را به‌صورت جداگانه آسان می‌سازد.

مثال کد زیر نشان می‌دهد چگونه می‌توانید این قابلیت‌ها را در پروژه خود پیاده‌سازی کنید:

var reader = new CalendarReader(fileName);
Console.WriteLine("Calendar contains " + reader.Count + " events");
Console.WriteLine("The Version of the calendar is " + reader.Version);
Console.WriteLine("The Method of the calendar is " + reader.Method);
Console.WriteLine("Is calendar contains contains multiple events? - " + reader.IsMultiEvents);
List<Appointment> appointments = reader.LoadAsMultiple();

افزودن یادآورهای نمایشی

قطعه کد زیر نشان می‌دهد چگونه یک یادآور نمایشی به تقویم اضافه کنید.

افزودن یادآورهای صوتی

کد نمونهٔ زیر نشان می‌دهد چگونه می‌توانید یک یادآوری صوتی به تقویم اضافه کنید.

افزودن/بازخوانی پیوست‌ها از فایل‌های تقویم

کد نمونهٔ زیر نشان می‌دهد چگونه می‌توانید پیوست‌ها را به فایل‌های تقویم اضافه/بازخوانی کنید.

بررسی وضعیت گیرندگان در درخواست‌های جلسه

قطعه کد زیر نشان می‌دهد چگونه وضعیت گیرندگان را از یک درخواست جلسه نمایش دهید.

ایجاد MAPI Calendar TimeZone از Timezone استاندارد

قطعه کد زیر نشان می‌دهد چگونه MapiCalendarTimeZone را از Timezone استاندارد ایجاد کنید.

تنظیم یادآورها برای قرارها

یک یادآوری می‌تواند هنگام ایجاد یک قرار ملاقات اضافه شود. این هشدارها می‌توانند بر اساس معیارهای مختلف مانند n دقیقه قبل از شروع برنامه، تکرار n بار با فواصل n فعال شوند. می‌توان از برچسب‌های متفاوت برای ایجاد این فعال‌کننده‌ها در اسکریپتی که بین BEGIN:VALARM و END:VALARM در یک قرار ملاقات قرار می‌گیرد، استفاده کرد. انواع مختلفی برای تنظیم یادآوری روی یک قرار ملاقات وجود دارد.

افزودن برچسب برای تنظیم یادآورها

کد نمونهٔ زیر نشان می‌دهد چگونه می‌توانید یادآوری را با افزودن برچسب‌ها تنظیم کنید.

تبدیل Appointment EML به MSG با بدنهٔ HTML

از نسخهٔ 19.3 به بعد، Aspose.Email امکان تبدیل Appointment EML به MSG را فراهم می‌کند در حالی که بدنهٔ HTML قرار ملاقات حفظ می‌شود. Aspose.Email یک MapiConversionOptions.ForcedRtfBodyForAppointment خاصیتی که مقدار پیش‌فرض آن true. است. وقتی مقدار MapiConversionOptions.ForcedRtfBodyForAppointment اگر به true تنظیم شود، بدنهٔ قرار ملاقات به قالب RTF تبدیل می‌شود. برای حفظ قالب بدنهٔ قرار ملاقات به فرمت HTML، مقدار MapiConversionOptions.ForcedRtfBodyForAppointment به false.

مثال زیر نحوه استفاده از MapiConversionOptions.ForcedRtfBodyForAppointment خاصیتی برای حفظ قالب بدنه قرار ملاقات به فرمت HTML.

تنظیم دستی حالت آیتم‌های تقویم MAPI

حالت یک شی MAPI Calendar را به‌صورت صریح تنظیم کنید تا رفتار پیش‌فرض را نادیده بگیرید. این امکان کنترل بهتر بر وضعیت رویدادهای تقویم را به‌ویژه هنگام پردازش درخواست‌های جلسه دریافت‌شده فراهم می‌کند. به‌طور پیش‌فرض، وقتی یک جلسه ایجاد می‌شود، حالت آن MapiCalendarState.Meeting. وقتی در صندوق ورودی گیرنده دریافت می‌شود، به‌صورت خودکار تغییر می‌یابد به MapiCalendarState.Received، و کلاس پیام آن به “IPM.Schedule.Meeting.Request” به‌روز می‌شود. با استفاده از SetStateForced به‌صورت دستی امکان تنظیم حالت به Received را فراهم می‌کند، که می‌تواند برای حفظ اطلاعات برنامه‌ریز هنگام ذخیره تقویم به‌عنوان فایل MSG مفید باشد. با این حال، ممکن است از ارسال مجدد یا فوروارد مناسب جلسه جلوگیری کند.

نمونه کد زیر نشان می‌دهد چگونه یک … ایجاد کنید MapiCalendar شی، یک برنامه‌ریز اختصاص دهید و به‌طور صریح حالت آن را به هر دو تنظیم کنید Meeting و Received با استفاده از SetStateForced. سپس آیتم تقویم را به‌صورت فایل .msg ذخیره می‌کند.

MapiCalendar appointment = new MapiCalendar(
    "LAKE ARGYLE WA 6743",
    "Appointment",
    "This is a very important meeting :)",
    new DateTime(2024, 5, 10, 12, 30, 0, DateTimeKind.Utc),
    new DateTime(2024, 5, 10, 13, 30, 0, DateTimeKind.Utc));

appointment.Organizer = new MapiElectronicAddress
{
    EmailAddress = "test@aaa.com",
    DisplayName = "test display Name"
};

appointment.SetStateForced(MapiCalendarState.Meeting | MapiCalendarState.Received);

appointment.Save("appointment.msg", AppointmentSaveFormat.Msg);

Net: مدیریت تکرارها

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

کار با تکرارهای روزانه

Aspose.Email از ایجاد تکرارهای روزانه با استفاده از MapiCalendarDailyRecurrencePattern پشتیبانی می‌کند. می‌توان از سه نوع پایان تکرار مختلف تقویم Mapi استفاده کرد که شامل EndAfterNOccurrences، EndAfterDate و NeverEnd می‌باشد. این بخش ایجاد الگوهای مختلف تکرار روزانه را نشان می‌دهد.

تکرارهای روزانه با شمارش وقوع

در این نوع تکرار، تعداد تکرارها به همراه سایر اطلاعات به شرح زیر تنظیم می‌شود:

تاریخ شروع، پایان و موعد را تنظیم کنید.
یک MapiTask ایجاد کنید.
وضعیت کار را به NotAssigned تنظیم کنید.
شیء تکرار روزانه را با تنظیم ویژگی‌هایی مانند PatternType، Period، WeekStartDay، EndType و OccurenceCount ایجاد کنید.
ویژگی MapiTask.Recurrence را به این شیء تکرار روزانه تنظیم کنید.
این پیام را بر روی دیسک ذخیره کنید.

قطعه کد زیر نشان می‌دهد چگونه یک تسک با نوع پایان تکرار EndAfterNOccurrence ایجاد کنید.

تابع زیر می‌تواند برای محاسبه تعداد رویدادها بین دو تاریخ استفاده شود:

تنظیم مقدار تعداد وقوع‌ها

کد نمونه زیر نشان می‌دهد چگونه مقدار تعداد وقوع‌ها را تنظیم کنید.

تکرارهای روزانه: نوع EndAfterDate

تکرارهای روزانه: تنظیم مقدار Every Day

کد نمونه زیر نشان می‌دهد چگونه مقدار period را به 1 و مقدار INTERVAL را نیز در رشته RRULE به 1 تنظیم کنیم.

مقدار Every Day می‌تواند به هر مقدار مناسب تنظیم شود همان‌طور که در مثال زیر نشان داده شده است:

تکرارهای روزانه: نوع NeverEnd

نوع پایان می‌تواند با استفاده از MapiCalendarRecurrenceEndType.NeverEnd تنظیم شود. مقدار Period یا INTERVAL را می‌توان در مثال زیر به مقدار مورد نیاز، مثلاً 1، تنظیم کرد.

کار با تکرارهای هفتگی

Aspose.Email امکانات گسترده‌ای برای ایجاد تکرارهای هفتگی با استفاده از MapiCalendarWeeklyRecurrencePattern فراهم می‌کند. می‌توان از سه نوع پایان تکرار مختلف تقویم Mapi استفاده کرد که شامل EndAfterNOccurrences، EndAfterDate و NeverEnd می‌باشد. این بخش ایجاد الگوهای مختلف تکرار هفتگی را نشان می‌دهد.

تکرارهای هفتگی: نوع EndAfterNOccurrences

در این نوع تکرار، تعداد تکرارها به همراه سایر اطلاعات به شرح زیر تنظیم می‌شود:

تاریخ شروع، پایان و موعد را تنظیم کنید.
یک MapiTask ایجاد کنید.
وضعیت کار را به NotAssigned تنظیم کنید.
شی تکرار هفتگی را با تنظیم ویژگی‌هایی مانند PatternType، Period، WeekStartDay، EndType و OccurenceCount ایجاد کنید.
ویژگی MapiTask.Recurrence را به این شی تکرار هفتگی تنظیم کنید.
این پیام را بر روی دیسک ذخیره کنید.

قطعه کد زیر نشان می‌دهد چگونه یک کار با نوع پایان تکرار EndAfterNOccurrence ایجاد کنید.

تابع زیر می‌تواند برای محاسبه تعداد رویدادها بین دو تاریخ استفاده شود:

انتخاب چندین روز در یک هفته

کد نمونه زیر نشان می‌دهد چگونه چندین روز در یک هفته انتخاب کنید.

انتخاب چندین روز در یک هفته و تنظیم بازه‌ها

کد نمونه زیر نشان می‌دهد چگونه چندین روز در یک هفته را انتخاب کرده و بازه‌ها را تنظیم کنید.

تکرارهای هفتگی: نوع EndAfterDate

تکرارهای هفتگی: تنظیم مقدار Every Day

کد نمونه زیر نشان می‌دهد چگونه مقدار period را به 1 و مقدار INTERVAL را نیز در رشته RRULE به 1 تنظیم کنیم.

مقدار Every Day می‌تواند به هر مقدار مناسب تنظیم شود و می‌توان چندین روز را همان‌طور که در مثال زیر نشان داده شده است انتخاب کرد:

تکرارهای هفتگی: نوع NeverEnd

کار با تکرارهای ماهانه

Aspose.Email از ایجاد تکرارهای ماهانه با استفاده از MapiCalendarMonthlyRecurrencePattern پشتیبانی می‌کند. می‌توان از سه نوع پایان تکرار مختلف تقویم Mapi استفاده کرد که شامل EndAfterNOccurrences، EndAfterDate و NeverEnd می‌باشد. این بخش ایجاد الگوهای مختلف تکرار ماهانه را نشان می‌دهد.

تکرارهای ماهانه: نوع EndAfterNOccurrences

در این نوع تکرار، تعداد تکرارها به همراه سایر اطلاعات به شرح زیر تنظیم می‌شود:

تاریخ شروع، پایان و موعد را تنظیم کنید.
یک MapiTask ایجاد کنید.
وضعیت کار را به NotAssigned تنظیم کنید.
شی تکرار ماهانه را با تنظیم ویژگی‌هایی مانند PatternType، Period، WeekStartDay، EndType و OccurenceCount ایجاد کنید.
ویژگی MapiTask.Recurrence را به این شی تکرار ماهانه تنظیم کنید.
این پیام را بر روی دیسک ذخیره کنید.

قطعه کد زیر نشان می‌دهد چگونه یک کار با نوع پایان تکرار EndAfterNOccurrence ایجاد کنید.

تابع زیر می‌تواند برای محاسبه تعداد رویدادها بین دو تاریخ استفاده شود:

تنظیم تعداد ثابت وقوع‌ها

قطعه کد زیر نشان می‌دهد چگونه یک تعداد ثابت از وقوع‌ها را تنظیم کنید.

تکرارهای ماهانه: نوع EndAfterDate

"End By" گزینه در Mapi Task با تنظیم ویژگی OccurrenceCount که توسط تابع GetOccurrenceCount() محاسبه می‌شود، به‌دست می‌آید. این تابع تاریخ شروع، تاریخ پایان و رشته RRULE را دریافت می‌کند. قطعه کد زیر نشان می‌دهد چگونه یک تکرار در روز ۱۵ هر ماه بین تاریخ شروع و پایان ایجاد کنید.

تکرارهای ماهانه: نوع NeverEnd

قطعه کد زیر نشان می‌دهد چگونه نوع پایان را با استفاده از MapiCalendarRecurrenceEndType.NeverEnd تنظیم کنید.

کار با تکرارهای سالانه

Aspose.Email از ایجاد تکرارهای سالانه با استفاده از MapiCalendarMonthlyRecurrencePattern پشتیبانی می‌کند. با تنظیم ویژگی period برابر 12 می‌توانیم الگوی تکرار سالانه را به‌دست آوریم. می‌توان از سه نوع پایان تکرار مختلف تقویم Mapi استفاده کرد که شامل EndAfterNOccurrences، EndAfterDate و NeverEnd می‌باشد. این بخش ایجاد الگوهای مختلف تکرار سالانه را نشان می‌دهد.

تکرارهای سالانه: نوع EndAfterNOccurrences

در این نوع تکرار، تعداد تکرارها به همراه سایر اطلاعات به شرح زیر تنظیم می‌شود:

تاریخ شروع، پایان و موعد را تنظیم کنید.
یک MapiTask ایجاد کنید.
وضعیت کار را به NotAssigned تنظیم کنید.
شی تکرار ماهانه را با تنظیم ویژگی‌هایی مانند PatternType، Period، WeekStartDay، EndType و OccurenceCount ایجاد کنید.
ویژگی MapiTask.Recurrence را به این شی تکرار ماهانه تنظیم کنید تا تکرار سالانه به دست آید.
این پیام را بر روی دیسک ذخیره کنید.

قطعه کد زیر نشان می‌دهد چگونه یک کار با نوع پایان تکرار EndAfterNOccurrence ایجاد کنید.

تکرارهای سالانه: نوع EndAfterDate

"End By" گزینه در Mapi Task با تنظیم ویژگی OccurrenceCount که توسط تابع GetOccurrenceCount() محاسبه می‌شود، به‌دست می‌آید. این تابع تاریخ شروع، تاریخ پایان و رشته RRULE را دریافت می‌کند. قطعه کد زیر نشان می‌دهد چگونه یک تکرار در روز ۱۵ هر ۷ ماه بین تاریخ شروع و پایان ایجاد کنید.

تکرارهای سالانه: نوع NeverEnd

قطعه کد زیر نشان می‌دهد چگونه نوع پایان را با استفاده از MapiCalendarRecurrenceEndType.NeverEnd تنظیم کنید.

تولید تکرار از قاعده تکرار

API Aspose.Email قابلیت تولید الگوی تکرار از قانون تکرار (RRULE) را فراهم می‌کند. این API اطلاعات را طبق مشخصات iCal RFC 5545 از RRULE تجزیه‑تحلیل می‌کند و الگوی تکرار را با استفاده از متد MapiCalendarRecurrencePatternFactory.FromString تولید می‌نماید. قطعه کد زیر نشان می‌دهد چگونه الگوی تکرار را از قانون تکرار تولید کنید.

افزودن پیوست به رویدادهای تقویم تکراری

API Aspose.Email قابلیت افزودن پیوست‌ها به رویدادهای تقویم تکراری را فراهم می‌کند.