Documentation – کار با کلاینت Exchange EWS

Net: اتصال به سرور Exchange

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

برای اتصال به سرورهای Exchange 2007، 2010 و 2013 با استفاده از Exchange Web Service، Aspose.Email فراهم می‌کند IEWSClient رابطی که پیاده‌سازی می‌کند EWSClient کلاس. EWSClient.GetEWSClient متد یک IEWSClient شیئی که سپس برای انجام عملیات مرتبط با صندوق‌نامه Exchange و پوشه‌های دیگر استفاده می‌شود. این مقاله نشان می‌دهد چگونه اشیاء از IEWSClient.

اتصال به سرور Exchange با استفاده از EWS

قطعه کد زیر نشان می‌دهد چگونه با استفاده از Exchange Web Service (EWS) یک اتصال برقرار کنید:

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
private static IEWSClient GetExchangeEWSClient()
{
    const string mailboxUri = "https://outlook.office365.com/ews/exchange.asmx";
    const string domain = @"";
    const string username = @"username@ASE305.onmicrosoft.com";
    const string password = @"password";
    NetworkCredential credentials = new NetworkCredential(username, password, domain);
    IEWSClient client = EWSClient.GetEWSClient(mailboxUri, credentials);
    return client;
}

افزودن هدرهای سفارشی به مقداردهی اولیه EWSClient

در سناریوهایی که هنگام مقداردهی اولیه کلاینت به هدرهای خاصی نیاز است، مانند هدر X-AnchorMailbox در EWS، از متدهای بارگذاری‌شده زیر برای افزودن هدرهای سفارشی هنگام ایجاد یک نمونه از IEWSClient:

IEWSClient GetEWSClient(string mailboxUri, ICredentials credentials, WebProxy proxy, Dictionary headers)
async Task GetEwsClientAsync(string mailboxUri, ICredentials credentials, WebProxy proxy, CancellationToken cancellationToken , Dictionary headers)

نمونه کد زیر نشان می‌دهد چگونه IEWSClient را پیکربندی و مقداردهی اولیه کنید در حالی که از هدرهای سفارشی HTTP استفاده می‌شود:

var headers = new Dictionary<string, string>();
headers.Add("X-AnchorMailbox", smtpExampleAddress);
IEWSClient client = EWSClient.GetEWSClient(HttpsExampleCom, new OAuthNetworkCredential("UserName", "Token"), null, headers);

اتصال به سرور Exchange با استفاده از IMAP

Microsoft Exchange Server از پروتکل IMAP برای دسترسی به موارد موجود در یک صندوق پستی پشتیبانی می‌کند. از Aspose.Email استفاده کنید ImapClient کلاس برای اتصال به سرور Exchange با استفاده از پروتکل IMAP. برای اطلاعات بیشتر دربارهٔ ImapClient کلاس. ابتدا اطمینان حاصل کنید که سرویس‌های IMAP برای سرور Exchange شما فعال هستند:

پنل کنترل را باز کنید.
به ابزارهای مدیر (Administrator Tools) رفته، سپس Services.
وضعیت سرویس Microsoft Exchange IMAP4 را بررسی کنید.
اگر قبلاً در حال اجرا نیست، آن را فعال/شروع کنید.

قطعه کد زیر نشان می‌دهد چگونه با استفاده از پروتکل IMAP به سرور Microsoft Exchange متصل شوید و پیام‌های پوشه Inbox را فهرست کنید.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Connect to Exchange Server using ImapClient class
ImapClient imapClient = new ImapClient("ex07sp1", "Administrator", "Evaluation1");
imapClient.SecurityOptions = SecurityOptions.Auto;

// Select the Inbox folder
imapClient.SelectFolder(ImapFolderInfo.InBox);

// Get the list of messages
ImapMessageInfoCollection msgCollection = imapClient.ListMessages();
foreach (ImapMessageInfo msgInfo in msgCollection)
{
    Console.WriteLine(msgInfo.Subject);
}
// Disconnect from the server
imapClient.Dispose();

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

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
public static void Run()
{            
    // Connect to Exchange Server using ImapClient class
    ImapClient imapClient = new ImapClient("ex07sp1", 993, "Administrator", "Evaluation1", new RemoteCertificateValidationCallback(RemoteCertificateValidationHandler));
    imapClient.SecurityOptions = SecurityOptions.SSLExplicit;

    // Select the Inbox folder
    imapClient.SelectFolder(ImapFolderInfo.InBox);

    // Get the list of messages
    ImapMessageInfoCollection msgCollection = imapClient.ListMessages();
    foreach (ImapMessageInfo msgInfo in msgCollection)
    {
        Console.WriteLine(msgInfo.Subject);
    }
    // Disconnect from the server
    imapClient.Dispose();   
}

// Certificate verification handler
private static bool RemoteCertificateValidationHandler(object sender, X509Certificate certificate, X509Chain chain, SslPolicyErrors sslPolicyErrors)
{
    return true; // ignore the checks and go ahead
}

پس از اتصال به سرور Exchange با استفاده از IMAP و دریافت IMapMessageInfoCollection، می‌توانید به‌دست آورید MessageInfo شی. قطعه کد زیر نشان می‌دهد چگونه از شماره توالی MessageInfo شی برای ذخیره یک پیام خاص.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Select the Inbox folder
imapClient.SelectFolder(ImapFolderInfo.InBox);
// Get the list of messages
ImapMessageInfoCollection msgCollection = imapClient.ListMessages();
foreach (ImapMessageInfo msgInfo in msgCollection)
{
    // Fetch the message from inbox using its SequenceNumber from msgInfo
    MailMessage message = imapClient.FetchMessage(msgInfo.SequenceNumber);

    // Save the message to disc now
    message.Save(dataDir + msgInfo.SequenceNumber + "_out.msg", SaveOptions.DefaultMsgUnicode);
}

تنظیم پروتکل رمزگذاری ترجیحی

EWS از پروتکل حمل‌ونقل HTTPS برای عملیات پشتیبانی‌شده استفاده می‌کند. رمزنگاری توسط پروتکل‌های SSL/TLS فراهم می‌شود. این پروتکل‌ها توسط چارچوب .NET پیاده‌سازی می‌شوند و ممکن است بسته به نسخه فعلی .NET متفاوت باشند.

برای تنظیم نسخه SSL/TLS از کد زیر استفاده کنید:

var client = new ImapClient("some.host");
client.SupportedEncryption = EncryptionProtocols.Tls13;

یا

var client = new ImapClient("some.host");
client.SetSupportedEncryptionUnsafe(EncryptionProtocols.Tls13);

توجه داشته باشید، اگر EncryptionProtocol مشخص‌شده توسط نسخه فعلی چارچوب .NET پشتیبانی نشود، SupportedEncryption ویژگی پروتکل رمزگذاری را به سطح پشتیبانی‌شده پایین می‌آورد و SetSupportedEncryptionUnsafe متد یک استثنا پرتاب می‌کند.

اتصال به Exchange Server با استفاده از احراز هویت مدرن

احراز هویت مدرن اکنون به‌صورت پیش‌فرض برای تمام مستأجران جدید Microsoft 365/Azure فعال است، زیرا این پروتکل نسبت به Basic Authentication که منقضی شده، ایمن‌تر است.

احراز هویت مدرن بر پایه Active Directory Authentication Library و OAuth 2.0 است. از توکن‌های محدود به زمان استفاده می‌کند و برنامه‌ها اعتبارنامه‌های کاربر را ذخیره نمی‌کنند.

تنظیمات پیش‌نیاز

برای استفاده از احراز هویت مدرن، اطمینان حاصل کنید که فعال است. با این حال، برای مستأجرانی که قبل از 1 اوت 2017 ایجاد شده‌اند، احراز هویت مدرن به‌ صورت پیش‌فرض غیرفعال است. در مرکز مدیریت Microsoft 365، به Settings > Org Settings > Modern Authentication بروید. در پنجره Modern authentication که ظاهر می‌شود، می‌توانید پروتکل‌هایی را که دیگر به Basic authentication نیاز ندارند شناسایی کنید. برای مستأجران جدید Microsoft365 در Azure، Basic Authentication به‌ طور پیش‌فرض برای تمام برنامه‌ها غیرفعال است. بنابراین، متن در این بخش نمایش داده خواهد شد.

سازمان شما پیش‌فرض‌های امنیتی را فعال کرده است، که به این معنی است احراز هویت مدرن برای Exchange Online الزامی است و اتصالات احراز هویت پایه مسدود شده‌اند. > شما باید پیش‌فرض‌های امنیتی را در پرتال Azure خاموش کنید پیش از این که هر تنظیمی را اینجا تغییر دهید.

می‌توانید پشتیبانی Basic Auth را برای مستأجر از آژور پرتال، به Azure Active Directory > Properties > Manage Security defaults > Enable Security defaults > No بروید. برای اطلاعات بیشتر، به مقاله مستندات مایکروسافت.

ثبت برنامه با Azure Active Directory

آزمون ثبت برنامه با Azure Active Directory ضروری است. دو نوع مجوز وجود دارد که می‌توان با برنامه خود به صندوق‌های ایمیل دسترسی پیدا کرد. بر اساس برنامه‌ای که می‌سازید، نوع خاصی از مجوز را انتخاب کنید:

برنامه‌هایی که از مجوزهای واگذار شده استفاده می‌کنند، کاربر وارد شده‌ای دارند. به عبارت دیگر، زمانی که به سرویس متصل می‌شوید، یک پنجره گفت‌وگو برای نام کاربری و رمز عبور ظاهر می‌شود. برنامه هرگز نمی‌تواند از امتیازات کاربر وارد شده بیش‌تر داشته باشد.
برنامه‌هایی که از مجوزهای برنامه استفاده می‌کنند بدون حضور کاربر وارد شده اجرا می‌شوند. برای مثال، این برنامه‌ها به عنوان سرویس‌های پس‌زمینه یا دیمون‌ها اجرا می‌شوند. فقط یک مدیر می‌تواند به مجوزهای برنامه رضایت دهد.

علاوه بر این، به مقاله مستندات مایکروسافت برای اطلاعات بیشتر.

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

استفاده از احراز هویت مدرن با EWSClient

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

دریافت توکن مجوز.
از توکن برای احراز هویت استفاده کنید.

دریافت توکن مجوز

برای دریافت توکن از کتابخانه احراز هویت مایکروسافت (MSAL) برای .NET.

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

افزودن پکیج NuGet Microsoft.Identity.Client که شامل باینری‌های MSAL.NET است.
یک کلاس AccessParameters برای ذخیره اعتبارنامه‌ها ایجاد کنید.
یک متد ایجاد کنید که پارامترهای دسترسی را بپذیرد و با استفاده از MSAL.NET توکن دسترسی را دریافت کند.

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

دریافت توکن با احراز هویت واگذار شده

public class AccessParameters
{
    public string TenantId { get; set; }
    public string ClientId { get; set; }
    public string RedirectUri { get; set; } = "http://localhost";
    public string[] Scopes { get; set; } = { "https://outlook.office365.com/EWS.AccessAsUser.All" };
}

public static async Task<string> GetAccessToken(AccessParameters accessParameters)
{
    var pca = PublicClientApplicationBuilder
                            .Create(accessParameters.ClientId)
                            .WithTenantId(accessParameters.TenantId)
                            .WithRedirectUri(ccessParameters.RedirectUri)
                            .Build();

    var result = await pca.AcquireTokenInteractive(accessParameters.Scopes)
        .WithUseEmbeddedWebView(false)
        .ExecuteAsync();

    return result.AccessToken;
}

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

public class AccessParameters
{
    public string TenantId { get; set; }
    public string ClientId { get; set; }
    public string ClientSecret { get; set; }
    public string[] Scopes { get; set; } = { "https://outlook.office365.com/.default" };
}

public static async Task<string> GetAccessToken(AccessParameters accessParameters)
{
    var cca = ConfidentialClientApplicationBuilder
        .Create(accessParameters.ClientId)
        .WithClientSecret(accessParameters.ClientSecret)
        .WithTenantId(accessParameters.TenantId)
        .Build();

    var result = await cca.AcquireTokenForClient(accessParameters.Scopes).ExecuteAsync();

    return result.AccessToken;
}

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

پس از آن، هنگامی که توکن را با موفقیت دریافت کردیم، بیایید مقداردهی اولیه کنیم EwsClient.

استفاده از توکن با احراز هویت واگذار شده

NetworkCredential credentials = new OAuthNetworkCredential(accessToken);

using var client = EWSClient.GetEWSClient("https://outlook.office365.com/EWS/Exchange.asmx", credentials);

امتحان کنید! اجرا کنید EWSModernAuthenticationDelegated پروژه برنامه ساده، اتصال به Microsoft 365 با احراز هویت واگذار شده، و خواندن صندوق ورودی شما.

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

// Use Microsoft365 username and access token
NetworkCredential credentials = new OAuthNetworkCredential(username, accessToken);

using var client = EWSClient.GetEWSClient("https://outlook.office365.com/EWS/Exchange.asmx", credentials);

امتحان کنید! اجرا کنید EWSModernAuthenticationApp پروژه برنامه ساده، اتصال به Microsoft 365 با احراز هویت برنامه، و خواندن صندوق ورودی شما.

استفاده از احراز هویت مدرن با کلاینت‌های IMAP، POP یا SMTP

دسترسی IMAP، POP، SMTP از طریق مجوزهای برنامه پشتیبانی نمی‌شود. به عبارت دیگر، فقط احراز هویت واگذار شده پشتیبانی می‌شود.

روش ثبت برنامه با Azure Active Directory تعریف شده است بالا.

فعال یا غیرفعال‌سازی IMAP، POP، SMTP AUTH در Microsoft 365 Admin Center

باز کنید مرکز مدیریت Microsoft 365 و به Users > Active users بروید.
کاربر را انتخاب کنید و در پنجره‌ای که ظاهر می‌شود، روی Mail کلیک کنید.
در بخش Email apps، روی Manage email apps کلیک کنید.
تنظیم IMAP، POP، SMTP احراز هویت‌شده را بررسی کنید: بدون علامت = غیرفعال، با علامت = فعال.
روی Save changes کلیک کنید.

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

مطمئن شوید که دامنه‌های کامل، از جمله URLهای منبع Outlook را مشخص کنید.

IMAP: https://outlook.office.com/IMAP.AccessAsUser.All POP: https://outlook.office.com/POP.AccessAsUser.All SMTP: https://outlook.office.com/SMTP.Send

برای دریافت توکن از کتابخانه احراز هویت مایکروسافت (MSAL) برای .NET.

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

افزودن پکیج NuGet Microsoft.Identity.Client که شامل باینری‌های MSAL.NET است.
یک کلاس AccessParameters برای ذخیره اعتبارنامه‌ها ایجاد کنید.
یک متد ایجاد کنید که پارامترهای دسترسی را بپذیرد و با استفاده از MSAL.NET توکن دسترسی را دریافت کند.

public class AccessParameters
{
    public string TenantId { get; set; }
    public string ClientId { get; set; }
    public string RedirectUri { get; set; } = "http://localhost";
    public string[] Scopes { get; set; } = { 
        "https://outlook.office.com/IMAP.AccessAsUser.All", 
        "https://outlook.office.com/SMTP.Send" };
}

public static async Task<string> GetAccessToken(AccessParameters accessParameters)
{
    var pca = PublicClientApplicationBuilder
                            .Create(accessParameters.ClientId)
                            .WithTenantId(accessParameters.TenantId)
                            .WithRedirectUri(ccessParameters.RedirectUri)
                            .Build();

    var result = await pca.AcquireTokenInteractive(accessParameters.Scopes)
        .WithUseEmbeddedWebView(false)
        .ExecuteAsync();

    return result.AccessToken;
}

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

پس از آن، هنگامی که توکن را با موفقیت دریافت کردیم، بیایید مقداردهی اولیه کنیم ImapClient.

var imapClient = new ImapClient(
    "outlook.office365.com", 
    993, 
    username, 
    accessToken, 
    true);

به‌طور مشابه، SmtpClient مقداردهی اولیه به شکل زیر خواهد بود.

var smtpClient = new SmtpClient(
    "smtp.office365.com",
    587, 
    username,
    accessToken, 
    true);

امتحان کنید! اجرا کنید EWSModernAuthenticationImapSmtp پروژه برنامه ساده، اتصال به Microsoft 365 از طریق IMAP و SMTP، و خواندن صندوق ورودی شما.

برگرداندن شناسهٔ درخواست مشتری

این ReturnClientRequestId خاصیت به EWSClient اضافه شد تا به شما امکان تعیین کنید آیا شناسه درخواست مشتری باید در پاسخ فراخوانی‌های سرویس وب Exchange (EWS) برگردانده شود یا خیر. شناسه درخواست مشتری یک شناسه یکتا است که می‌توانید برای هر درخواست EWS که از برنامهٔ خود ارسال می‌شود، تنظیم کنید. با تنظیم ReturnClientRequestId ویژگی را به true تنظیم کنید، نشان می‌دهید که می‌خواهید شناسه درخواست کلاینت در پاسخ از سرور EWS گنجانده شود. این می‌تواند برای ردیابی و همبستگی درخواست‌ها و پاسخ‌ها در سناریوهایی که چندین درخواست به‌صورت ناهمزمان ساخته و پردازش می‌شوند مفید باشد.

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

using (IEWSClient client = TestUtil.CreateEWSClient(user))
{
   // Client will create random id and pass it to the server.
   // The server should include this id in request-id header of all responses.
   client.ReturnClientRequestId = true;
   
   client.LogFileName = "ews.log";
   client.GetMailboxInfo();
}

افزودن X-AnchorMailbox و سایر هدرها به درخواست‌های EWS

API Aspose.Email امکان افزودن هدرها به درخواست‌های Exchange را فراهم می‌کند. این می‌تواند برای افزودن هدرهای مختلف به درخواست‌های EWS برای مقاصد گوناگون استفاده شود. یک مثال می‌تواند افزودن هدر X-AnchorMailbox باشد که برای مدیریت مشکلات محدودیت سرعت در سرور Exchange استفاده می‌شود. The AddHeader متد از IEWSClient برای افزودن هدرها به درخواست‌های EWS استفاده می‌شود همان‌طور که در قطعه کد زیر نشان داده شده است.

نادیده گرفتن یا دور زدن گواهی SSL نامعتبر یا منقضی‌شده

Aspose.Email می‌تواند گواهی‌های SSL را بر روی Exchange Server با استفاده از هر دو ExchangeClient و EWSClient کلاس‌ها. اگر گواهی SSL منقضی شده یا نامعتبر شود، Aspose.Email به دلیل گواهی SSL نامعتبر استثنایی پرتاب می‌کند. با نادیده گرفتن این خطاها با استفاده از روش زیر از بروز چنین خطاهای گواهی SSL جلوگیری کنید. هندلر callback را در متد main() یا init() خود ثبت کنید و متد زیر را به عنوان عضو کلاس اضافه کنید.

Net: دریافت و مدیریت اطلاعات صندوق پستی سرور Exchange با استفاده از EWS

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

دریافت اطلاعات صندوق پستی با استفاده از EWS

این EWSClient کلاس دارای اعضایی است که می‌توان با فراخوانی آن، اطلاعات صندوق پستی را از یک سرور Exchange دریافت کرد IEWSClient.GetMailboxInfo() متد. یک نمونه از نوع را برمی‌گرداند ExchangeMailboxInfo. اطلاعات صندوق پستی را از ویژگی‌هایی مانند MailboxUri, InboxUri و DraftsUri. این مقاله نشان می‌دهد چگونه اطلاعات صندوق ایمیل را با استفاده از Exchange Web Services دسترسی پیدا کنید.

اگر می‌خواهید با استفاده از Exchange Web Services (EWS) به سرور Exchange متصل شوید، از IEWSClient کلاس در فضای نام Aspose.Email.Exchange. این کلاس از EWS برای اتصال و مدیریت آیتم‌ها در یک سرور Exchange استفاده می‌کند. قطعه کد C# زیر نشان می‌دهد چگونه اطلاعات صندوق پستی را با استفاده از Exchange Web Services دریافت کنید.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Create instance of EWSClient class by giving credentials         
IEWSClient client = EWSClient.GetEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Get mailbox size, exchange mailbox info, Mailbox and Inbox folder URI
Console.WriteLine("Mailbox size: " + client.GetMailboxSize() + " bytes");
ExchangeMailboxInfo mailboxInfo = client.GetMailboxInfo();
Console.WriteLine("Mailbox URI: " + mailboxInfo.MailboxUri);
Console.WriteLine("Inbox folder URI: " + mailboxInfo.InboxUri);
Console.WriteLine("Sent Items URI: " + mailboxInfo.SentItemsUri);
Console.WriteLine("Drafts folder URI: " + mailboxInfo.DraftsUri);

ارسال پیام‌های ایمیل

می‌توانید پیام‌های ایمیل را با استفاده از سرور Exchange و ابزارهای موجود در Aspose.Email.Exchange. این IEWClient.Send() متد یک مورد را می‌پذیرد MailMessage یک نمونه را به‌عنوان پارامتر می‌گیرد و ایمیل را ارسال می‌کند. این مقاله توضیح می‌دهد چگونه پیام‌های ایمیل را با استفاده از Exchange Web Services ارسال کنید.

Aspose.Email ارائه می‌دهد IEWSClient کلاسی برای اتصال به Microsoft Exchange Server با استفاده از Exchange Web Services. قطعه کد زیر نشان می‌دهد چگونه از EWS برای ارسال ایمیل‌ها با Microsoft Exchange Server استفاده کنید. قطعه کد C# زیر نشان می‌دهد چگونه پیام‌های ایمیل را با EWS ارسال کنید.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Create instance of IEWSClient class by giving credentials
IEWSClient client = EWSClient.GetEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Create instance of type MailMessage
MailMessage msg = new MailMessage();
msg.From = "sender@domain.com";
msg.To = "recipient@ domain.com ";
msg.Subject = "Sending message from exchange server";
msg.HtmlBody = "<h3>sending message from exchange server</h3>";

// Send the message
client.Send(msg);

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

شناسه ایمیل ارسال‌شده می‌تواند با کد نمونه زیر از سرور Exchange بازیابی شود:

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
using (IEWSClient client = EWSClient.GetEWSClient("https://exchange.office365.com/ews/exchange.asmx", "username", "password"))
{
    // Register the event handler
    client.ItemSent += new EventHandler<SentItemEventArgs>(ItemSentHandler);

    MailMessage eml = new MailMessage("test@test.com", "test@test.com", "test message", "This is a test message");

    client.Send(eml);
}

که در آن متد delegate این است:

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Define an event handler method
private static void ItemSentHandler(object sender, SentItemEventArgs e)
{
    
    // Now we can get an id of sent email, which was saved in Sent Items folder
    string id = e.SentFolderItemId;
}

خواندن ایمیل‌ها از صندوق پستی کاربر دیگر

برخی حساب‌ها در سرورهای Exchange اجازه دسترسی به چندین صندوق پستی را دارند و برخی کاربران چندین حساب ایمیل در همان سرور Exchange دارند. در هر دو حالت، کاربران می‌توانند به صندوق‌های ایمیل دیگر کاربران با استفاده از Aspose.Email for .NET دسترسی پیدا کنند. این API مکانیزمی برای دسترسی به پوشه‌ها و ایمیل‌ها از سایر صندوق‌های پستی فراهم می‌کند با استفاده از IEWSClient رابط. این عملکرد می‌تواند با استفاده از متد overload شده GetMailboxInfo() متد و ارائهٔ آدرس ایمیل کاربر به‌عنوان پارامتر.

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

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.GetEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Get Exchange mailbox info of other email account
ExchangeMailboxInfo mailboxInfo = client.GetMailboxInfo("otherUser@domain.com");

فهرست‌کردن پیام‌ها

فهرستی از پیام‌های ایمیل در یک صندوق پستی Exchange می‌تواند با فراخوانی IEWSClient.ListMessages متد. با استفاده از متد ListMessage اطلاعات پایهٔ پیام‌ها مانند موضوع، فرستنده، گیرنده و شناسهٔ پیام را دریافت کنید.

فهرست‌کردن سادهٔ پیام‌ها

برای فهرست کردن پیام‌ها در یک صندوق ایمیل Exchange:

یک نمونه از IEWSClient واسط.
متد را فراخوانی کنید ListMessages متد و یک مجموعهٔ پیام ایجاد کنید.
در مجموعه حلقه بزنید و اطلاعات پیام را نمایش دهید.

قطعه کد C# زیر نشان می‌دهد چگونه به یک سرور Exchange با استفاده از EWS متصل شوید و پیام‌ها را از پوشه inbox فهرست کنید.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Create instance of ExchangeWebServiceClient class by giving credentials
IEWSClient client = EWSClient.GetEWSClient("https://outlook.office365.com/ews/exchange.asmx", "UserName", "Password");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.ListMessages(client.MailboxInfo.InboxUri);

// Loop through the collection to display the basic information
foreach (ExchangeMessageInfo msgInfo in msgCollection)
{
    Console.WriteLine("Subject: " + msgInfo.Subject);
    Console.WriteLine("From: " + msgInfo.From.ToString());
    Console.WriteLine("To: " + msgInfo.To.ToString());
    Console.WriteLine("Message ID: " + msgInfo.MessageId);
    Console.WriteLine("Unique URI: " + msgInfo.UniqueUri);
}

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

قطعات کد بالا تمام پیام‌های پوشه Inbox را فهرست کنید. همچنین می‌توانید لیست پیام‌ها را از سایر پوشه‌ها دریافت کنید. این IEWSClient.ListMessages() متد یک URI پوشه را به‌عنوان پارامتر می‌پذیرد. تا زمانی که URI پوشه معتبر باشد، می‌توانید لیست پیام‌ها را از آن پوشه دریافت کنید. از IEWSClient.MailboxInfo.xxxFolderUri ویژگی برای دریافت URI پوشه‌های مختلف. بقیه کد همانند دریافت لیست پیام‌هاست. قطعه کد زیر نشان می‌دهد چگونه پیام‌ها را از پوشه‌های مختلف با استفاده از EWS فهرست کنید.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.GetEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Get folder URI
string strFolderURI = string.Empty;
strFolderURI = client.MailboxInfo.InboxUri;
strFolderURI = client.MailboxInfo.DeletedItemsUri;
strFolderURI = client.MailboxInfo.DraftsUri;
strFolderURI = client.MailboxInfo.SentItemsUri;

// Get list of messages from the specified folder
ExchangeMessageInfoCollection msgCollection = client.ListMessages(strFolderURI);

فهرست پیام‌ها با پشتیبانی از صفحه‌بندی

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

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
using (IEWSClient client = EWSClient.GetEWSClient("exchange.domain.com", "username", "password"))
{
    try
    {
        // Create some test messages to be added to server for retrieval later
        int messagesNum = 12;
        int itemsPerPage = 5;
        MailMessage message = null;
        for (int i = 0; i < messagesNum; i++)
        {
            message = new MailMessage(
                "from@domain.com",
                "to@domain.com",
                "EMAILNET-35157_1 - " + Guid.NewGuid().ToString(),
                "EMAILNET-35157 Move paging parameters to separate class");
            client.AppendMessage(client.MailboxInfo.InboxUri, message);
        }
        // Verfiy that the messages have been added to the server
        ExchangeMessageInfoCollection totalMessageInfoCol = client.ListMessages(client.MailboxInfo.InboxUri);
        Console.WriteLine(totalMessageInfoCol.Count);

        ////////////////// RETREIVING THE MESSAGES USING PAGING SUPPORT ////////////////////////////////////

        List<ExchangeMessagePageInfo> pages = new List<ExchangeMessagePageInfo>();
        ExchangeMessagePageInfo pageInfo = client.ListMessagesByPage(client.MailboxInfo.InboxUri, itemsPerPage);
        // Total Pages Count
        Console.WriteLine(pageInfo.TotalCount);

        pages.Add(pageInfo);
        while (!pageInfo.LastPage)
        {
            pageInfo = client.ListMessagesByPage(client.MailboxInfo.InboxUri, itemsPerPage, pageInfo.PageOffset + 1);
            pages.Add(pageInfo);
        }
        int retrievedItems = 0;
        foreach (ExchangeMessagePageInfo pageCol in pages)
            retrievedItems += pageCol.Items.Count;
        // Verify total message count using paging
        Console.WriteLine(retrievedItems);
    }
    finally
    {
    }
}

دریافت اطلاعات نوع پیام

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
const string mailboxUri = "https://exchange/ews/exchange.asmx";
const string domain = @"";
const string username = @"username@ASE305.onmicrosoft.com";
const string password = @"password";
NetworkCredential credentials = new NetworkCredential(username, password, domain);

IEWSClient client = EWSClient.GetEWSClient(mailboxUri, credentials);

ExchangeMessageInfoCollection list = client.ListMessages(client.MailboxInfo.DeletedItemsUri);
Console.WriteLine(list[0].MessageInfoType.ToString());

دریافت کلاس پیام

کلاس پیام نوع یک آیتم در فروشگاه Exchange را نشان می‌دهد. با دریافت کلاس پیام، می‌توانید نوع پیام ایمیل Exchange را تعیین کنید و عملیات خاصی را بر اساس دسته‌بندی آن انجام دهید.

در زیر نمونه‌ای از دریافت کلاس پیام با استفاده از ExchangeMessageInfo کلاس Aspose.Email for .NET:

نمونهٔ کد

using (var client = EWSClient.GetEWSClient(uri, credentials))
{
    var messageInfoCollection = client.ListMessagesFromPublicFolder(publicFolder);

    foreach (var messageInfo in messageInfoCollection)
    {
        Console.WriteLine("Message Class: {0}", messageInfo.MessageClass);
    }
}

ذخیرهٔ پیام‌ها

این مقاله نشان می‌دهد که چگونه پیام‌ها را از یک صندوق ایمیل سرور Exchange دریافت کنید و آن‌ها را روی دیسک در فرمت‌های EML و MSG ذخیره کنید:

ذخیره به‌صورت EML روی دیسک.
ذخیره در استریم حافظه.
ذخیره به‌صورت MSG.

ذخیرهٔ پیام‌ها به‌صورت EML

برای دریافت پیام‌ها و ذخیره در قالب EML:

یک نمونه از IEWSClient واسط.
mailboxUri، نام کاربری، رمز عبور و دامنه را فراهم کنید.
متد را فراخوانی کنید IEWSClient.ListMessages() متد برای دریافت یک نمونه از ExchangeMessagesInfoCollection.
در حلقه بگردید در ExchangeMessagesInfoCollection برای دریافت URI منحصر به‌فرد هر پیام.
متد را فراخوانی کنید IEWSClient.SaveMessage() متد و URI منحصر به فرد را به‌عنوان پارامتر ارسال کنید.
ارائه یک SaveMessage() متد همراه با مسیری که می‌خواهید فایل را ذخیره کنید.

قطعه کد زیر نشان می‌دهد که چگونه از EWS برای اتصال به سرور Exchange استفاده کنید و پیام‌ها را به‌صورت فایل‌های EML ذخیره کنید.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
string dataDir = RunExamples.GetDataDir_Exchange();
// Create instance of IEWSClient interface by giving credentials
IEWSClient client = EWSClient.GetEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.ListMessages(client.MailboxInfo.InboxUri);

// Loop through the collection to get Message URI
foreach (ExchangeMessageInfo msgInfo in msgCollection)
{
    string strMessageURI = msgInfo.UniqueUri;

    // Now save the message in disk
    client.SaveMessage(strMessageURI, dataDir + msgInfo.MessageId + "out.eml");
}

ذخیرهٔ پیام‌ها به‌صورت Memory Stream

به‌جای ذخیرهٔ فایل‌های EML روی دیسک، می‌توانید آن را در یک استریم حافظه ذخیره کنید. این کار زمانی مفید است که می‌خواهید استریم را در یک مکان ذخیره‌سازی مانند یک پایگاه داده ذخیره کنید. پس از ذخیرهٔ استریم در پایگاه داده، می‌توانید فایل EML را دوباره در MailMessage کلاس. قطعه کد زیر نشان می‌دهد که چگونه پیام‌ها را از یک صندوق ایمیل سرور Exchange به یک استریم حافظه با استفاده از EWS ذخیره کنید.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
string datadir = RunExamples.GetDataDir_Exchange();
// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.GetEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.ListMessages(client.MailboxInfo.InboxUri);

// Loop through the collection to get Message URI
foreach (ExchangeMessageInfo msgInfo in msgCollection)
{
    string strMessageURI = msgInfo.UniqueUri;

    // Now save the message in memory stream
    MemoryStream stream = new MemoryStream();
    client.SaveMessage(strMessageURI, datadir + stream);
}

ذخیرهٔ پیام‌ها به‌صورت MSG

این IEWSClient.SaveMessage() متد می‌تواند پیام را مستقیماً در قالب EML ذخیره کند. برای ذخیرهٔ پیام‌ها در قالب MSG، ابتدا متد IEWSClient.FetchMessage() متدی که یک نمونه از آن را برمی‌گرداند MailMessage کلاس. سپس فراخوانی کنید MailMessage.Save() متد برای ذخیرهٔ پیام به فرمت MSG. قطعه کد زیر نشان می‌دهد چطور پیام‌ها را از صندوق پستی سرور Exchange دریافت کنید و با استفاده از EWS در قالب MSG ذخیره کنید.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.GetEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.ListMessages(client.MailboxInfo.InboxUri);

int count = 0;
// Loop through the collection to get Message URI
foreach (ExchangeMessageInfo msgInfo in msgCollection)
{
    string strMessageURI = msgInfo.UniqueUri;
    
    // Now get the message details using FetchMessage() and Save message as Msg 
    MailMessage message = client.FetchMessage(strMessageURI);
    message.Save(dataDir + (count++) + "_out.msg", SaveOptions.DefaultMsgUnicode);
}

در حال دریافت پیام‌ها

دریافت پیام‌ها بر اساس URI

یک پیام ایمیل توسط شناسهٔ یکتا، URI، نمایانده می‌شود و بخش جدایی‌ناپذیر ExchangeMessageInfo شیء. در صورتی که فقط URI پیام در دسترس باشد، سپس ExchangeMessageInfo شیء را می‌توان با استفاده از این اطلاعات در دسترس نیز بازیابی کرد. نسخهٔ بیش‌بارگذاری شدهٔ ListMessages یک فهرست از شناسه‌ها را برای استفاده می‌گیرد ExchangeMessageInfoCollection. قطعه کد زیر نشان می‌دهد که چگونه‌ ExchangeMessageInfo از URI پیام.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
IEWSClient client = EWSClient.GetEWSClient("https://outlook.office365.com/ews/exchange.asmx", "user@domain.com", "pwd", "domain");

List<string> ids = new List<string>();
List<MailMessage> messages = new List<MailMessage>();

for (int i = 0; i < 5; i++)
{
    MailMessage message = new MailMessage("user@domain.com", "receiver@domain.com", "EMAILNET-35033 - " + Guid.NewGuid().ToString(), "EMAILNET-35033 Messages saved from Sent Items folder doesn't contain 'To' field");
    messages.Add(message);
    string uri = client.AppendMessage(message);
    ids.Add(uri);
}

ExchangeMessageInfoCollection messageInfoCol = client.ListMessages(ids);

foreach (ExchangeMessageInfo messageInfo in messageInfoCol)
{
    // Do something ...
    Console.WriteLine(messageInfo.UniqueUri);
}

دریافت پیام‌ها از صندوق پستی

برای فهرست‌کردن پیام‌ها در یک سرور Exchange ListMessages() متد برای دریافت لیستی از پیام‌ها از صندوق پستی سرور Exchange استفاده می‌شود. این ListMessages() متد اطلاعات پایه درباره پیام‌ها را دریافت می‌کند، برای مثال موضوع، شناسه پیام، فرستنده و گیرنده. برای دریافت جزئیات کامل پیام، Aspose.Email.Exchange ارائه می‌دهد IEWSClient.FetchMessage() متد. این متد URI پیام را به‌عنوان پارامتر می‌پذیرد و یک نمونه از Aspose.Email.MailMessage کلاس. MailMessage کلاس سپس جزئیات پیام مانند بدنه، هدرها و پیوست‌ها را فراهم می‌کند. برای اطلاعات بیشتر دربارهٔ API MailMessage یا نحوه مدیریت ایمیل‌ها با MailMessage کلاس. برای دریافت پیام‌ها از صندوق ایمیل سرور Exchange:

یک نمونه از نوع IEWSClient.
نام سرور، نام کاربر، رمز عبور و دامنه را مشخص کنید.
فراخوانی کنید ListMessages برای دریافت ExchangeMessageInfoCollection.
در حلقه بگردید در ExchangeMessageInfoCollection برای دریافت ExchangeMessageInfo.UniqueURI مقدارها.
فراخوانی کنید IEWSClient.FetchMessage() و ارسال کنید ExchangeMessageInfo.UniqueURI() به‌عنوان پارامتر.

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

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Create instance of ExchangeWebServiceClient class by giving credentials
IEWSClient client = EWSClient.GetEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.ListMessages(client.MailboxInfo.InboxUri);

// Loop through the collection to get Message URI
foreach (ExchangeMessageInfo msgInfo in msgCollection)
{
 String strMessageURI = msgInfo.UniqueUri;

 // Now get the message details using FetchMessage()
 MailMessage msg = client.FetchMessage(strMessageURI);
 
    foreach (Attachment att in msg.Attachments)
 {
  Console.WriteLine("Attachment Name: " + att.Name);
 }
}

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

توجه، FetchItem متد پیام را بدون پیوست‌ها بازمی‌گرداند. برای دریافت پیام‌ها با پیوست‌ها، از FetchItems متد، که در بخش زیر توصیف شده است.

این FetchItem متد بیشتر ترجیح داده می‌شود اگر بخواهید یک MapiMessage و با ویژگی‌های MAPI کار کنید. همچنین می‌توانید از این متد برای دریافت هر آیتم Outlookی مانند مخاطب، قرار ملاقات، کار و غیره استفاده کنید.

IEWSClient client = EWSClient.GetEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Call ListMessages method to list messages info from Contacts folder
ExchangeMessageInfoCollection msgCollection = client.ListMessages(client.MailboxInfo.ContactsUri);

// Loop through the collection to get Message URI
foreach (ExchangeMessageInfo msgInfo in msgCollection)
{
   // Now get the message using FetchItem()
   MapiMessage msg = client.FetchItem(msgInfo.UniqueUri);

   // If necessary, you can cast the MapiMessage to the proper item type to simplify working with its properties.
   MapiContact contact = (MapiContact) msg.ToMapiMessageItem();
}

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

در بالا توصیف شده FetchItem متد پیام را بدون پیوست‌ها برمی‌گرداند تا عملکرد بهبود یابد.

برای دریافت پیام‌ها با پیوست، از روش قدرتمندتر استفاده کنید FetchItems متد که اجازه می‌دهد EwsFetchItems گزینه‌ها.

var uriList = client.ListItems(client.MailboxInfo.InboxUri);
var items = client.FetchItems(EwsFetchItems.Create().AddUris(uriList).WithAttachments());

دریافت آیتم‌ها با پیوست‌ها با استفاده از کلاینت EWS

این FetchItemsمتد (EwsFetchItems options) از EwsClient آیتم‌های ایمیل را از یک سرور Exchange بازیابی می‌کند. یک نمونه از EwsFetchItems کلاس به‌عنوان پارامتر برای تعریف گزینه‌های مختلف برای دریافت آیتم‌ها.

کد زیر نشان می‌دهد چطور آیتم‌های دارای پیوست را دریافت کنید:

// Call the ListMessages method to retrieve a list of message from the Inbox folder
var messageInfoList = ewsClient.ListMessages(ewsClient.MailboxInfo.InboxUri);

// Create an instance of the EwsFetchItems class and assign it to the options variable
var options = EwsFetchItems.Create();

// Generate a new collection of messages which is then converted to a List.
var uriList = messageInfoList.Select(item => item.UniqueUri).ToList();

// Fetch only messages containing attachments
var items = ewsClient.FetchItems(options.AddUris(uriList).WithAttachments());

پیش‌دریافت اندازه پیام

Microsoft Outlook InterOp قابلیت دریافت اندازه پیام را پیش از دریافت کامل پیام از سرور فراهم می‌کند. در مورد Aspose.Email API، اطلاعات خلاصه دریافت‌شده از سرور Exchange توسط ExchangeMessageInfo کلاس. این ویژگی برای دریافت اندازه پیام با استفاده از Size ویژگی. برای دریافت اندازه پیام، فراخوانی استاندارد به IEWSClient.ListMessages است که مجموعه‌ای از ExchangeMessageInfo. قطعه کد زیر نشان می‌دهد چگونه اندازه پیام را با استفاده از ExchangeMessageInfo کلاس.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Create instance of ExchangeWebServiceClient class by giving credentials
IEWSClient client = EWSClient.GetEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.ListMessages(client.MailboxInfo.InboxUri);

// Loop through the collection to display the basic information
foreach (ExchangeMessageInfo msgInfo in msgCollection)
{
    Console.WriteLine("Subject: " + msgInfo.Subject);
    Console.WriteLine("From: " + msgInfo.From.ToString());
    Console.WriteLine("To: " + msgInfo.To.ToString());
    Console.WriteLine("Message Size: " + msgInfo.Size);
    Console.WriteLine("==================================");
}

بارگیری بازگشتی پیام‌ها

این EWSClient ListSubFolders() متد می‌تواند برای دریافت پیام‌ها از پوشه‌ها و زیربخش‌ها در یک صندوق پستی سرور Exchange به‌صورت بازگشتی استفاده شود. این نیاز به Exchange Server 2007 یا بالاتر دارد، زیرا از EWS استفاده می‌کند. قطعه کد زیر نشان می‌دهد چگونه تمام صندوق پستی (پوشه‌ها و زیربخش‌ها) یک سرور Exchange را دانلود کنید. ساختار پوشه‌ها به‌صورت محلی ایجاد می‌شود و تمام پیام‌ها دانلود می‌شوند.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
static string username = "administrator";
static string password = "pwd";
static string domain = "ex2010.local";
private static string dataDir = RunExamples.GetDataDir_Exchange();
public static void Run()
{
    // Register callback method for SSL validation event
    ServicePointManager.ServerCertificateValidationCallback += RemoteCertificateValidationHandler;
    try
    {
        DownloadAllMessages();
    }
    catch (Exception ex)
    {
        Console.WriteLine(ex.Message);
    }
}

private static void DownloadAllMessages()
{
    try
    {
        string rootFolder = domain + "-" + username;
        Directory.CreateDirectory(rootFolder);
        string inboxFolder = rootFolder + "\\Inbox";
        Directory.CreateDirectory(inboxFolder);

        Console.WriteLine("Downloading all messages from Inbox....");
        // Create instance of IEWSClient class by giving credentials
        IEWSClient client = EWSClient.GetEWSClient("https://outlook.office365.com/ews/exchange.asmx", username, password, domain);

        ExchangeMailboxInfo mailboxInfo = client.GetMailboxInfo();
        Console.WriteLine("Mailbox URI: " + mailboxInfo.MailboxUri);
        string rootUri = client.GetMailboxInfo().RootUri;
        // List all the folders from Exchange server
        ExchangeFolderInfoCollection folderInfoCollection = client.ListSubFolders(rootUri);
        foreach (ExchangeFolderInfo folderInfo in folderInfoCollection)
        {
            // Call the recursive method to read messages and get sub-folders
            ListMessagesInFolder(client, folderInfo, rootFolder);
        }

        Console.WriteLine("All messages downloaded.");
    }
    catch (Exception ex)
    {
        Console.WriteLine(ex.Message);
    }
}

// Recursive method to get messages from folders and sub-folders
private static void ListMessagesInFolder(IEWSClient client, ExchangeFolderInfo folderInfo, string rootFolder)
{
    // Create the folder in disk (same name as on IMAP server)
    string currentFolder = rootFolder + "\\" + folderInfo.DisplayName;
    Directory.CreateDirectory(currentFolder);

    // List messages
    ExchangeMessageInfoCollection msgInfoColl = client.ListMessages(folderInfo.Uri);
    Console.WriteLine("Listing messages....");
    int i = 0;
    foreach (ExchangeMessageInfo msgInfo in msgInfoColl)
    {
        // Get subject and other properties of the message
        Console.WriteLine("Subject: " + msgInfo.Subject);

        // Get rid of characters like ? and :, which should not be included in a file name
        string fileName = msgInfo.Subject.Replace(":", " ").Replace("?", " ");

        MailMessage msg = client.FetchMessage(msgInfo.UniqueUri);
        msg.Save(dataDir + "\\" + fileName + "-" + i + ".msg");
  
        i++;
    }
    Console.WriteLine("============================\n");
    try
    {
        // If this folder has sub-folders, call this method recursively to get messages
        ExchangeFolderInfoCollection folderInfoCollection = client.ListSubFolders(folderInfo.Uri);
        foreach (ExchangeFolderInfo subfolderInfo in folderInfoCollection)
        {
            ListMessagesInFolder(client, subfolderInfo, currentFolder);
        }
    }
    catch (Exception)
    {
    }
}
private static bool RemoteCertificateValidationHandler(object sender, X509Certificate certificate, X509Chain chain, SslPolicyErrors sslPolicyErrors)
{
    return true; // Ignore the checks and go ahead
}

بارگیری پیام‌ها از پوشه‌های عمومی

Microsoft Exchange Server به کاربران اجازه می‌دهد پوشه‌های عمومی ایجاد کنند و پیام‌ها را در آن‌ها قرار دهند. برای انجام این کار از طریق برنامهٔ خود، از Aspose.Email استفاده کنید EWSClient کلاسی برای اتصال به سرور Exchange و خواندن و دانلود پیام‌ها و پست‌ها از پوشه‌های عمومی. قطعهٔ کد زیر نشان می‌دهد چطور تمام پوشه‌های عمومی و زیرپوشه‌ها را خوانده و هر پیام موجود در این پوشه‌ها را فهرست و دانلود کنید. این مثال فقط با Microsoft Exchange Server 2007 یا بالاتر کار می‌کند زیرا تنها این نسخه‌ها EWS را پشتیبانی می‌کنند.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
public static string dataDir = RunExamples.GetDataDir_Exchange();
public static string mailboxUri = "https://exchange/ews/exchange.asmx"; // EWS
public static string username = "administrator";
public static string password = "pwd";
public static string domain = "ex2013.local";

public static void Run()
{
    try
    {
        ReadPublicFolders();
    }
    catch (Exception ex)
    {
        Console.WriteLine(ex.Message);
    }
}

private static void ReadPublicFolders()
{
    NetworkCredential credential = new NetworkCredential(username, password, domain);
    IEWSClient client = EWSClient.GetEWSClient(mailboxUri, credential);

    ExchangeFolderInfoCollection folders = client.ListPublicFolders();
    foreach (ExchangeFolderInfo publicFolder in folders)
    {
        Console.WriteLine("Name: " + publicFolder.DisplayName);
        Console.WriteLine("Subfolders count: " + publicFolder.ChildFolderCount);
        ListMessagesFromSubFolder(publicFolder, client);

    }
}

private static void ListMessagesFromSubFolder(ExchangeFolderInfo publicFolder, IEWSClient client)
{
    Console.WriteLine("Folder Name: " + publicFolder.DisplayName);
    ExchangeMessageInfoCollection msgInfoCollection = client.ListMessagesFromPublicFolder(publicFolder);
    foreach (ExchangeMessageInfo messageInfo in msgInfoCollection)
    {
        MailMessage msg = client.FetchMessage(messageInfo.UniqueUri);
        Console.WriteLine(msg.Subject);
        msg.Save(dataDir +  msg.Subject + ".msg",  SaveOptions.DefaultMsgUnicode);
    }

    // Call this method recursively for any subfolders
    if (publicFolder.ChildFolderCount > 0)
    {
        ExchangeFolderInfoCollection subfolders = client.ListSubFolders(publicFolder);
        foreach (ExchangeFolderInfo subfolder in subfolders)
        {
            ListMessagesFromSubFolder(subfolder, client);
        }
    }
}

انتقال پیام‌ها

می‌توانید پیام‌های ایمیل را از یک پوشه به پوشه دیگر با کمک IEWSClient رابط Move متد. پارامترهای زیر را می‌گیرد:

URI منحصر به‌فرد پیام مورد نظر برای انتقال.
URI منحصر به‌فرد پوشه مقصد.

انتقال پیام‌ها بین پوشه‌ها

قطعه کد زیر نحوه انتقال یک پیام در صندوق‌صندوق ایمیل از پوشه Inbox به پوشه‌ای به نام Processed را نشان می‌دهد. در این مثال، برنامه:

پیام‌ها را از پوشهٔ Inbox می‌خواند.
برخی از پیام‌ها را بر اساس معیارهای خاصی پردازش می‌کند (در این مثال، یک کلمه کلیدی در موضوع پیام جستجو می‌شود).
پیام‌هایی که شرط داده‌شده را برآورده می‌کنند به پوشه پردازش‌شده منتقل می‌کند.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Create instance of IEWSClient class by giving credentials
IEWSClient client = EWSClient.GetEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

ExchangeMailboxInfo mailboxInfo = client.GetMailboxInfo();

// List all messages from Inbox folder
Console.WriteLine("Listing all messages from Inbox....");
ExchangeMessageInfoCollection msgInfoColl = client.ListMessages(mailboxInfo.InboxUri);
foreach (ExchangeMessageInfo msgInfo in msgInfoColl)
{
    // Move message to "Processed" folder, after processing certain messages based on some criteria
    if (msgInfo.Subject != null &&
        msgInfo.Subject.ToLower().Contains("process this message") == true)
    {
        client.MoveItem(mailboxInfo.DeletedItemsUri, msgInfo.UniqueUri); // EWS
        Console.WriteLine("Message moved...." + msgInfo.Subject);
    }
    else
    {
        // Do something else
    }
}

حذف پیام‌ها

می‌توانید پیام‌های ایمیل را از یک پوشه با کمک ExchangeClient کلاس DeleteMessage متد. یک URI منحصر به‌فرد از پیام را به‌عنوان پارامتر می‌گیرد.

قطعه کد زیر نشان می‌دهد که چگونه یک پیام را از پوشه Inbox حذف کنید. برای هدف این مثال، کد:

پیام‌ها را از پوشهٔ Inbox می‌خواند.
پیام‌ها را بر اساس برخی معیارها پردازش می‌کند (در این مثال، کلمه‌کلیدی در موضوع پیام را پیدا می‌کنیم).
پیام را حذف می‌کند.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
            
// Create instance of IEWSClient class by giving credentials
IEWSClient client = EWSClient.GetEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

ExchangeMailboxInfo mailboxInfo = client.GetMailboxInfo();

// List all messages from Inbox folder
Console.WriteLine("Listing all messages from Inbox....");
ExchangeMessageInfoCollection msgInfoColl = client.ListMessages(mailboxInfo.InboxUri);
foreach (ExchangeMessageInfo msgInfo in msgInfoColl)
{
    // Delete message based on some criteria
    if (msgInfo.Subject != null && msgInfo.Subject.ToLower().Contains("delete") == true)
    {
        client.DeleteItem(msgInfo.UniqueUri, DeletionOptions.DeletePermanently); // EWS
        Console.WriteLine("Message deleted...." + msgInfo.Subject);
    }
    else
    {
        // Do something else
    }
}

کپی پیام‌ها

API Aspose.Email امکان کپی یک پیام از یک پوشه به پوشهٔ دیگر را با استفاده از CopyItem متد. نسخهٔ بارگذاری‌شدهٔ این متد URI یکتا پیام کپی‌شده را همان‌طور که در این مقاله نشان داده شده است، برمی‌گرداند.

کپی پیام‌ها به پوشهٔ دیگر

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

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
try
{
    // Create instance of EWSClient class by giving credentials
    IEWSClient client = EWSClient.GetEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
    MailMessage message = new MailMessage("from@domain.com", "to@domain.com", "EMAILNET-34997 - " + Guid.NewGuid().ToString(), "EMAILNET-34997 Exchange: Copy a message and get reference to the new Copy item");
    string messageUri = client.AppendMessage(message);
    string newMessageUri = client.CopyItem(messageUri, client.MailboxInfo.DeletedItemsUri);
}
catch (Exception ex)
{
    Console.WriteLine(ex.Message);
}

Net: فیلتر و مرتب‌سازی پیام‌ها در صندوق‌پست سرور اکسچینج با استفاده از EWS

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

Aspose.Email برای .NET امکان فیلتر کردن پیام‌ها از صندوق‌پست اکسچینج را با استفاده از EWSClient و ExchangeQueryBuilder فراهم می‌کند. پیام‌ها می‌توانند بر اساس معیارهای مختلفی همچون تاریخ، دامنه، شناسه پیام و اعلان‌های تحویل ایمیل فیلتر شوند. این مقاله نشان می‌دهد چگونه پیام‌ها را از سرور اکسچینج با استفاده از معیارهای مختلف فیلتر کنید.

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

این IEWSClient اینترفیس فراهم می‌کند ListMessages() متدی که تمام پیام‌ها را از یک صندوق پستی دریافت می‌کند. برای دریافت تنها پیام‌هایی که شرطی را برآورده می‌کنند، از نسخهٔ overloaded استفاده کنید. ListMessages() متدی که MailQuery کلاس به عنوان آرگومان. MailQuery کلاس ویژگی‌های متنوعی برای مشخص کردن شرایط ارائه می‌دهد، برای مثال تاریخ، موضوع، فرستنده و گیرنده. علاوه بر این، API امکان اعمال فیلترهای حساس به حروف بزرگ/کوچک هنگام دریافت ایمیل‌ها از صندوق پستی را نیز فراهم می‌کند.

فیلتر پیام‌ها بر اساس معیار

برای دریافت پیام‌های فیلتر شده از یک صندوق‌پستی:

به سرور Exchange متصل شوید.
یک نمونه از MailQuery و ویژگی‌های موردنظر را تنظیم کنید.
متد را فراخوانی کنید IEWSClient.ListMessages() متد و پاس دهید MailQuery در پارامترها برای دریافت فقط پیام‌های فیلترشده.

قطعه کد زیر نشان می‌دهد چگونه به یک صندوق ایمیل IMAP متصل شوید و پیام‌هایی که رشته "Newsletter" در موضوع دارند و امروز ارسال شده‌اند را دریافت کنید.

بر اساس تاریخ امروز

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

بر اساس بازهٔ تاریخی

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

بر اساس فرستنده

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

بر اساس دامنه

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

بر اساس گیرنده

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

بر اساس شناسه پیام

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

بر اساس اعلان‌های تحویل ایمیل

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

بر اساس اندازه پیام

ساخت پرس‌وجوهای پیچیده

اگر متفاوت MailQueryBuilder ویژگی‌ها در یک بیان جداگانه تنظیم می‌شوند، همه شرایط مطابقت می‌یابند. برای مثال، برای دریافت پیامی در یک بازه تاریخی خاص و از یک میزبان مشخص، سه بیان بنویسید:

ترکیب پرس‌وجوها با AND

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

ترکیب پرس‌وجوها با OR

MailQueryBuilder ارائه می‌دهد Or() متد که دو MailQuery نمونه‌ها به‌عنوان پارامترها. پیام‌هایی که هر یک از دو شرط مشخص‌شده را برآورده می‌کنند، دریافت می‌کند. مثال زیر پیام‌هایی را فیلتر می‌کند که یا کلمه "test" در موضوع دارند یا "noreply@host.com" به‌عنوان فرستنده. قطعه کد زیر نشان می‌دهد چگونه پرس‌وجوها را با OR ترکیب کنید.

فیلتر ایمیل حساس به حروف

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

فیلتر کردن پیام‌ها با پشتیبانی از صفحه‌بندی

مرتب‌سازی پیام‌های فیلتر شده به ترتیب صعودی/نزولی

فیلتر ایمیل می‌تواند با مرتب‌سازی پیام‌ها به ترتیب صعودی/نزولی پشتیبانی شود. در این حالت، OrderBy متد برای مشخص کردن ترتیب مرتب‌سازی نتایج جستجوی ایمیل با استفاده از کلاس MailQueryBuilder استفاده می‌شود. این متد به شما امکان می‌دهد معیارهای مرتب‌سازی برای یک پرس‌وجو تعریف کنید و تعیین کنید که نتایج بر اساس یک ویژگی خاص به ترتیب صعودی یا نزولی مرتب شوند.

این متد پارامتر ascending را می‌پذیرد که ترتیب مرتب‌سازی برای ویژگی مشخص‌شده را تعیین می‌کند. اگر مقدار ascending true باشد، به این معنی است که نتایج جستجو باید به ترتیب صعودی مرتب شوند. برعکس، اگر مقدار ascending false باشد، به این معنی است که نتایج جستجو باید به ترتیب نزولی مرتب شوند.

MailQueryBuilder builder = new MailQueryBuilder();
builder.Subject.Contains("Report");
builder.InternalDate.Since(new DateTime(2020, 1, 1));
builder.Subject.OrderBy(true); // sort the subject ascending
builder.InternalDate.OrderBy(false); // sort the date descending

MailQuery query = builder.GetQuery();

// Get list of messages
ExchangeMessageInfoCollection messages = client.ListMessages(client.MailboxInfo.InboxUri, query, false);

در قطعه کد بالا، متد OrderBy دو بار اعمال می‌شود، یک بار برای موضوع و یک بار برای تاریخ ایمیل‌ها. با اجرای متد ListMessages همراه با درخواست ارسال‌شده، لیستی از پیام‌ها دریافت می‌کنیم که موضوع آنها شامل واژهٔ "Report" بوده و در تاریخ مشخص یا پس از آن دریافت شده‌اند. همزمان، نتایج بر اساس موضوع به صورت صعودی مرتب می‌شوند؛ به این معنا که پیام‌ها بر حسب الفبا از A تا Z بر اساس موضوعشان مرتب می‌شوند. همچنین، نتایج بر اساس تاریخ به صورت نزولی مرتب می‌شوند؛ به این معنی که پست‌ها از جدیدترین به قدیمی‌ترین ترتیب می‌یابند.

فیلتر کردن پیام‌ها با استفاده از AQS

با Aspose.Email برای .NET، کاربران می‌توانند از قابلیت‌های قدرتمند Advanced Query Syntax (AQS) برای فیلتر کردن مستقیم پیام‌ها از صندوق‌پست اکسچینج استفاده کنند. AQS روشی مستحکم و بصری برای ساخت پرس‌و‌جوهایی فراهم می‌کند که می‌توانند به‌دقت ایمیل‌ها را بر اساس معیارهای خاصی مانند تاریخ، فرستنده و موضوع هدف قرار دهند. برای دریافت جزئیات بیشتر دربارهٔ ادغام آن در فرآیندهای فیلتر ایمیل شما و نمونه‌های کد جامع برای پیاده‌سازی فیلتر پیام با استفاده از AQS در Aspose.Email برای .NET، لطفاً به فیلتر پیام‌ها با AQS از صندوق پست Exchange مقاله.

Net: فیلتر پیام‌ها با AQS از صندوق پست Exchange

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

سینتکس پیشرفتهٔ پرس‌وجو (AQS) یک سینتکس پرس‌وجو است که توسط Exchange به عنوان جایگزینی برای فیلترهای جستجو برای بیان معیارهای جستجو استفاده می‌شود. AQS روشی انعطاف‌پذیرتر برای انجام جستجوها و ارائه نتایج جستجو برای تمام فیلدهای معمولاً مورد استفاده در آیتم‌ها است. AQS همچنین کاربرپسند، آسان برای فهمیدن و سریع برای تسلط است. استفاده از AQS برای یافتن پیام‌ها بر اساس پیوست‌ها و دریافت‌کنندگان مناسب است.

ایجاد پرس‌وجوهای جستجوی AQS

می‌توانید با AQS یک پرس‌وجو جستجو ایجاد کنید:

ExchangeAdvancedSyntaxQueryBuilder، که سازندهٔ عبارت جستجو بر پایهٔ سینتکس پیشرفتهٔ پرس‌وجو (AQS) را نشان می‌دهد. یا
ExchangeAdvancedSyntaxMailQuery، که یک رشته AQS را مستقیماً براساس کلیدواژه‌های پشتیبانی‌شده ایجاد می‌کند.

استفاده از سازنده پرس‌وجو

برای ایجاد یک پرس‌وجو جستجو با ExchangeAdvancedSyntaxQueryBuilder شما باید:

ایجاد یک نمونه از IEWSClient با استفاده از GetEWSClient متد
ایجاد یک نمونه از ExchangeAdvancedSyntaxQueryBuilder و ویژگی‌های لازم را برای ساخت یک پرس‌وجو تنظیم کنید.
فراخوانی ListMessages یا ListItems متد و پاس MailQuery نمونه، برگشت داده شده توسط GetQuery متد، به‌عنوان یکی از پارامترهای آن.

کد نمونه زیر نشان می‌دهد چگونه مراحل فوق می‌توانند انجام شوند:

using (var client = EWSClient.GetEWSClient(...))
{
    var advancedBuilder = new ExchangeAdvancedSyntaxQueryBuilder();
    advancedBuilder.From.Equals("Jim Martin");
    advancedBuilder.Subject.Contains("report");
    advancedBuilder.HasAttachment.Equals(true);

    var messages = client.ListMessages(client.MailboxInfo.InboxUri, advancedBuilder.GetQuery());
}

پرس‌وجوهای مستقیم AQS

برای ایجاد یک پرس‌وجو جستجو با ExchangeAdvancedSyntaxMailQuery شما باید:

ایجاد یک نمونه از IEWSClient با استفاده از GetEWSClient متد
ایجاد یک نمونه از ExchangeAdvancedSyntaxMailQuery و یک رشته AQS را پاس دهید. مشاهده کنید توضیح سینتکس.
فراخوانی ListMessages یا ListItems متد و پاس ExchangeAdvancedSyntaxMailQuery نمونه‌ای به عنوان یکی از پارامترهای آن.

کد نمونه زیر نشان می‌دهد چگونه مراحل فوق می‌توانند انجام شوند:

using (var client = EWSClient.GetEWSClient(...))
{
    ExchangeAdvancedSyntaxMailQuery query = new ExchangeAdvancedSyntaxMailQuery("subject:(product AND report)");
    ExchangeMessageInfoCollection messages = client.ListMessages(client.MailboxInfo.InboxUri, query);
}

Net: مدیریت آیتم‌های گفتگو در سرور Exchange

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

می‌توان از Aspose.Email برای .NET برای مدیریت آیتم‌های گفتگو در سرور Exchange با EWSClient کلاس. این کلاس از Exchange Web Services استفاده می‌کند که فقط در Exchange Server 2007 و نسخه‌های بعدی موجود است. این مقاله نشان می‌دهد چگونه پیدا کردن, کپی, جابجایی و حذف موارد مکالمه در Exchange Server 2010. سرویس‌پک 1 Microsoft Exchange Server 2010 برای تمام ویژگی‌های گنجانده‌شده در این بخش مورد نیاز است.

یافتن گفتگوها

برای دریافت اطلاعات مکالمه از یک پوشهٔ خاص در Exchange Server:

اتصال به سرور Exchange با استفاده از IEWSClient واسط.
متد را فراخوانی کنید IEWSClient.FindConversations() متد برای یافتن تمام آیتم‌های گفتگو از یک پوشه.
خواص مورد مکالمه مانند شناسه، موضوع مکالمه و وضعیت پرچم را نمایش دهید.

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

کپی گفتگوها

برای کپی کردن مکالمات از یک پوشه به پوشهٔ دیگر:

اتصال به سرور Exchange با استفاده از IEWSClient واسط.
متد را فراخوانی کنید IEWSClient.CopyConversationItems() متد برای کپی کردن آیتم گفتگو از پوشه مبدأ به پوشه مقصد.

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

جابه‌جا کردن گفتگوها

برای جابجا کردن مکالمات از یک پوشه به پوشهٔ دیگر:

اتصال به سرور Exchange با استفاده از IEWSClient واسط.
متد را فراخوانی کنید IEWSClient.MoveConversationItems() متد برای جابه‌جایی یک گفتگو از پوشه مبدأ به پوشه مقصد.

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

حذف گفتگوها

برای حذف مکالمات از یک پوشه:

اتصال به سرور Exchange با استفاده از IEWSClient واسط.
متد را فراخوانی کنید IEWSClient.DeleteConversationItems() متد برای حذف آیتم گفتگو از پوشه مبدأ.

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

Net: مدیریت موارد تقویم با استفاده از Exchange Web Services (EWS) با C#

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

ارسال درخواست‌های جلسه

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

ایجاد یک درخواست جلسه با استفاده از Appointment کلاس و تنظیم مکان، زمان و شرکت‌کنندگان.
یک نمونه از MailMessage کلاس و تنظیم قرار ملاقات با استفاده از MailMessage.AddAlternateView() متد.
به سرور Exchange متصل شوید و درخواست جلسه را با استفاده از Send(MailMessage) متد.

این EWSClient کلاس می‌تواند برای اتصال به سرور اکسچینج با پشتیبانی از Exchange Web Services (EWS) استفاده شود. برای اینکه این کار انجام شود، سرور باید Exchange Server 2007 یا نسخهٔ بالاتر باشد. قطعه کد زیر نشان می‌دهد چگونه از EWS برای ارسال درخواست‌های جلسه استفاده کنید.

مدیریت موارد تقویم از طریق EWS

Aspose.Email امکان افزودن، به‌روزرسانی و لغو قرارها را با استفاده از مشتری Exchange Web Service (EWS) فراهم می‌کند. IEWSClient CreateAppointment, UpdateAppointment، و CancelAppointment متدها امکان دستکاری موارد تقویم با استفاده از EWS را فراهم می‌کنند. این مقاله یک نمونه کد دقیق برای کار با موارد تقویم ارائه می‌دهد. قطعه کد زیر نشان می‌دهد چگونه:

یک قرار ملاقات ایجاد کنید.
به‌روزرسانی یک تقویم.
حذف/لغو یک تقویم.

فهرست‌گذاری قرارها با پشتیبانی از صفحه بندی

متد ListAppointments ارائه‌شده توسط IEWSClient API فهرست کامل قرارها را از سرور اکسچینج دریافت می‌کند. اگر تعداد زیادی قرار در سرور اکسچینج باشد، ممکن است زمان‌بر باشد. API متدهای overload شده‌ای از ListAppointments متدی که پشتیبانی از صفحه‌بندی را به عملیات می‌دهد. این می‌تواند در ترکیب‌های مختلف با ویژگی جستجو نیز استفاده شود. متدهای overloaded زیر برای لیست کردن تقویم‌ها از سرور Exchange با پشتیبانی از صفحه‌بندی موجود هستند.

AppointmentCollection IEWSClient.ListAppointments(int itemsPerPage).
AppointmentCollection IEWSClient.ListAppointments(string folderUri, int itemsPerPage).
AppointmentCollection IEWSClient.ListAppointments(MailQuery query, int itemsPerPage).
AppointmentCollection IEWSClient.ListAppointments(string folderUri, MailQuery query, int itemsPerPage).
AppointmentCollection IEWSClient.ListAppointments(int itemsPerPage, int itemOffset).
AppointmentCollection IEWSClient.ListAppointments(string folderUri, int itemsPerPage, int itemOffset).
AppointmentCollection IEWSClient.ListAppointments(MailQuery query, int itemsPerPage, int itemOffset).
AppointmentCollection IEWSClient.ListAppointments(string folderUri, MailQuery query, int itemsPerPage, int itemOffset).

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

افزودن رویداد به پوشه تقویم ثانویه

API Aspose.Email به شما امکان می‌دهد یک پوشهٔ تقویم ثانویه را در سرور Exchange با استفاده از IEWSClient. سپس تقویم‌ها می‌توانند از تقویم ثانویه با استفاده از CreateAppointment, UpdateAppointment و CancelAppointment متدها. متدها و ویژگی‌های API زیر در نمونه کدهای زیر برای نشان دادن عملکرد این ویژگی استفاده می‌شوند. لطفاً توجه داشته باشید که این ویژگی از Aspose.Email برای .NET نسخه 6.5.0 به بعد پشتیبانی می‌شود.

متد IEWSClient.CancelAppointment(Appointment, String).
متد IEWSClient.CancelAppointment(String, String).
متد IEWSClient.CreateAppointment(Appointment, String).
متد IEWSClient.CreateFolder(String, String, ExchangeFolderPermissionCollection, String).
متد IEWSClient.FetchAppointment(String, String).
متد IEWSClient.UpdateAppointment(Appointment, String).
ویژگی IEWSClient.CurrentCalendarFolderUri.

قطعه کد زیر نشان می‌دهد چگونه یک رویداد را به پوشهٔ تقویم ثانویه در سرور Exchange اضافه کنید.

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

سرور Microsoft Exchange امکان به اشتراک‌گذاری تقویم‌ها را با ارسال دعوتنامه‌های تقویم به کاربران دیگر که در همان سرور Exchange ثبت‌نام کرده‌اند، فراهم می‌کند. API Aspose.Email همین قابلیت را با اجازهٔ به اشتراک‌گذاری تقویم با استفاده از API EWS فراهم می‌سازد.

دریافت ویژگی‌های گسترش یافته

بازگرداندن موارد تقویم تکراری

EWSClient از بازگرداندن موارد تقویم تکراری در بازه‌ای که توسط StartDate و EndDate مشخص شده پشتیبانی می‌کند. AppointmentQueryBuilder.SetCalendarView متد برای تعیین بازهٔ زمانی خاص و محدود کردن تعداد قرارهای بازگردانده‌شده به منظور استخراج اطلاعات مرتبط استفاده می‌شود. با تنظیم پارامترهای زیر می‌توانید قرارهایی که با معیارهای مشخص شده هم‌خوانی دارند را بازیابی کنید.

startDate: تاریخ شروع نمای تقویم. قرارهایی که از این تاریخ آغاز می‌شوند در نتیجهٔ پرس‌وجو گنجانده می‌شوند.
endDate: تاریخ پایان نمای تقویم. قرارهایی که تا قبل یا در این تاریخ تمام می‌شوند در نتیجهٔ پرس‌وجو گنجانده می‌شوند.
maxEntriesReturned: حداکثر تعداد قرارهایی که در نتیجهٔ پرس‌وجو بازگردانده می‌شوند. مقدار −1 نشان‌دهنده این است که محدودیت خاصی وجود ندارد.

ExchangeQueryBuilder builder = new ExchangeQueryBuilder();
builder.Appointment.SetCalendarView(DateTime.Now, DateTime.Now.AddMonths(1), -1);

Appointment[] appointments = client.ListAppointments(builder.GetQuery());

فیلتر قرارها

این IEWSClient امکان فیلتر کردن قرارها از سرور Exchange با استفاده از ExchangeQueryBuilder. قرارها می‌توانند بر اساس موارد زیر فیلتر شوند:

تاریخ‌ها
تکرارها

فیلتر قرارها بر اساس تاریخ‌ها

فیلتر قرارها بر اساس رویدادهای تکراری

Net: مدیریت مخاطبین در سرور Exchange با استفاده از EWS

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

حساب‌های Exchange Server بیشتر از پیام‌های ایمیل را نگهداری می‌کنند. همچنین دریافت, انتقال, ارسال و حذف پیام‌های ایمیل از سرورهای Exchange، Aspose.Email به شما امکان کار با مخاطبین را می‌دهد. این مقاله توضیح می‌دهد چگونه اطلاعات مخاطب را با استفاده از Exchange Web Services بازیابی کنید. همچنین نشان می‌دهد چگونه می‌توانید مخاطبین را از پوشه Contacts فهرست کنید یا مخاطبین را بر اساس نام مخاطب شناسایی کنید.

دریافت مخاطبین با EWS

Aspose.Email ارائه می‌دهد EWSClient کلاس برای اتصال به Microsoft Exchange Server با استفاده از Exchange Web Services. قطعه‌های کد زیر از Exchange Web Services برای خواندن تمام مخاطبین استفاده می‌کنند. قطعه کد زیر نشان می‌دهد چگونه مخاطبین را با EWS دریافت کنید.

یافتن مخاطبین بر اساس نام

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

تعیین فرمت یادداشت مخاطب

Aspose.Email.Mail.Contact.NotesFormat نوع فرمت متن یادداشت‌های مخاطبین را مشخص می‌کند که توسط شمارنده Aspose.Email.TextFormat تعریف شده است.

دریافت مخاطبین بر اساس شناسه

یک مخاطب خاص می‌تواند با استفاده از شناسهٔ مخاطب خود از سرور بازیابی شود همان‌طور که در نمونه کد زیر نشان داده شده است.

افزودن مخاطبین

این EWSClient کلاس CreateContact() متد می‌تواند برای افزودن اطلاعات مخاطب به سرور Exchange استفاده شود. CreateContact() متد یک شیء Contact را به‌عنوان پارامتر ورودی می‌گیرد.

برای افزودن مخاطبین به سرور Exchange:

مقداردهی اولیه EWSClient با آدرس و اعتبارنامه‌ها.
شی Contact را با ویژگی‌های موردنظر مقداردهی کنید.
متد CreateContact را صدا بزنید تا مخاطب به سرور Exchange اضافه شود.

Aspose.Email ارائه می‌دهد EWSClient کلاسی برای اتصال به Microsoft Exchange Server با استفاده از Exchange Web Services. قطعه کدها نشان می‌دهند که چگونه از Exchange Web Services برای اضافه کردن مخاطبان به یک Exchange Server استفاده کنید.

به‌روزرسانی مخاطبین

اطلاعات تماس می‌تواند با استفاده از Microsoft Outlook به‌روزرسانی شود. Aspose.Email همچنین می‌تواند اطلاعات تماس را بر روی Exchange Server با استفاده از Exchange Web Service (EWS) به‌روزرسانی کند. The IEWSClient UpdateContact متد می‌تواند اطلاعات مخاطب را در سرور Exchange به‌روزرسانی کند.

حذف مخاطبین

این EWSClient کلاسی که به DeleteContact امکان دسترسی و حذف مخاطبان از پوشه مخاطبان یک Exchange Server را می‌دهد. این متد شناسه تماس یا MapiContact را به‌عنوان پارامتر ورودی می‌گیرد.

برای حذف مخاطبین از یک سرور Exchange:

مقداردهی اولیه ExchangeWebServiceClient با آدرس و اعتبارنامه‌ها.
حذف یک مخاطب با استفاده از شناسه‌ آن.
حذف یک مخاطب با فراخوانی DeleteContact متد با MapiContact به عنوان پارامتر ورودی.

قطعه‌های کد زیر نشان می‌دهند که چگونه مخاطبان را از یک سرور Exchange با استفاده از Exchange Web Service حذف کنید.

کار با ویژگی‌های گسترده تماس


 IEWSClient client = EWSClient.GetEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

//The required extended properties must be added in order to create or read them from the Exchange Server

string[] extraFields = new string[] {{ "User Field 1", "User Field 2", "User Field 3", "User Field 4" }};

foreach (string extraField in extraFields)

    client.ContactExtendedPropertiesDefinition.Add(extraField);

//Create a test contact on the Exchange Server

Contact contact = new Contact();

contact.DisplayName = "EMAILNET-38433 - " + Guid.NewGuid().ToString();

foreach (string extraField in extraFields)

    contact.ExtendedProperties.Add(extraField, extraField);

string contactId = client.CreateContact(contact);

//retrieve the contact back from the server after some time

Thread.Sleep(5000);

contact = client.GetContact(contactId);

//Parse the extended properties of contact

foreach (string extraField in extraFields)

    if (contact.ExtendedProperties.ContainsKey(extraField))

        Console.WriteLine(contact.ExtendedProperties[extraField].ToString());

Net: مدیریت لیست‌های توزیع سرور Exchange با C#

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

API Aspose.Email قابلیت ایجاد و خواندن لیست‌های توزیع را از سرور Exchange فراهم می‌کند. لیست‌های توزیع می‌توانند در سرور ایجاد شوند و اعضا می‌توانند با استفاده از آن اضافه شوند. IEWSClient. این مقاله نشان می‌دهد چگونه با لیست‌های توزیع در سرور Exchange کار کنید.

ایجاد لیست‌های توزیع

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

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

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

ایجاد MailAddress از شناسهٔ لیست

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

گسترش لیست‌های توزیع عمومی

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

اضافه کردن اعضا

اضافه کردن اعضا به فهرست‌های خصوصی

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

اضافه کردن اعضا بدون فهرست کردن

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

ارسال به لیست توزیع خصوصی

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

حذف اعضا

حذف اعضا از فهرست‌های خصوصی

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

حذف اعضا بدون فهرست کردن

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

حذف لیست توزیع خصوصی

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

Net: چگونه پوشه‌های سرور Exchange را با EWS مدیریت کنیم

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

فهرست تمام پوشه‌ها از سرور

API Aspose.Email امکان اتصال به Exchange Server و فهرست‌کردن تمام پوشه‌ها و زیرپوشه‌ها را فراهم می‌کند. همچنین می‌توانید تمام زیرپوشه‌ها را به‌صورت بازگشتی از هر پوشه دریافت کنید. این API قابلیت فهرست‌گذاری پوشه‌ها با صفحه‌بندی از کلاینت Exchange با استفاده از Exchange Web Service (EWS) را نیز دارد. این مقاله نشان می‌دهد چگونه تمام زیرپوشه‌ها را از سرور Exchange دریافت کرده و پوشه‌ها را با صفحه‌بندی دریافت کنید.

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

دریافت اطلاعات نوع پوشه

این FolderType خاصیتی که ارائه شده توسط ExchangeFolderInfo کلاسی که می‌تواند اطلاعات مربوط به نوع پوشه را دریافت کند. در نمونه کد زیر نشان داده شده است.

فهرست‌گذاری پوشه‌ها با پشتیبانی از صفحه‌بندی

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

دسترسی به پوشه‌ها/زیرپوشه‌های سفارشی

IEWSClient به توسعه‌دهندگان امکان می‌دهد به هر پوشه یا زیرپوشهٔ سفارشی از صندوق‌پستی دسترسی پیدا کنند. FolderExists() عملکرد IEWSClient URI یک پوشه/ زیرپوشهٔ سفارشی مشخص را برمی‌گرداند که سپس می‌توان برای دسترسی به پوشه هدف از آن استفاده کرد. در مثال زیر، پوشهٔ سفارشی به نام "TestInbox" که زیر پوشهٔ INBOX ایجاد شده است، دسترسی پیدا می‌شود و تمام پیام‌های آن پوشه نمایش داده می‌شوند. برای انجام این کار، مراحل زیر را انجام دهید:

مقداردهی اولیه به IEWSClient شیء با ارائه اعتبارهای معتبر.
به صندوق‌پستی پیش‌فرض دسترسی پیدا کنید.
به پوشهٔ والد دسترسی پیدا کنید، که در این مثال INBOX است. این پوشهٔ والد می‌تواند خود یک پوشهٔ سفارشی نیز باشد.
استفاده کنید FolderExists() برای جستجوی زیرپوشهٔ سفارشی مشخص شده، به عنوان مثال "TestInbox". این متد URI "TestInbox" را برمی‌گرداند.
از این URI برای دسترسی به تمام پیام‌های آن پوشهٔ سفارشی استفاده کنید.

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

فهرست‌گذاری پوشه‌های عمومی

کپی پیام‌ها به پوشهٔ دیگر

API Aspose.Email امکان کپی کردن یک پیام از یک پوشه به پوشهٔ دیگر را با استفاده از CopyItem متد. نسخهٔ بارگذاری‌شدهٔ این متد URI یکتا پیام کپی‌شده را همان‌طور که در این مقاله نشان داده شده است، برمی‌گرداند.

همگام‌سازی آیتم‌های پوشه

Aspose.Email برای .NET API IEWSClient رابطی که قابلیت همگام‌سازی محتویات یک پوشه Exchange را فراهم می‌کند. این SyncFolder متدی که توسط IEWSClient کلاسی که می‌تواند برای انجام اطلاعات همگام‌سازی پوشه روی یک پوشه مشخص استفاده شود. قطعه کد زیر نشان می‌دهد چگونه اطلاعات پوشه Exchange را همگام‌سازی کنید.

دریافت سطوح دسترسی پوشه

کاربران سطوح دسترسی به پوشه‌های عمومی در Exchange Server اختصاص داده می‌شوند که محدوده/سطح دسترسی کاربر به این پوشه‌ها را تعیین می‌کند. این ExchangeFolderPermission کلاسی که مجموعه‌ای از خواص مجوز برای پوشه‌های Exchange مانند PermissionLevel، آیا می‌توانند CanCreateItems, DeleteItems, و انجام وظایف دیگر بر حسب خواص مجوز. می‌توان مجوزها را با استفاده از GetFolderPermissions() متد IEWSClient. این مقاله نشان می‌دهد چگونه مجوزهای اعمال‌شده به یک پوشه عمومی را برای تمام کاربرانی که به پوشه‌های به‌اشتراک‌گذاری شده دسترسی دارند، بازیابی کنید.

برای انجام این کار:

مقداردهی اولیه به EWSClient.
از ListPublicFolders برای دریافت فهرستی از تمام پوشه‌های عمومی
دریافت سطوح دسترسی مرتبط با یک پوشه با استفاده از GetFolderPermisssions() متد

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

ایجاد و مدیریت پوشه‌ها/زیرپوشه‌ها

API Aspose.Email قابلیت ایجاد پوشه‌ها در یک صندوق‌نامه Exchange را فراهم می‌کند. The CreateFolder متد IEWSClient می‌تواند برای این منظور استفاده شود. برای ایجاد یک پوشه در صندوق‌نامه سرور Exchange، می‌توان از مراحل زیر استفاده کرد.

یک نمونه از IEWSClient.
تنظیم UseSlashAsFolderSeparator ویژگی به‌عنوان مورد نیاز. اگر به true تنظیم شود، برنامه "Slash" را به عنوان جداکنندهٔ پوشه در نظر می‌گیرد و زیرپوشه پس از اسلش ایجاد می‌شود.
از CreateFolder متد برای ایجاد پوشه.

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

پشتیبان‌گیری از پوشه‌ها به PST

اغلب کاربران ممکن است بخواهند از تمام یا برخی از پوشه‌های صندوق نامه یک نسخه پشتیبان بگیرند. Aspose.Email امکان پشتیبان‌گیری از تمام یا پوشه‌های صندوق‌نامه Exchange مشخص‌شده به یک فایل PST را فراهم می‌کند. این مقاله توضیح می‌دهد چگونه پوشه‌های Exchange را به PST با کد نمونه پشتیبان‌گیری کنید. برای پشتیبان‌گیری از پوشه‌های سرور Exchange، می‌توان مراحل زیر را دنبال کرد.

راه‌اندازی IEWSClient با اعتبارهای کاربر
اطلاعات مورد نیاز پوشه را به ExchangeFolderInfoCollection
از کلاینت استفاده کنید پشتیبان‌گیری متد برای صادر کردن محتویات پوشه به PST

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

Net: نحوه مدیریت قوانین سرور Exchange با EWS در C#

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

Aspose.Email برای .NET می‌تواند برای مدیریت قوانین بر روی سرور Exchange با استفاده از EWSClient کلاس. این کلاس از Exchange Web Services (EWS) استفاده می‌کند که در Exchange Server 2007 و نسخه‌های بعدی در دسترس هستند. این مقاله نحوه مدیریت قوانین را توضیح می‌دهد:

خواندن قوانینی که قبلاً بر روی سرور هستند.
ایجاد یک قانون جدید.
به‌روزرسانی یک قانون موجود.

Microsoft Exchange Server 2010 Service Pack 1 برای تمام ویژگی‌های توصیف شده در این مقاله مورد نیاز است.

خواندن قوانین

برای دریافت تمام قوانین از سرور Exchange:

اتصال به سرور Exchange با استفاده از IEWSClient کلاس.
متد را فراخوانی کنید IEWSClient.GetInboxRules() متد برای دریافت تمام قوانین.
در یک حلقه foreach، تمام قوانین را مرور کنید و ویژگی‌های قانون مانند شرایط، اقدامات و نام را نمایش دهید.

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

ایجاد قوانین

برای ایجاد یک قانون جدید در سرور Exchange، مراحل زیر را انجام دهید:

اتصال به سرور Exchange با استفاده از IEWSClient واسط.
یک نمونهٔ جدید از InboxRule کلاس و تنظیم ویژگی‌های اجباری زیر:
1. نام نمایشی
2. شرایط
3. اقدامات
متد را فراخوانی کنید IEWSClient.CreateInboxRule() متد برای ایجاد قانون.

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

به‌روزرسانی قوانین

برای به‌روز کردن یک قانون در سرور Exchange:

اتصال به سرور Exchange با استفاده از IEWSClient کلاس.
متد را فراخوانی کنید IEWSClient.GetInboxRules() متد برای دریافت تمام قوانین.
در یک حلقه foreach، تمام قوانین را مرور کرده و قانون موردنظر را با مطابقت نام نمایشی (DisplayName) در شرط بدست آورید.
به‌روزرسانی ویژگی‌های قانون.
متد را فراخوانی کنید IEWSClient.UpdateInboxRule() متد برای به‌روزرسانی قانون.

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

Net: مدیریت وظایف سرور Exchange با استفاده از EWS در زبان C#

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

Aspose.Email از پردازش کارها روی Exchange با استفاده از ExchangeTask کلاس. ویژگی‌های مختلفی که توسط آن ارائه می‌شوند ExchangeTask, مانند Subject, وضعیت, تاریخ مهلت، و اولویت، می‌تواند برای پیکربندی وظیفه در Exchange استفاده شود. The EWSClient کلاس توابعی مانند را معرض می‌کند CreateTask, UpdateTask، و DeleteTask که برای پردازش وظایف در Exchange استفاده می‌شوند. این مقاله نشان می‌دهد چگونه:

ایجاد یک وظیفه جدید.
تنظیم منطقه زمانی یک وظیفه.
به‌روزرسانی یک وظیفه.
حذف یک وظیفه.
ارسال درخواست وظیفه
ذخیرهٔ وظیفه در دیسک

ایجاد وظایف

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

مشخص کردن منطقهٔ زمانی

این IEWSClient رابط و ExchangeTask ارائهٔ TimeZoneId ویژگی برای تنظیم اطلاعات منطقهٔ زمانی هنگام ایجاد یک وظیفه. قطعه کد زیر نشان می‌دهد چگونه منطقهٔ زمانی را مشخص کنید.

به‌روزرسانی وظایف

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

حذف وظایف

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

ارسال درخواست‌های وظیفه

سرویس Aspose.Email Exchange امکان ارسال درخواست‌های وظیفه مشابه Outlook را فراهم می‌کند. قطعه کد زیر نشان می‌دهد چگونه یک پیام درخواست وظیفه را از دیسک بارگذاری کرده و با استفاده از آن ارسال کنید. IEWSClient.

ذخیرهٔ وظایف بر روی دیسک

Aspose.Email همچنین امکان ذخیرهٔ وظایف Exchange در دیسک به فرمت Outlook MSG را می‌دهد. قطعه کد زیر نشان می‌دهد چگونه یک وظیفه را در دیسک ذخیره کنید.

فهرست‌کردن وظایف

IEWSClient ارائه می‌دهد ListTasks متدی که می‌تواند وظایف را از یک Exchange Web Service بازیابی کند. این متد چند overload دارد که می‌توان برای دریافت فهرست وظایف از یک پوشه خاص یا با استفاده از برخی معیارهای جستجو استفاده کرد. نمونه کد زیر بدست آوردن همه یا وظایف خاص از پوشه Tasks را نشان می‌دهد.

فیلتر کردن وظایف

Aspose.Email امکان بازیابی وظایف خاص از سرور را به جای بازیابی تمام وظایف فراهم می‌کند. این API می‌تواند برای بازیابی وظایف بر اساس وضعیت آن‌ها مانند تکمیل‌شده، به تعویق‌افتاده، در حال پیشرفت، شروع‌نشده یا منتظر دیگران استفاده شود. ExchangeQueryBuilder کلاس می‌تواند برای تعیین معیار دلخواه با استفاده از ویژگی Status استفاده شود. همچنین امکان تعیین چندین شرط برای دریافت وظایف دلخواه از سرور Exchange را می‌دهد. این در نمونه کد زیر نشان داده شده است.

Net: مدیریت پیکربندی‌های کاربر در سرور Exchange با استفاده از EWS در C#

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

می‌توان از Aspose.Email برای .NET برای مدیریت پیکربندی کاربر بر روی سرور Exchange با EWSClient کلاس. این کلاس از Exchange Web Services استفاده می‌کند که فقط در Exchange Server 2007 و نسخه‌های بعدی موجود است. در این مقاله، نحوهٔ خواندن، ایجاد، به‌روزرسانی و حذف پیکربندی‌های کاربر در Exchange Server 2010 را می‌بینیم. سرویس پک 1 Exchange Server 2010 برای تمام ویژگی‌های توضیح‌داده‌شده در این مقاله لازم است. قطعه کد زیر نشان می‌دهد چگونه در تمام مثال‌های این مقاله به Exchange Server 2010 متصل شوید.

خواندن پیکربندی‌های کاربر

برای دریافت اطلاعات پیکربندی کاربر یک پوشهٔ خاص از Exchange Server:

اتصال به سرور Exchange با استفاده از IEWSClient واسط.
متد را فراخوانی کنید IEWSClient.GetUserConfiguration() متد برای دریافت پیکربندی کاربر برای یک پوشه.
خواص پیکربندی کاربر مانند شناسه، نام و آیتم‌های دیکشنری را به صورت جفت کلید‑مقدار نمایش دهید.

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

ایجاد پیکربندی‌های کاربر

برای ایجاد پیکربندی کاربر برای یک پوشهٔ خاص در Exchange Server:

اتصال به سرور Exchange با استفاده از IEWSClient واسط.
متد را فراخوانی کنید IEWSClient.CreateUserConfiguration() متد برای ایجاد پیکربندی کاربر برای یک پوشه.

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

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

برای به‌روزرسانی پیکربندی کاربر برای یک پوشهٔ خاص در Exchange Server:

اتصال به سرور Exchange با استفاده از IEWSClient واسط.
متد را فراخوانی کنید IEWSClient.UpdateUserConfiguration() متد برای به‌روزرسانی پیکربندی کاربر برای یک پوشه.

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

حذف پیکربندی‌های کاربر

برای حذف پیکربندی کاربر برای یک پوشهٔ خاص در Exchange Server:

اتصال به سرور Exchange با استفاده از IEWSClient واسط.
متد را فراخوانی کنید IEWSClient.DeleteUserConfiguration() متد برای حذف پیکربندی کاربر برای یک پوشه.

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

Net: مدیریت ویژگی‌های گسترش‌یافتهٔ پیام‌های ایمیل با استفاده از EWS در C#

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

API Aspose.Email به شما امکان می‌دهد ویژگی‌های گسترش‌یافتهٔ پیام‌ها را با استفاده از کلاینت EWS این API ایجاد، بازیابی و به‌روزرسانی کنید. نمونه کد زیر این را با ایجاد یک ویژگی گسترش‌یافته، افزودن آن به پیام در سرور و بازیابی پیام به‌صورت MapiMessage از سرور Exchange با استفاده از کلاینت FetchItem.

// Define a PidTagBodyContentId extended property
var extendedProperty = KnownPropertyList.BodyContentId;

// Create a message and set an extended property value
var msg = new MapiMessage("from@from.com", "to@to.com", "Test message", "This is a test message");
msg.SetProperty(extendedProperty, "03454432-6230-4e4b-887f-a498ea223599");

// Append message
var uri = ewsClient.AppendMessage(ewsClient.MailboxInfo.InboxUri, msg, true);

// Fetch appended item. Pass the extended property descriptor as method parameter.
var fetchedMsg = ewsClient.FetchItem(uri, new PropertyDescriptor[] { extendedProperty });

// Print the extended property value
Console.WriteLine(fetchedMsg.Properties[extendedProperty].GetString());

Net: اتوماتیک‌سازی بایگانی ایمیل در سرورهای اکسچینج با استفاده از C# و API EWS

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

Aspose.Email برای .NET یک API جامع برای مدیریت و پردازش ایمیل‌ها بر روی سرور اکسچینج ارائه می‌دهد. این راهنما نشان می‌دهد چگونه ایمیل‌ها را در پوشه Inbox یک صندوق‌پست اکسچینج فهرست کنید و به صورت برنامه‌نویسی با استفاده از IEWSClient اینترفیس. IEWSClient.ArchiveItem متد از IEWSClient این رابط به شما امکان می‌دهد موارد را به صندوق‌پست بایگانی کاربران انتقال دهید. چهار overload زیر را ارائه می‌دهد:

نمونه کد زیر نشان می‌دهد چگونه از Aspose.Email برای اتصال به سرور اکسچینج، فهرست کردن پیام‌ها و بایگانی آنها استفاده کنید با IEWSClient.ArchiveItem متد. ذخیره‌سازی ایمیل‌ها با انتقال هر مورد به صندوق‌پست بایگانی با استفاده از UniqueUri انجام می‌شود.

Net: دریافت ایمیل‌ها از یک صندوق ایمیل مشترک با استفاده از C# و API EWS

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

Aspose.Email از دسترسی به پیام‌ها از صندوق ایمیل مشترک پشتیبانی می‌کند. برای این کار، با استفاده از EWSClient کلاس. برای دسترسی به پیام‌ها از صندوق ایمیل مشترک، صندوق ایمیل مشترک را به‌عنوان پارامتر رشته‌ای به ListMessages یا ListItems متد.

نمونه کد زیر نشان می‌دهد که چگونه می‌توان به پیام‌ها از صندوق ایمیل مشترک با استفاده از این دسترسی پیدا کرد ListItems متد.

Net: توکن OAuth ناهمزمان و مدیریت ایمیل‌های EWS در C#

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

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

برخلاف متدهای همزمان، متدهای ناهمزمان غیرمسدودکننده هستند و امکان اجرای چندین درخواست به‌صورت همزمان را فراهم می‌کنند. متدهای ناهمزمان با پسوند Async نامگذاری می‌شوند.

توجه: متدهای Async در نسخه‌هایی که هدف .NET Core، .NET Framework 4.5 و بعد از آن هستند، قابل استفاده هستند.

نمونه کد زیر یک SomeAsyncTokenProvider کلاسی که IAsyncTokenProvider رابط. این کلاس پیاده‌سازی می‌کند GetAccessTokenAsync متد ناهمزمانی که یک شیء Task از نوع OAuthToken برمی‌گرداند. این متد یک توکن معتبر را دریافت می‌کند OAuthToken به‌صورت ناهمزمان.

private class SomeAsyncTokenProvider : IAsyncTokenProvider
{
    public SomeAsyncTokenProvider( /*some parameters*/)
    {
        ...
    }

    public async Task<OAuthToken> GetAccessTokenAsync(bool ignoreExistingToken = false,
        CancellationToken cancellationToken = default)
    {
        //Some asynchronous code to get a valid OAuthToken
        ...
    }

    public void Dispose()
    {
        ...
    }
}

راه‌اندازی کلاینت ناهمزمان EWS با احراز هویت OAuth

مثال کد بعدی یک کلاینت Exchange Web Services (EWS) را به‌صورت ناهمزمان با استفاده از احراز هویت OAuth دریافت می‌کند. این کد مراحل زیر را انجام می‌دهد:

یک مورد جدید ایجاد می‌کند CancellationToken شیئی که می‌تواند برای لغو عملیات‌های ناهمزمان استفاده شود.
نمونه‌سازی می‌کند SomeAsyncTokenProvider کلاسی که پیاده‌سازی می‌کند IAsyncTokenProvider رابط. این کلاس به‌عنوان پارامتری برای ساخت یک جدید استفاده می‌شود. OAuthNetworkCredential شیء.
آدرس URI صندوق پستی را به نقطهٔ انتهایی Exchange Web Services تنظیم می‌کند.
فراخوانی می‌کند GetEwsClientAsync متد از EWSClient کلاس با mailboxUri و OAuthNetworkCredential object به‌عنوان پارامترها. این متد یک شیء Task برمی‌گرداند، بنابراین پیش از ادامه‌ٔ کار، انتظار نتیجه را می‌کشد. این cancellationToken شیء به عنوان پارامتر اختیاری به GetEwsClientAsync متد.

//The cancellationToken can be used
var cancellationToken = new CancellationToken();

//Create IAsyncEwsClientInstance
IAsyncTokenProvider tokenProvider = new SomeAsyncTokenProvider(/*some parameters*/);
const string mailboxUri = "https://outlook.office365.com/ews/exchange.asmx";
var ewsClient = await EWSClient.GetEwsClientAsync(mailboxUri, new OAuthNetworkCredential(tokenProvider),
    cancellationToken: cancellationToken);

ارسال پیام‌های ایمیل

مثال کد زیر سعی دارد یک پیام ایمیل را به‌صورت ناهمزمان ارسال کند. این کد مراحل زیر را انجام می‌دهد:

یک مورد جدید ایجاد می‌کند MailMessage شیئی با پارامترهای پیام.
فراخوانی می‌کند SendAsync متد از EWSClient شیء، MailMessage را به عنوان پارامتر عبور می‌دهد. متد منتظر می‌ماند چون یک شیء Task برمی‌گرداند. cancellationToken شیء به عنوان پارامتر اختیاری به SendAsync متد.

MailMessage message = new MailMessage("from@aspose.com", "to@aspose.com", "Some subject", "Some body");
await ewsClient.SendAsync(message, cancellationToken: cancellationToken);

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

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

متد را فراخوانی کنید FetchItemAsync متد یک EWSclient. این متد دو پارامتر می‌گیرد:
- messageUri یک رشته است که URI پیام مورد دریافت را نشان می‌دهد
- cancellationToken یک پارامتر اختیاری است که می‌تواند برای لغو عملیات ناهمزمان استفاده شود. این متد یک شیء Task را برمی‌گرداند که به یک MapiMessage شیء هنگامی که عملیات ناهمزمان کامل شد. کلمه کلیدی "await" برای انتظار تا تکمیل شیء Task قبل از ادامه استفاده می‌شود.
اختصاص به fetched متغیر نتیجهٔ Task تکمیل‌شده، که یک MapiMessage شیئی که شامل داده‌های پیام دریافت‌شده است.
```
   var fetched = await ewsClient.FetchItemAsync(messageUri, cancellationToken: cancellationToken);
```

افزودن پیام‌های ایمیل

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

فراخوانی می‌کند AppendMessagesAsync متد یک EWSclient شیء. این متد یک EwsAppendMessage شیئی که شامل پارامترها است: پیام‌های مورد افزودن، URI پوشه هدف، و توکن لغو.
ایجاد می‌کند EwsAppendMessage شیء با استفاده از Create متد و آن را با فراخوانی‌های متد زیر پیکربندی می‌کند:
- AddMessage یک پیام را به عملیات افزودن اضافه می‌کند.
- SetFolder URI پوشه هدف را برای عملیات افزودن تنظیم می‌کند.
- SetCancellationToken توکن لغو را تنظیم می‌کند که می‌تواند برای لغو عملیات ناهمزمان استفاده شود.
این AppendMessagesAsync متد شیء Task را برمی‌گرداند که به یک شیء IEnumerable حل می‌شود وقتی عملیات ناهمزمان تمام شود. کلمه کلیدی "await" برای انتظار تا تکمیل شیء Task قبل از ادامه استفاده می‌شود.
این uris متغیر نتیجهٔ Task تکمیل‌شده را دریافت می‌کند که یک شیء IEnumerable شامل URIهای پیام‌های اضافه‌شده است.

IEnumerable<string> uris = await ewsClient.AppendMessagesAsync(
    EwsAppendMessage.Create()
        .AddMessage(message)
        .AddMessage(fetched)
        .SetFolder(folderUri)
        .SetCancellationToken(cancellationToken));

کپی موارد

نمونه کد زیر نشان می‌دهد چگونه موارد را کپی کنید و مراحل زیر را انجام می‌دهد:

فراخوانی می‌کند CopyItemAsync متد یک EWSClient شیء. این متد سه پارامتر می‌گیرد:
- messageUri یک رشته است که URI پیام مورد کپی را نشان می‌دهد
- destinationFolderUri یک رشته است که URI پوشهٔ مقصد را نشان می‌دهد
- cancellationToken یک پارامتر اختیاری است که می‌تواند برای لغو عملیات ناهمزمان استفاده شود.
متد شیء Task را برمی‌گرداند که به یک رشته حل می‌شود وقتی عملیات ناهمزمان تمام شود. کلمه کلیدی "await" برای انتظار تا تکمیل شیء Task قبل از ادامه استفاده می‌شود.
newItemUri متغیر نتیجهٔ Task تکمیل‌شده را دریافت می‌کند که یک رشته شامل URI نسخهٔ جدید ایجاد شدهٔ پیام است.

string newItemUri = await ewsClient.CopyItemAsync(messageUri, destinationFolderUri, cancellationToken);

حذف موارد

کد زیر در حال تلاش برای حذف یک پیام ایمیل به صورت ناهمزمان است.

متد فراخوانی می‌کند DeleteItemAsync متد یک شیء EWSClient. این متد سه پارامتر می‌گیرد:

newItemUri یک رشته است که URI مورد حذف را نشان می‌دهد
DeletionOptions.DeletePermanently مشخص می‌کند که مورد باید به‌طور دائمی حذف شود
cancellationToken یک پارامتر اختیاری است که می‌تواند برای لغو عملیات ناهمزمان استفاده شود.

متد شیء Task را برمی‌گرداند که پس از کامل شدن عملیات ناهمزمان به پایان می‌رسد. کلمه کلیدی "await" برای انتظار تا تکمیل شیء Task قبل از ادامه استفاده می‌شود.

await ewsClient.DeleteItemAsync(newItemUri, DeletionOptions.DeletePermanently, cancellationToken);

حذف پوشه‌ها

کد زیر در حال تلاش برای حذف یک پوشه به صورت ناهمزمان است.

متد فراخوانی می‌کند DeleteFolderAsync متد یک شیء EWSClient. این متد سه پارامتر می‌گیرد:

folderUri یک رشته است که URI پوشهٔ مورد حذف را نشان می‌دهد
deletePermanently مشخص می‌کند که آیا پوشه به‌طور دائمی حذف شود یا به پوشهٔ "موارد حذف‌شده" منتقل شود
cancellationToken یک پارامتر اختیاری است که می‌تواند برای لغو عملیات ناهمزمان استفاده شود.

const bool deletePermanently = true;
await ewsClient.DeleteFolderAsync(folderUri, deletePermanently, cancellationToken);

به‌روزرسانی موارد

نمونه کد زیر در حال تلاش برای به‌روزرسانی یک شیء به صورت ناهمزمان است. این کار مراحل زیر را انجام می‌دهد:

یک EwsUpdateItem شیء با استفاده از Create متد، با عبور یک شیء مورد. EwsUpdateItem نمایانگر پارامترهای عملیات به‌روزرسانی است. SetCancellationToken متد بر روی EwsUpdateItem شیء، با عبور در cancellationToken پارامتر، که یک پارامتر اختیاری است و می‌تواند برای لغو عملیات ناهمزمان استفاده شود.
پیش می‌برد EwsUpdateItem شیء به عنوان پارامتر به UpdateItemAsync متد یک EWSClient.
این UpdateItemAsync متد شیء Task را برمی‌گرداند که پس از کامل شدن عملیات ناهمزمان به پایان می‌رسد. کلمه کلیدی "await" برای انتظار تا تکمیل شیء Task قبل از ادامه استفاده می‌شود.

await ewsClient.UpdateItemAsync(
    EwsUpdateItem.Create(mapiNote)
        .SetCancellationToken(cancellationToken));

Net: فعالسازی ثبت فعالیت برای مشتری EWS در برنامه‌های .NET

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

ثبت‌لاگ برای اشکال‌زدایی، همچنین جمع‌آوری و تحلیل اطلاعات عملکرد برنامه استفاده می‌شود. فایل‌های لاگ حاوی اطلاعات سیستمی دربارهٔ عملکرد برنامهٔ مشتری هستند.

تنظیم ثبت لاگ با استفاده از فایل appsettings.json

یادداشت: این گزینه برای برنامه‌های .NET Core ترجیح داده می‌شود.

مراحل زیر برای فعال‌سازی ثبت‌لاگ در EWSClient.

یک فایل پیکربندی appsettings.json به پروژه C# اضافه کنید، اگر قبلاً اضافه نشده باشد. مطمئن شوید که فایل پروژه شامل خطوط زیر در بخش ItemGroup باشد:
```
<Content Include="appsettings.json">
    <CopyToOutputDirectory>Always</CopyToOutputDirectory>
</Content>
```
سپس محتویات زیر را به فایل appsettings.json اضافه کنید.
```
{
  "EWSDiagnosticLog": "ews.log",
  "EWSDiagnosticLog_UseDate": true
}
```

دو خاصیت وجود دارد:

EWSDiagnosticLog - مسیر نسبی یا مطلق فایل لاگ را تعیین می‌کند.
EWSDiagnosticLog_UseDate - مشخص می‌کند آیا نمایش رشته‌ای از تاریخ جاری به نام فایل لاگ اضافه شود یا نه.

تنظیم ثبت لاگ در کد برنامه

همچنین می‌توانید ثبت‌لاگ را بلافاصله در کد فعال کنید.

یادداشت: حتی اگر قبلاً با استفاده از فایل‌های پیکربندی ثبت‌لاگ را فعال کرده‌اید، این گزینه اعمال خواهد شد.

مراحل زیر برای فعال‌سازی ثبت‌لاگ در EWSClient هستند.

یک EWSClient.
مسیر فایل لاگ را با استفاده از تنظیم کنید LogFileName ویژگی.
تنظیم UseDateInLogFileName خاصیت در صورت نیاز.

using (var client = EWSClient.GetEWSClient("https://outlook.office365.com/EWS/Exchange.asmx", credentials))
{
  client.LogFileName = @"Aspose.Email.EWS.log";
  client.UseDateInLogFileName = false;
}

تنظیم ثبت لاگ با استفاده از فایل App.config

این گزینه برای برنامه‌هایی که در آنها مناسب است app.config راه ترجیحی برای نگهداری پیکربندی برنامه است.

مراحل زیر برای فعال‌سازی ثبت‌لاگ در EWSClient.

یک فایل پیکربندی برنامه به پروژه C# اضافه کنید، اگر قبلاً اضافه نشده باشد.
محتوای زیر را به فایل پیکربندی اضافه کنید.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <configSections>
    <sectionGroup name="applicationSettings" type="System.Configuration.ApplicationSettingsGroup, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >
      <section name="Aspose.Email.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" requirePermission="false" />
    </sectionGroup>
  </configSections>
    <applicationSettings>
        <Aspose.Email.Properties.Settings>
            <setting name="EWSDiagnosticLog" serializeAs="String">
                <value>..\..\..\Log\Aspose.Email.EWS.log</value>
            </setting>
            <setting name="EWSDiagnosticLog_UseDate" serializeAs="String">
                <value>False</value>
            </setting>
        </Aspose.Email.Properties.Settings>
    </applicationSettings>
</configuration>

دو بخش تنظیم وجود دارد:

EWSDiagnosticLog - مسیر نسبی یا مطلق فایل لاگ را تعیین می‌کند.
EWSDiagnosticLog_UseDate - مشخص می‌کند آیا نمایش رشته‌ای از تاریخ جاری به نام فایل لاگ اضافه شود یا نه.

Net: مدیریت پیشرفته ایمیل برای برنامه‌های .NET

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

کار با پیام‌رسانی یکپارچه

Aspose.Email می‌تواند اطلاعات پیام‌رسانی یکپارچه را از Exchange Server 2010 بازیابی کند. پیام‌رسانی یکپارچه مانند دریافت اطلاعات پیکربندی، آغاز یک تماس خروجی، بازیابی اطلاعات تماس تلفنی بر اساس شناسه تماس و قطع تماس بر اساس شناسه در حال حاضر پشتیبانی می‌شود. نمونه کد زیر نشان می‌دهد چگونه اطلاعات پیکربندی پیام‌رسانی یکپارچه را از Microsoft Exchange Server 2010 بازیابی کنید.

دریافت نکات ایمیلی

سرور مایکروسافت اکسچینج در نسخه‌های 2010 و 2013 چندین قابلیت جدید اضافه کرد. یکی از این قابلیت‌ها به کاربران امکان دریافت نکات ایمیل هنگام نوشتن پیام ایمیل را می‌دهد. این نکات بسیار مفید هستند زیرا قبل از ارسال ایمیل اطلاعاتی را ارائه می‌دهند. به عنوان مثال، اگر آدرس ایمیل در فهرست گیرندگان اشتباه باشد، یک نکته نمایش داده می‌شود تا به شما بگوید آدرس ایمیل نامعتبر است. نکات ایمیل همچنین به شما اجازه می‌دهند پیش از ارسال ایمیل، پاسخ‌های خارج از دفتر را ببینید: سرور اکسچینج (2010 و 2013) هنگام نوشتن ایمیل، اگر یک یا چند گیرنده پاسخ‌نامهٔ خارج از دفتر تنظیم کرده باشند، نکتهٔ ایمیل را می‌فرستد. سرویس پک 1 سرور مایکروسافت اکسچینج 2010 برای تمام ویژگی‌های نشان داده شده در این مقاله لازم است. قطعه کد زیر نشان می‌دهد چگونه از EWSClient کلاسی که از Exchange Web Services استفاده می‌کند، موجود در Microsoft Exchange Server 2007 و نسخه‌های بعدی.

جابجایی هویت Exchange

امتیاز نمایندگی اکسچینج به شخصی اجازه می‌دهد که به جای حساب خود، حساب دیگری را تقلید کند و وظایف و عملیات را با مجوزهای حساب تقلید شده انجام دهد. در حالی که واگذاری به کاربران امکان می‌دهد به نمایندگی از دیگران عمل کنند، تقلید به آنها اجازه می‌دهد همانند کاربران دیگر رفتار کنند. Aspose.Email از نمایندگی اکسچینج پشتیبانی می‌کند. EWSClient کلاس فراهم می‌کند ImpersonateUser و ResetImpersonation متدها برای تسهیل این ویژگی.

برای انجام این کار:

راه‌اندازی ExchangeWebServiceClient برای کاربر ۱.
راه‌اندازی ExchangeWebServiceClient برای کاربر ۲.
اضافه کردن پیام‌های آزمایشی به حساب‌ها.
فعال‌سازی جابجایی هویت.
بازنشانی جابجایی هویت.

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

ویژگی کشف خودکار با استفاده از EWS

API Aspose.Email به شما امکان کشف تنظیمات سرور Exchange را با استفاده از کلاینت EWS می‌دهد.

لغو عملیات بازیابی PST به سرور Exchange

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

توجه: مثال به کلاس زیر نیز نیاز دارد که اضافه شود.


 public class CustomAbortRestoreException : Exception { }