Documentation – ทำงานกับ Exchange EWS Client

Net: การเชื่อมต่อกับ Exchange Server

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

เพื่อเชื่อมต่อกับ Exchange server 2007, 2010 และ 2013 โดยใช้ Exchange Web Service, Aspose.Email มี IEWSClient อินเทอร์เฟซที่ทำงานตาม EWSClient คลาส. เมธอด EWSClient.GetEWSClient เมธอดสร้างอินสแตนซ์และคืนค่า IEWSClient ออบเจกต์ที่ใช้ต่อไปเพื่อทำการดำเนินการที่เกี่ยวกับกล่องเมล Exchange และโฟลเดอร์อื่น ๆ บทความนี้แสดงวิธีสร้างอินสแตนซ์ของออบเจกต์ IEWSClient.

เชื่อมต่อกับ Exchange Server ด้วย 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;
}

ในสถานการณ์ที่ต้องการ header เฉพาะระหว่างการเริ่มต้นคลไอเอนท์, เช่น header X-AnchorMailbox ใน EWS, ใช้วิธีการโอเวอร์โหลดต่อไปนี้เพื่อเพิ่ม header แบบกำหนดเองเมื่อสร้างอินสแตนซ์ของ 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 header แบบกำหนดเอง:

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

เชื่อมต่อกับ Exchange Server ด้วย IMAP

Microsoft Exchange Server สนับสนุนโปรโตคอล IMAP สำหรับการเข้าถึงรายการในกล่องจดหมาย. ใช้ Aspose.Email ImapClient คลาสเพื่อเชื่อมต่อกับ Exchange Server ด้วยโปรโตคอล IMAP ข้อมูลเพิ่มเติมเกี่ยวกับ ImapClient คลาส ก่อนแรกให้แน่ใจว่า IMAP service เปิดใช้งานสำหรับ Exchange Server ของคุณ:

เปิด Control Panel.
ไปที่ Administrator Tools แล้วเลือก Services.
ตรวจสอบสถานะของบริการ Microsoft Exchange IMAP4.
หากยังไม่ได้ทำงาน ให้เปิดใช้งาน/เริ่มต้นมัน.

โค้ดส่วนต่อไปนี้จะแสดงวิธีเชื่อมต่อและแสดงรายการข้อความจากโฟลเดอร์ Inbox ของ Microsoft exchange server โดยใช้โปรโตคอล IMAP.

// 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 server ด้วย 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 framework และอาจแตกต่างกันขึ้นกับเวอร์ชันปัจจุบันของ .NET framework.

เพื่อกำหนดเวอร์ชัน SSL/TLS ใช้โค้ดต่อไปนี้:

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

หรือ

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

หมายเหตุ, หาก EncryptionProtocol ที่ระบุไม่ได้รับการสนับสนุนโดยเวอร์ชันปัจจุบันของ .NET framework, SupportedEncryption พร็อพเพอร์ตี้ทำให้การเข้ารหัสระดับต่ำลงเป็นระดับที่สนับสนุนและ SetSupportedEncryptionUnsafe เมธอดโยนข้อยกเว้น.

เชื่อมต่อกับ Exchange Server โดยใช้ Modern Authentication

Modern Authentication ตอนนี้เปิดใช้งานโดยค่าเริ่มต้นสำหรับ tenant Microsoft 365/Azure ใหม่ทั้งหมด เนื่องจากโปรโตคอลนี้ปลอดภัยกว่าการใช้ Basic Authentication ที่เลิกใช้แล้ว.

Modern Authentication อยู่บน Active Directory Authentication Library และ OAuth 2.0. มันใช้โทเค็นที่มีอายุจำกัด, และแอปพลิเคชันไม่จัดเก็บข้อมูลประจำตัวผู้ใช้.

การตั้งค่าก่อนใช้งาน

เพื่อใช้ Modern Authentication, ตรวจสอบให้แน่ใจว่ามันเปิดใช้งาน. อย่างไรก็ตาม, สำหรับ tenant ที่สร้างก่อน 1 สิงหาคม 2017, Modern Authentication จะปิดโดยค่าเริ่มต้น. ใน ศูนย์ผู้ดูแล Microsoft 365, ไปที่ Settings > Org Settings > Modern Authentication. ใน Modern authentication flyout ที่ปรากฏ, คุณสามารถระบุโปรโตคอลที่ไม่ต้องใช้ Basic authentication อีกต่อไป. สำหรับ tenant Microsoft365 ใหม่ใน Azure, Basic Authentication จะถูกปิดโดยค่าเริ่มต้นสำหรับทุกแอปพลิเคชัน. ดังนั้น ข้อความนี้จะแสดงในส่วนนี้.

องค์กรของคุณเปิดใช้ค่าปริยายด้านความปลอดภัย, ซึ่งหมายความว่าต้องใช้การตรวจสอบสิทธิ์สมัยใหม่กับ Exchange Online และการเชื่อมต่อ Basic Authentication ถูกบล็อก. > คุณต้องปิดค่าปริยายด้านความปลอดภัยในพอร์ทัล Azure ก่อนจึงจะเปลี่ยนการตั้งค่าใด ๆ ที่นี่.

คุณสามารถเปิดการสนับสนุน Basic Auth สำหรับ tenant ได้จาก Azure พอร์ทัล, ไปที่ Azure Active Directory > Properties > Manage Security defaults > Enable Security defaults > No. สำหรับข้อมูลเพิ่มเติม, ดูที่ บทความเอกสารของ Microsoft.

การลงทะเบียนแอปกับ Azure Active Directory

จำเป็นต้องทำการลงทะเบียนแอปกับ Azure Active Directory. มีสองประเภทของสิทธิ์ที่สามารถใช้เพื่อเข้าถึงกล่องจดหมายด้วยแอปของคุณ. เลือกประเภทสิทธิ์ที่เฉพาะตามแอปที่คุณกำลังสร้าง:

แอปที่ใช้ สิทธิ์แบบมอบหมาย มีผู้ใช้ที่ลงชื่อเข้าใช้อยู่. กล่าวคือ เมื่อคุณเชื่อมต่อกับบริการ จะมีหน้าต่างโต้ตอบขอชื่อผู้ใช้และรหัสผ่าน. แอปไม่สามารถมีสิทธิ์มากกว่าผู้ใช้ที่ลงชื่อเข้าใช้ได้.
แอปที่ใช้ สิทธิ์แอปพลิเคชัน ทำงานโดยไม่มีผู้ใช้ที่ลงชื่อเข้าใช้อยู่. ตัวอย่างเช่น เป็นแอปที่ทำงานเป็นบริการพื้นหลังหรือ daemon. เฉพาะผู้ดูแลระบบเท่านั้นที่สามารถให้ความยินยอมต่อสิทธิ์แอปพลิเคชัน.

นอกจากนี้ ดูที่ บทความเอกสารของ Microsoft สำหรับข้อมูลเพิ่มเติม.

ขั้นตอนการลงทะเบียนขึ้นอยู่กับประเภทของสิทธิ์ที่เลือก. เพื่อลงทะเบียนแอปของคุณ ดูที่ บทความเอกสารของ Microsoft.

ใช้การตรวจสอบสิทธิ์สมัยใหม่กับ EWSClient

หลังจากลงทะเบียนแอปพลิเคชัน เราสามารถมุ่งเน้นที่การเขียนโค้ด ซึ่งจะประกอบด้วยส่วนต่อไปนี้:

รับโทเค็นการอนุญาต.
ใช้โทเค็นเพื่อยืนยันตัวตน.

รับโทเค็นการอนุญาต

เพื่อรับโทเค็น เราจะใช้ Microsoft Authentication Library (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 ด้วยการตรวจสอบสิทธิ์แอป, และอ่านกล่องจดหมายเข้า.

ใช้ Modern Authentication กับไคลเอนท์ IMAP, POP หรือ SMTP

การเข้าถึง IMAP, POP, SMTP ผ่านสิทธิ์แอปพลิเคชันไม่รองรับ. กล่าวคือ รองรับเฉพาะการตรวจสอบสิทธิ์แบบมอบหมาย.

ขั้นตอนการลงทะเบียนแอปกับ Azure Active Directory ถูกกำหนด ข้างต้น.

เปิดหรือปิด IMAP, POP, SMTP AUTH ในศูนย์ผู้ดูแล Microsoft 365

เปิด ศูนย์ผู้ดูแล Microsoft 365 และไปที่ Users > Active users.
เลือกผู้ใช้, และใน flyout ที่ปรากฏ, คลิก Mail.
ในส่วน Email apps, คลิก Manage email apps.
ตรวจสอบการตั้งค่า IMAP, POP, Authenticated 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

เพื่อรับโทเค็น เราจะใช้ Microsoft Authentication Library (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, และอ่านกล่องจดหมายเข้า.

คืนค่า Client Request ID

นี้ ReturnClientRequestId ได้เพิ่ม property เข้าไปใน EWSClient เพื่อความสะดวกของคุณในการระบุว่าควรคืนค่า client request ID ในการตอบกลับจากการเรียก Exchange Web Services (EWS) หรือไม่. client request ID คือ identifiers ที่ไม่ซ้ำกันซึ่งคุณสามารถตั้งค่าได้สำหรับแต่ละคำขอ EWS ที่ส่งจากแอปพลิเคชันของคุณ. โดยการตั้งค่า ReturnClientRequestId ตั้งค่าพร็อพเพอร์ตี้เป็น true แสดงว่าคุณต้องการให้ client request ID ถูกใส่ในการตอบกลับจากเซิร์ฟเวอร์ 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();
}

Aspose.Email API อนุญาตให้เพิ่ม header ไปยังคำขอ Exchange. สามารถใช้เพื่อเพิ่ม header ไปยังคำขอ EWS สำหรับ header ต่าง ๆ ที่ใช้เพื่อวัตถุประสงค์ที่แตกต่างกัน. ตัวอย่างหนึ่งคือการเพิ่ม header X-AnchorMailbox ที่ใช้จัดการปัญหา throttling บนเซิร์ฟเวอร์ Exchange. AddHeader เมธอดของ IEWSClient ใช้เพื่อเพิ่ม header ไปยังคำขอ EWS ตามที่แสดงในตัวอย่างโค้ดต่อไปนี้.

ละเลยหรือข้ามใบรับรอง SSL ที่ไม่ถูกต้องหรือหมดอายุ

Aspose.Email สามารถจัดการใบรับรอง SSL บน Exchange Server ได้โดยใช้ทั้ง ExchangeClient และ EWSClient คลาส. หากใบรับรอง SSL หมดอายุหรือไม่ถูกต้อง Aspose.Email จะขว้างข้อยกเว้นเนื่องจากใบรับรอง SSL ไม่ถูกต้อง. หลีกเลี่ยงข้อผิดพลาดของใบรับรอง SSL โดยการละเลยโดยใช้วิธีที่ใช้ในโค้ดด้านล่าง. ลงทะเบียน callback handler ในเมธอด main() หรือ init() ของคุณและเพิ่มเมธอดด้านล่างเป็นสมาชิกของคลาส.

Net: ดึงและจัดการข้อมูลกล่องจดหมายของ Exchange Server ด้วย EWS

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

ดึงข้อมูลกล่องจดหมายโดยใช้ EWS

นี้ EWSClient คลาสมีสมาชิกที่สามารถใช้ดึงข้อมูลกล่องจดหมายจาก Exchange Server โดยเรียก IEWSClient.GetMailboxInfo() เมธอด คืนค่าอินสแตนซ์ของชนิด ExchangeMailboxInfo. รับข้อมูลกล่องจดหมายจากคุณสมบัติ เช่น MailboxUri, InboxUri และ DraftsUri. บทความนี้แสดงวิธีเข้าถึงข้อมูลกล่องเมลโดยใช้ Exchange Web Services.

หากคุณต้องการเชื่อมต่อกับ Exchange Server โดยใช้ Exchange Web Services (EWS) ให้ใช้ IEWSClient คลาสในเนมสเปซ Aspose.Email.Exchange คลาสนี้ใช้ EWS เพื่อเชื่อมต่อและจัดการไอเท็มบน Exchange Server โค้ด 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 Server ด้วยความช่วยเหลือของเครื่องมือใน Aspose.Email.Exchange. ส่วน IEWSClient.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 ของรายการที่ส่ง

สามารถดึง ID ของอีเมลที่ส่งจาก Exchange server ด้วยโค้ดตัวอย่างต่อไปนี้:

// 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 Server มีสิทธิ์เข้าถึงหลายกล่องจดหมาย และผู้ใช้บางคนมีหลายบัญชีอีเมลบน Exchange Server เดียวกัน ในทั้งสองกรณี ผู้ใช้สามารถเข้าถึงกล่องจดหมายของผู้ใช้คนอื่นโดยใช้ Aspose.Email สำหรับ .NET API นี้ให้กลไกสำหรับการเข้าถึงโฟลเดอร์และอีเมลจากกล่องจดหมายอื่นโดยใช้ IEWSClient อินเทอร์เฟซ ฟังก์ชันนี้สามารถทำได้โดยใช้ overloaded 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 เมธอด ใช้ดึงข้อมูลพื้นฐานของข้อความ เช่น เรื่อง, จาก, ถึง และ ID ของข้อความ โดยใช้เมธอด ListMessage.

รายการข้อความอย่างง่าย

เพื่อแสดงรายการข้อความในกล่องเมล Exchange:

สร้างอินสแตนซ์ของ IEWSClient อินเทอร์เฟซ
เรียกใช้ ListMessages เมธอดและสร้างคอลเลกชันข้อความ
วนลูปผ่านคอลเลกชันและแสดงข้อมูลข้อความ

โค้ดสคริปต์ C# ต่อไปนี้แสดงวิธีเชื่อมต่อไปยัง Exchange Server ด้วย 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 สามารถดึงรายการข้อความจากโฟลเดอร์อื่นได้เช่นกัน The IEWSClient.ListMessages() เมธอดรับค่า folder URI เป็นพารามิเตอร์ ตราบใดที่ folder 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 store โดยการดึงคลาสของข้อความ คุณสามารถระบุประเภทของอีเมล Exchange และทำการดำเนินการเฉพาะตามการจัดประเภทของมันได้.

ด้านล่างเป็นตัวอย่างการดึงคลาสของข้อความโดยใช้ ExchangeMessageInfo คลาสของ Aspose.Email สำหรับ .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 Server และบันทึกลงดิสก์ในรูปแบบ EML และ MSG:

บันทึกเป็น EML ลงดิสก์.
บันทึกไปยังสตรีมหน่วยความจำ.
บันทึกเป็น MSG.

บันทึกข้อความเป็นไฟล์ EML

เพื่อดึงข้อความและบันทึกในรูปแบบ EML:

สร้างอินสแตนซ์ของ IEWSClient อินเทอร์เฟซ
ระบุ mailboxUri, ชื่อผู้ใช้, รหัสผ่านและโดเมน.
เรียกใช้ IEWSClient.ListMessages() เมธอดเพื่อรับอินสแตนซ์ของ ExchangeMessagesInfoCollection.
วนลูปผ่าน ExchangeMessagesInfoCollection เพื่อดึง URI ที่เป็นเอกลักษณ์ของแต่ละข้อความ.
เรียกใช้ IEWSClient.SaveMessage() เมธอดและส่ง URI ที่ไม่ซ้ำกันเป็นพารามิเตอร์.
Provide a the SaveMessage() เมธอดพร้อมพาธที่ต้องการบันทึกไฟล์.

โค้ดสคริปต์ต่อไปนี้แสดงวิธีใช้ EWS เชื่อมต่อกับ Exchange Server และบันทึกข้อความเป็นไฟล์ 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 class. โค้ดสคริปต์ต่อไปนี้แสดงวิธีบันทึกข้อความจากกล่องเมล Exchange Server ไปยังสตรีมหน่วยความจำโดยใช้ 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 Server และบันทึกเป็นรูปแบบ MSG โดยใช้ 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");

// 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 รับรายการ Ids เพื่อใช้ 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 Server ListMessages() เมธอดนี้ใช้เพื่อดึงรายการข้อความจากกล่องจดหมายของ Exchange Server. The ListMessages() เมธอดนี้ดึงข้อมูลพื้นฐานของข้อความ เช่น หัวเรื่อง, ID ของข้อความ, ผู้ส่งและผู้รับ เพื่อรับรายละเอียดข้อความเต็มรูปแบบ Aspose.Email.Exchange มี IEWSClient.FetchMessage() เมธอดนี้รับ URI ของข้อความเป็นพารามิเตอร์และคืนค่าอินสแตนซ์ของ Aspose.Email.MailMessage คลาส. เมธอด MailMessage คลาสจะให้รายละเอียดของข้อความเช่น เนื้อหา, ส่วนหัวและไฟล์แนบ ค้นหาข้อมูลเพิ่มเติมเกี่ยวกับ MailMessage API หรือเรียนรู้วิธีจัดการอีเมลด้วย MailMessage class. เพื่อดึงข้อความจากกล่องเมลของ Exchange Server:

สร้างอินสแตนซ์ของประเภท IEWSClient.
ระบุชื่อเซิร์ฟเวอร์, ชื่อผู้ใช้, รหัสผ่านและโดเมน.
เรียก ListMessages เพื่อดึง ExchangeMessageInfoCollection.
วนลูปผ่าน ExchangeMessageInfoCollection เพื่อดึง ExchangeMessageInfo.UniqueURI ค่า.
เรียก IEWSClient.FetchMessage() และส่ง ExchangeMessageInfo.UniqueURI() เป็นพารามิเตอร์.

โค้ดสคริปต์ต่อไปนี้แสดงการเชื่อมต่อไปยังกล่องจดหมายของ Exchange Server และดึงข้อความทั้งหมดโดยใช้ 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);
 }
}

ดึงข้อความโดยไม่มีไฟล์แนบ

หมายเหตุ, the 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 Client

นี้ FetchItemsเมธอด (EwsFetchItems options) ของ EwsClient ดึงรายการอีเมลจาก Exchange server โดยรับอินสแตนซ์ของ 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 server แสดงโดย 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 Server อย่างเรียงลำดับ ต้องใช้ Exchange Server 2007 หรือใหม่กว่าเนื่องจากใช้ EWS โค้ดสคริปต์ต่อไปนี้แสดงวิธีดาวน์โหลดกล่องจดหมายทั้งหมด (โฟลเดอร์และโฟลเดอร์ย่อย) ของ Exchange Server โครงสร้างโฟลเดอร์จะถูกสร้างในเครื่องและข้อความทั้งหมดจะถูกดาวน์โหลด.

// 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 Server และอ่านและดาวน์โหลดข้อความและโพสต์จากโฟลเดอร์สาธารณะ ตัวอย่างโค้ดต่อไปนี้แสดงวิธีอ่านโฟลเดอร์สาธารณะทั้งหมดและซับโฟลเดอร์ รวมถึงการแสดงรายการและดาวน์โหลดข้อความใดๆ ที่พบในโฟลเดอร์เหล่านั้น ตัวอย่างนี้ทำงานได้เฉพาะกับ 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 อินเทอร์เฟซ ย้าย เมธอด รับพารามิเตอร์:

URI ที่เป็นเอกลักษณ์ของข้อความที่ต้องการย้าย
URI ที่เป็นเอกลักษณ์ของโฟลเดอร์ปลายทาง

การย้ายข้อความระหว่างโฟลเดอร์

โค้ดส่วนต่อไปนี้จะแสดงวิธีย้ายข้อความในกล่องเมลจากโฟลเดอร์ Inbox ไปยังโฟลเดอร์ชื่อ Processed. ในตัวอย่างนี้, แอปพลิเคชัน:

อ่านข้อความจากโฟลเดอร์ Inbox
ประมวลผลข้อความบางส่วนตามเกณฑ์ (ในตัวอย่างนี้เราค้นหาคำสำคัญในหัวข้อข้อความ)
ย้ายข้อความที่ตรงตามเงื่อนไขที่กำหนดไปยังโฟลเดอร์ processed

// 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
    }
}

คัดลอกข้อความ

Aspose.Email API อนุญาตให้คัดลอกข้อความจากโฟลเดอร์หนึ่งไปยังอีกโฟลเดอร์โดยใช้ 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: กรองและจัดเรียงข้อความในกล่องเมล Exchange Server ด้วย EWS

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

Aspose.Email สำหรับ .NET มีความสามารถในการกรองข้อความจากกล่องเมล Exchange โดยใช้ EWSClient และ ExchangeQueryBuilder ข้อความสามารถกรองได้ตามเกณฑ์ต่าง ๆ เช่น ตามวัน, โดเมน, รหัสข้อความ, และตามการแจ้งการส่งเมล บทความนี้แสดงวิธีกรองข้อความจาก Exchange Server ด้วยเกณฑ์ต่าง ๆ.

กรองและจัดเรียงข้อความโดยใช้ EWS

นี้ IEWSClient อินเทอร์เฟซให้ ListMessages() เมธอดที่ดึงข้อความทั้งหมดจากกล่องเมล. เพื่อดึงเฉพาะข้อความที่ตรงกับเงื่อนไขบางอย่าง, ใช้เมธอดที่มีการโอเวอร์โหลด ListMessages() เมธอดที่รับค่า MailQuery คลาสเป็นอาร์กิวเมนต์ เมธอด MailQuery คลาสนี้ให้คุณสมบัติต่างๆ สำหรับระบุเงื่อนไข เช่น วันที่, หัวเรื่อง, ผู้ส่งและผู้รับ. นอกจากนี้ API ยังอนุญาตให้ใช้ตัวกรองความไวต่อขนาดตัวอักษรสำหรับดึงอีเมลจากกล่องจดหมาย.

กรองข้อความตามเกณฑ์

เพื่อดึงข้อความที่กรองจากกล่องจดหมาย:

เชื่อมต่อกับเซิร์ฟเวอร์ Exchange.
สร้างอินสแตนซ์ของ MailQuery และตั้งค่าคุณสมบัติตามต้องการ
เรียกใช้ IEWSClient.ListMessages() เมธอดและส่งค่า MailQuery ในพารามิเตอร์เพื่อรับข้อความที่กรองเท่านั้น.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีเชื่อมต่อกับกล่องเมล IMAP และรับข้อความที่มีสตริง "Newsletter" ในหัวเรื่องและส่งในวันนี้.

ตามวันที่วันนี้

โค้ดตัวอย่างต่อไปนี้แสดงวิธีกรองอีเมลทั้งหมดโดยอิงจากวันที่ของวันนี้.

ตามช่วงวันที่

โค้ดสแนปพัดด้านล่างแสดงวิธีกรองอีเมลทั้งหมดตามช่วงวันที่.

ตามผู้ส่ง

โค้ดสแนปพัดด้านล่างแสดงวิธีกรองอีเมลทั้งหมดตามผู้ส่งเฉพาะ.

ตามโดเมน

โค้ดสแนปพัดด้านล่างแสดงวิธีกรองอีเมลทั้งหมดตามโดเมนเฉพาะ.

ตามผู้รับ

โค้ดสแนปพัดด้านล่างแสดงวิธีกรองอีเมลทั้งหมดตามผู้รับเฉพาะ.

ตาม MessageID

โค้ดสแนปพัดด้านล่างแสดงวิธีกรองอีเมลทั้งหมดตาม 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) เพื่อกรองข้อความโดยตรงจากกล่องเมล Exchange 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 โดยตรงตามคีย์เวิร์ดที่รองรับ.

ใช้ Query Builder

เพื่อสร้างคิวรีการค้นหาด้วย 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 Server

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

Aspose.Email for .NET สามารถใช้เพื่อจัดการรายการสนทนาบน Exchange Server ด้วย EWSClient คลาส นี้ใช้ Exchange Web Services ซึ่งมีเฉพาะใน Exchange Server 2007 ขึ้นไป บทความนี้แสดงวิธีการ ค้นหา, คัดลอก, ย้าย และ ลบ รายการสนทนาบน Exchange Server 2010 ต้องใช้ Microsoft Exchange Server 2010 Service Pack 1 สำหรับคุณลักษณะทั้งหมดที่รวมอยู่ในส่วนนี้.

ค้นหาการสนทนา

เพื่อรับข้อมูลการสนทนาจากโฟลเดอร์เฉพาะบน Exchange Server:

เชื่อมต่อกับ Exchange Server ด้วยการใช้ IEWSClient อินเทอร์เฟซ
เรียกใช้ IEWsClient.FindConversations() เมธอดเพื่อค้นหารายการสนทนาทั้งหมดจากโฟลเดอร์
แสดงคุณสมบัติของรายการสนทนา เช่น ID, หัวข้อการสนทนา และสถานะธง.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการค้นหาการสนทนา.

คัดลอกการสนทนา

เพื่อคัดลอกการสนทนาจากโฟลเดอร์หนึ่งไปยังอีกโฟลเดอร์:

เชื่อมต่อกับ Exchange Server ด้วยการใช้ IEWSClient อินเทอร์เฟซ
เรียกใช้ IEWSClient.CopyConversationItems() เมธอดเพื่อคัดลอกรายการสนทนาจากโฟลเดอร์ต้นทางไปยังโฟลเดอร์ปลายทาง

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการคัดลอกการสนทนา.

ย้ายการสนทนา

เพื่อย้ายการสนทนาจากโฟลเดอร์หนึ่งไปยังอีกโฟลเดอร์:

เชื่อมต่อกับ Exchange Server ด้วยการใช้ IEWSClient อินเทอร์เฟซ
เรียกใช้ IEWSClient.MoveConversationItems() เมธอดเพื่อย้ายการสนทนาจากโฟลเดอร์ต้นทางไปยังโฟลเดอร์ปลายทาง

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการย้ายการสนทนา.

ลบการสนทนา

เพื่อลบการสนทนาจากโฟลเดอร์:

เชื่อมต่อกับ Exchange Server ด้วยการใช้ 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 Server และส่งคำขอประชุมโดยใช้ Send(MailMessage) เมธอด.

นี้ EWSClient คลาสนี้สามารถใช้เชื่อมต่อกับ Exchange Server ที่รองรับ Exchange Web Services (EWS) เพื่อให้ทำงานได้ เซิร์ฟเวอร์ต้องเป็น Exchange Server 2007 หรือใหม่กว่า ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้ EWS เพื่อส่งคำขอประชุม.

จัดการรายการปฏิทินผ่าน EWS

Aspose.Email มีความสามารถในการเพิ่ม, อัปเดตและยกเลิกการนัดหมายโดยใช้ไคลเอนต์ Exchange Web Service (EWS) The IEWSClient CreateAppointment, UpdateAppointment, และ CancelAppointment เมธอดเหล่านี้อนุญาตให้จัดการรายการปฏิทินโดยใช้ EWS. บทความนี้ให้ตัวอย่างโค้ดอย่างละเอียดเกี่ยวกับการทำงานกับรายการปฏิทิน. ตัวอย่างโค้ดต่อไปนี้แสดงวิธี:

สร้างนัดหมาย.
อัปเดตนัดหมาย.
ลบ/ยกเลิกนัดหมาย.

แสดงรายการนัดหมายพร้อมการสนับสนุนการแบ่งหน้า

เมธอด ListAppointments ที่เปิดโดย IEWSClient API ดึงรายการนัดหมายทั้งหมดจากเซิร์ฟเวอร์ Exchange ซึ่งอาจใช้เวลาหากมีนัดหมายจำนวนมากบนเซิร์ฟเวอร์ API นี้ให้เมธอดที่มีการโอเวอร์โหลดของ ListAppointments เมธอดที่ให้การรองรับการแบ่งหน้าในปฏิบัติการ. สามารถใช้ร่วมกับฟีเจอร์การค้นหาได้หลายรูปแบบ. เมธอดที่มีการโอเวอร์โหลดต่อไปนี้สามารถใช้เพื่อแสดงรายการนัดหมายจาก Exchange Server พร้อมการรองรับการแบ่งหน้า.

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).

โค้ดตัวอย่างต่อไปนี้แสดงวิธีแสดงรายการนัดหมายพร้อมการรองรับการแบ่งหน้า.

เพิ่มเหตุการณ์ไปยังโฟลเดอร์ปฏิทินรอง

Aspose.Email API ช่วยให้คุณสร้างโฟลเดอร์ปฏิทินรองบน Exchange Server โดยใช้ IEWSClient. นัดหมายสามารถเพิ่ม, ปรับปรุง หรือยกเลิกจากปฏิทินรองโดยใช้ CreateAppointment, UpdateAppointment และ CancelAppointment เมธอด ต่อไปนี้เป็นเมธอดและคุณสมบัติของ API ที่ใช้ในตัวอย่างโค้ดด้านล่างเพื่อแสดงการทำงานของคุณลักษณะนี้ โปรดทราบว่าคุณลักษณะนี้ได้รับการสนับสนุนโดย Aspose.Email สำหรับ .NET ตั้งแต่เวอร์ชัน 6.5.0 เป็นต้นไป.

Method IEWSClient.CancelAppointment(Appointment, String).
Method IEWSClient.CancelAppointment(String, String).
Method IEWSClient.CreateAppointment(Appointment, String).
Method IEWSClient.CreateFolder(String, String, ExchangeFolderPermissionCollection, String).
Method IEWSClient.FetchAppointment(String, String).
Method IEWSClient.UpdateAppointment(Appointment, String).
คุณสมบัติ IEWSClient.CurrentCalendarFolderUri.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีเพิ่มเหตุการณ์ลงในโฟลเดอร์ปฏิทินรองบนเซิร์ฟเวอร์ Exchange.

แชร์คำเชิญปฏิทิน

Microsoft Exchange server ให้ความสามารถในการแชร์ปฏิทินโดยการส่งคำเชิญปฏิทินไปยังผู้ใช้คนอื่นที่ลงทะเบียนบนเซิร์ฟเวอร์ Exchange เดียวกัน. API ของ Aspose.Email ให้ความสามารถเดียวกันโดยอนุญาตให้แชร์ปฏิทินผ่าน EWS API.

ดึงคุณลักษณะที่ขยาย

ส่งคืนรายการปฏิทินที่เป็นเหตุซ้ำ

EWSClient รองรับการส่งคืนรายการปฏิทินที่เป็นเหตุซ้ำภายในช่วงที่ระบุโดย StartDate และ EndDate. AppointmentQueryBuilder.SetCalendarView method ถูกใช้เพื่อกำหนดช่วงวันที่เฉพาะและจำกัดจำนวนของนัดหมายที่ส่งคืนเพื่อดึงข้อมูลที่เกี่ยวข้อง โดยการตั้งค่าพารามิเตอร์ต่อไปนี้คุณสามารถดึงนัดหมายที่ตรงกับเกณฑ์ที่ระบุได้.

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 server ด้วยการใช้ ExchangeQueryBuilder. การนัดหมายสามารถกรองตาม:

วันที่
การเกิดซ้ำ

กรองนัดหมายตามวันที่

กรองนัดหมายตามเหตุซ้ำ

Net: จัดการรายชื่อผู้ติดต่อใน Exchange Server โดยใช้ EWS

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

บัญชี Exchange Server มีมากกว่าข้อความอีเมลเท่านั้น รวมถึง ดึงข้อมูล, ย้าย, ส่ง และ ลบข้อความอีเมล จาก Exchange Servers, Aspose.Email อนุญาตให้คุณทำงานกับรายชื่อ บทความนี้อธิบายวิธีดึงข้อมูลรายชื่อโดยใช้ Exchange Web Services บทความนี้ยังแสดงวิธีที่คุณสามารถแสดงรายการรายชื่อจากโฟลเดอร์ Contacts หรือแก้ไขรายชื่อโดยอิงตามชื่อรายชื่อ

ดึงรายชื่อผู้ติดต่อด้วย EWS

Aspose.Email ให้ EWSClient คลาสเพื่อเชื่อมต่อกับ Microsoft Exchange Server โดยใช้ Exchange Web Services โค้ดส่วนต่อไปนี้ใช้ Exchange Web Services เพื่ออ่านรายชื่อทั้งหมด โค้ดส่วนต่อไปนี้จะแสดงวิธีดึง Contacts ด้วย EWS.

ค้นหารายชื่อผู้ติดต่อตามชื่อ

โค้ดส่วนต่อไปนี้จะแสดงวิธีใช้ get contacts กับ EWS

กำหนดรูปแบบหมายเหตุผู้ติดต่อ

Aspose.Email.Mail.Contact.NotesFormat ระบุประเภทรูปแบบข้อความของหมายเหตุผู้ติดต่อที่กำหนดโดยตัวนับ Aspose.Email.TextFormat.

ดึงรายชื่อผู้ติดต่อตาม ID

รายชื่อเฉพาะสามารถดึงจากเซิร์ฟเวอร์โดยใช้ contact id ของมันตามตัวอย่างโค้ดต่อไปนี้.

เพิ่มรายชื่อ

นี้ EWSClient คลาส CreateContact() เมธอดนี้สามารถใช้เพื่อเพิ่มข้อมูลรายชื่อไปยัง Exchange Server. ส่วน CreateContact() เมธอดรับอ็อบเจ็กต์ Contact เป็นพารามิเตอร์อินพุต.

เพื่อเพิ่มรายชื่อไปยัง Exchange Server:

เริ่มต้น EWSClient ด้วยที่อยู่และข้อมูลรับรอง.
เริ่มต้นออบเจกต์ Contact ด้วยคุณสมบัติที่ต้องการ.
เรียกเมธอด CreateContact เพื่อเพิ่มรายชื่อไปยัง Exchange Server.

Aspose.Email ให้ EWSClient คลาสเพื่อเชื่อมต่อกับ Microsoft Exchange Server โดยใช้ Exchange Web Services. ตัวอย่างโค้ดแสดงวิธีใช้ Exchange Web Services เพื่อเพิ่มผู้ติดต่อใน Exchange Server.

อัปเดตรายชื่อ

ข้อมูลผู้ติดต่อสามารถอัปเดตได้โดยใช้ Microsoft Outlook. Aspose.Email สามารถอัปเดตข้อมูลผู้ติดต่อบน Exchange Server ด้วย Exchange Web Service (EWS). IEWSClient UpdateContact เมธอดนี้สามารถอัปเดตข้อมูลรายชื่อบน Exchange Server.

ลบรายชื่อ

นี้ EWSClient คลาสนี้อนุญาตให้ DeleteContact เข้าถึงและลบผู้ติดต่อจากโฟลเดอร์ผู้ติดต่อของ Exchange Server. เมธอดนี้รับ Contact ID หรือ MapiContact เป็นพารามิเตอร์อินพุต.

เพื่อที่จะลบรายชื่อจาก Exchange Server:

เริ่มต้น ExchangeWebServiceClient ด้วยที่อยู่และข้อมูลรับรอง.
ลบรายชื่อโดยใช้ ID ของมัน.
ลบผู้ติดต่อโดยเรียก DeleteContact เมธอดพร้อม MapiContact เป็นพารามิเตอร์อินพุต.

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีลบผู้ติดต่อจาก Exchange Server โดยใช้ 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 Server ด้วย C#

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

Aspose.Email API มีความสามารถในการสร้างและอ่านรายการกระจายจากเซิร์ฟเวอร์ Exchange. รายการกระจายสามารถสร้างบนเซิร์ฟเวอร์และสามารถเพิ่มสมาชิกลงในรายการได้โดยใช้ IEWSClient. บทความนี้แสดงวิธีการทำงานกับรายการกระจายบนเซิร์ฟเวอร์ Exchange.

สร้างรายการแจกจ่าย

ส่วนของโค้ดต่อไปนี้แสดงวิธีการสร้างรายการกระจาย

ดึงรายการแจกจ่ายส่วนบุคคล

ส่วนของโค้ดต่อไปนี้แสดงวิธีการดึงรายการกระจายส่วนตัว

สร้าง MailAddress จาก ID รายการ

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีสร้าง MailAddress จาก ID ของรายการแจกจ่าย

ขยายรายการแจกจ่ายสาธารณะ

ส่วนของโค้ดต่อไปนี้แสดงวิธีการขยายรายการกระจายสาธารณะ

เพิ่มสมาชิก

เพิ่มสมาชิกในรายการส่วนตัว

ส่วนของโค้ดต่อไปนี้แสดงวิธีการเพิ่มสมาชิกไปยังรายการกระจายส่วนตัว

เพิ่มสมาชิกโดยไม่แสดงรายการ

ส่วนของโค้ดต่อไปนี้แสดงวิธีการเพิ่มสมาชิกโดยไม่แสดงรายการ

ส่งไปยังรายการกระจายส่วนตัว

ส่วนของโค้ดต่อไปนี้แสดงวิธีการส่งข้อความไปยังรายการกระจายส่วนตัว

ลบสมาชิก

ลบสมาชิกจากรายการส่วนตัว

ส่วนของโค้ดต่อไปนี้แสดงวิธีการลบสมาชิกจากรายการกระจายส่วนตัว

ลบสมาชิกโดยไม่แสดงรายการ

ส่วนของโค้ดต่อไปนี้แสดงวิธีการลบสมาชิกโดยไม่แสดงรายการ

ลบรายการกระจายส่วนตัว

ส่วนของโค้ดต่อไปนี้แสดงวิธีการลบรายการกระจายส่วนตัว

Net: วิธีจัดการโฟลเดอร์ของ Exchange Server ด้วย EWS

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

แสดงโฟลเดอร์ทั้งหมดจากเซิร์ฟเวอร์

Aspose.Email API ให้ความสามารถในการเชื่อมต่อกับ Exchange Server และแสดงรายการโฟลเดอร์และโฟลเดอร์ย่อยทั้งหมด คุณสามารถดึงโฟลเดอร์ย่อยทั้งหมดจากแต่ละโฟลเดอร์โดยทำซ้ำได้ อีกทั้งยังให้ความสามารถในการเรียงลำดับโฟลเดอร์พร้อมการแบ่งหน้า จากไคลเอนต์ Exchange โดยใช้ Exchange Web Service (EWS) บทความนี้แสดงวิธีดึงโฟลเดอร์ย่อยทั้งหมดจากเซิร์ฟเวอร์ Exchange และดึงโฟลเดอร์พร้อมการแบ่งหน้า.

โค้ดสแนปต่อไปนี้แสดงวิธีแสดงรายการโฟลเดอร์จาก Exchange Server

รับข้อมูลประเภทโฟลเดอร์

นี้ FolderType คุณสมบัติที่ให้โดย ExchangeFolderInfo คลาสสามารถใช้เพื่อรับข้อมูลเกี่ยวกับประเภทของโฟลเดอร์ ซึ่งแสดงในตัวอย่างโค้ดด้านล่าง

แสดงรายการโฟลเดอร์พร้อมการสนับสนุนการแบ่งหน้า

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการใช้การสนับสนุนการแบ่งหน้าโดยใช้ EWS.

เข้าถึงโฟลเดอร์/ซับโฟลเดอร์ที่กำหนดเอง

IEWSClient ทำให้ผู้พัฒนาสามารถเข้าถึงโฟลเดอร์หรือโฟลเดอร์ย่อยที่กำหนดเองใดๆ จากกล่องเมลได้. FolderExists() ฟังก์ชันของ IEWSClient ส่งกลับค่า URI ของโฟลเดอร์/ซับโฟลเดอร์ที่กำหนดเอง ซึ่งสามารถใช้เพื่อเข้าถึงโฟลเดอร์เป้าหมายได้ ในตัวอย่างต่อไปนี้ จะเข้าถึงโฟลเดอร์ที่กำหนดเองชื่อ "TestInbox" ซึ่งสร้างภายใต้ INBOX และแสดงข้อความทั้งหมดจากโฟลเดอร์นี้ เพื่อทำงานนี้ ให้ทำตามขั้นตอนต่อไปนี้:

เริ่มต้น IEWSClient อ็อบเจ็กต์โดยให้ข้อมูลรับรองที่ถูกต้อง
เข้าถึงกล่องเมลเริ่มต้น.
เข้าถึงโฟลเดอร์พาเรนท์ ซึ่งในตัวอย่างนี้คือ INBOX โฟลเดอร์พาเรนท์นี้อาจเป็นโฟลเดอร์ที่กำหนดเองได้เช่นกัน.
ใช้ FolderExists() เพื่อค้นซับโฟลเดอร์ที่กำหนดเอง เช่น "TestInbox" จะคืนค่า URI ของ "TestInbox"
ใช้ Uri นี้เพื่อเข้าถึงข้อความทั้งหมดในโฟลเดอร์ที่กำหนดเองนั้น.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการเข้าถึงโฟลเดอร์หรือโฟลเดอร์ย่อยที่กำหนดเองของกล่องเมลด้วย EWS.

แสดงรายการโฟลเดอร์สาธารณะ

คัดลอกข้อความไปยังโฟลเดอร์อื่น

ซิงค์รายการในโฟลเดอร์

Aspose.Email for .NET API IEWSClient อินเทอร์เฟซให้คุณลักษณะการซิงค์โฟลเดอร์ Exchange กับเนื้อหาของมัน SyncFolder เมธอดที่เปิดเผยโดย IEWSClient คลาสสามารถใช้เพื่อทำข้อมูลการซิงค์โฟลเดอร์บนโฟลเดอร์ที่ระบุ โค้ดตัวอย่างต่อไปนี้แสดงวิธีการซิงค์ข้อมูลโฟลเดอร์ Exchange.

ดึงสิทธิ์ของโฟลเดอร์

ผู้ใช้จะได้รับสิทธิ์บนโฟลเดอร์สาธารณะใน Exchange Server ซึ่งจำกัด/กำหนดระดับการเข้าถึงของผู้ใช้ต่อโฟลเดอร์เหล่านี้ ExchangeFolderPermission คลาสให้คุณสมบัติของสิทธิ์ชุดหนึ่งสำหรับโฟลเดอร์ Exchange เช่น PermissionLevel, ไม่ว่าจะสามารถ CanCreateItems, DeleteItems, และดำเนินการอื่นๆ ตามที่กำหนดโดยคุณลักษณะของสิทธิ์ สามารถดึงสิทธิ์ได้โดยใช้ GetFolderPermissions() เมธอดของ IEWSClient. บทความนี้แสดงวิธีดึงสิทธิ์ที่กำหนดให้กับโฟลเดอร์สาธารณะสำหรับผู้ใช้ทั้งหมดที่มีการเข้าถึงโฟลเดอร์ที่แชร์.

เพื่อทำงานนี้:

เริ่มต้น EWSClient.
ใช้ ListPublicFolders เพื่อรับรายการโฟลเดอร์สาธารณะทั้งหมด
ดึงสิทธิ์ที่เชื่อมโยงกับโฟลเดอร์โดยใช้ GetFolderPermisssions() เมธอด

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการใช้ EWSClient คลาสสำหรับดึงสิทธิ์ที่ใช้กับโฟลเดอร์.

สร้างและจัดการโฟลเดอร์/ซับโฟลเดอร์

Aspose.Email API มีความสามารถในการสร้างโฟลเดอร์ในเมลบ็อกซ์ Exchange ส่วน CreateFolder เมธอดของ IEWSClient สามารถใช้เพื่อจุดประสงค์นี้ เพื่อสร้างโฟลเดอร์ในเมลบ็อกซ์ของ Exchange เซิร์ฟเวอร์ สามารถทำตามขั้นตอนต่อไปนี้

สร้างอินสแตนซ์ของ IEWSClient.
ตั้งค่า UseSlashAsFolderSeparator คุณสมบัติตามที่ต้องการ หากตั้งค่าเป็น true แอปพลิเคชันจะพิจารณา "Slash" เป็นตัวคั่นโฟลเดอร์และสร้างซับโฟลเดอร์หลังจากสแลช
ใช้ CreateFolder เมธอดเพื่อสร้างโฟลเดอร์

โค้ดสแนปต่อไปนี้แสดงวิธีสร้างโฟลเดอร์และโฟลเดอร์ย่อย

สำรองโฟลเดอร์เป็น PST

บ่อยครั้งที่ผู้ใช้ต้องการสำรองข้อมูลของโฟลเดอร์อีเมลทั้งหมดหรือบางส่วน Aspose.Email มีความสามารถในการสำรองโฟลเดอร์เมลบ็อกซ์ Exchange ทั้งหมดหรือที่ระบุไปยัง PST บทความนี้อธิบายการสำรองโฟลเดอร์ Exchange ไปยัง PST พร้อมตัวอย่างโค้ด เพื่อสำรองโฟลเดอร์เซิร์ฟเวอร์ Exchange ให้ทำตามขั้นตอนต่อไปนี้

เริ่มต้น IEWSClient พร้อมข้อมูลรับรองผู้ใช้
เพิ่มข้อมูลโฟลเดอร์ที่ต้องการลงใน ExchangeFolderInfoCollection
ใช้ของไคลเอนต์ สำรองข้อมูล เมธอดเพื่อส่งออกเนื้อหาโฟลเดอร์เป็น PST

โค้ดสแนปต่อไปนี้แสดงวิธีสำรองโฟลเดอร์ Exchange ไปยัง PST

Net: วิธีจัดการกฎของ Exchange Server ด้วย EWS ใน C#

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

Aspose.Email for .NET สามารถใช้จัดการกฎบน Exchange Server ด้วยการใช้ EWSClient คลาสนี้ ใช้ Exchange Web Services (EWS) ซึ่งมีใน Exchange Server 2007 และรุ่นต่อๆ ไป บทความนี้อธิบายวิธีจัดการกฎ:

อ่านกฎที่มีอยู่แล้วบนเซิร์ฟเวอร์.
สร้างกฎใหม่.
อัปเดตกฎที่มีอยู่.

Microsoft Exchange Server 2010 Service Pack 1 จำเป็นสำหรับคุณสมบัติทั้งหมดที่อธิบายในบทความนี้

อ่านกฎ

เพื่อรับกฎทั้งหมดจาก Exchange Server:

เชื่อมต่อกับ Exchange Server ด้วยการใช้ IEWSClient คลาส.
เรียกใช้ IEWSClient.GetInboxRules() เมธอดเพื่อรับกฎทั้งหมด
ในลูป foreach ให้เรียกดูกฎทั้งหมดและแสดงคุณสมบัติกฎเช่น เงื่อนไข การกระทำ และชื่อ

โค้ดสแนปต่อไปนี้แสดงวิธีอ่านกฎ

สร้างกฎ

เพื่อสร้างกฎใหม่บน Exchange Server ให้ทำตามขั้นตอนต่อไปนี้:

เชื่อมต่อกับ Exchange Server ด้วยการใช้ IEWSClient อินเทอร์เฟซ
สร้างอินสแตนซ์ใหม่ของ InboxRule คลาสและตั้งค่าคุณสมบัติบังคับต่อไปนี้:
1. ชื่อที่แสดง
2. เงื่อนไข
3. การกระทำ
เรียกใช้ IEWSClient.CreateInboxRule() เมธอดเพื่อสร้างกฎ

โค้ดสแนปต่อไปนี้แสดงวิธีสร้างกฎใหม่

อัปเดตกฎ

เพื่ออัปเดตกฎบน Exchange Server:

เชื่อมต่อกับ Exchange Server ด้วยการใช้ IEWSClient คลาส.
เรียกใช้ IEWSClient.GetInboxRules() เมธอดเพื่อรับกฎทั้งหมด
ในลูป foreach ให้เรียกดูกฎทั้งหมดและเลือกกฎที่ต้องการเปลี่ยนโดยจับคู่ DisplayName ในเงื่อนไข
อัปเดตคุณสมบัติของกฎ
เรียกใช้ IESClient.UpdateInboxRule() เมธอดเพื่ออัปเดตกฎ

โค้ดสแนปต่อไปนี้แสดงวิธีอัปเดตกฎ

Net: จัดการงานของ Exchange Server ด้วย EWS ใน C#

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

Aspose.Email รองรับการประมวลผลงานบน Exchange โดยใช้ ExchangeTask class. คุณสมบัติต่าง ๆ ที่เปิดเผยโดย ExchangeTask, เช่น Subject, สถานะ, วันครบกำหนด, และ ระดับความสำคัญ, สามารถใช้เพื่อกำหนดค่าการทำงานบน Exchange. The EWSClient คลาสนี้เปิดเผยฟังก์ชันเช่น CreateTask, UpdateTask, และ DeleteTask ซึ่งใช้ในการประมวลผลงานบน Exchange. บทความนี้แสดงวิธี:

สร้างงานใหม่.
ตั้งค่าโซนเวลาของงาน.
อัปเดตงาน.
ลบงาน.
ส่งคำขอทำงาน
บันทึกงานลงดิสก์

สร้างงาน

โค้ดสคริปต์ต่อไปนี้แสดงวิธีการสร้างงานใหม่.

ระบุโซนเวลา

นี้ IEWSClient อินเทอร์เฟซและ ExchangeTask จัดหา TimeZoneId คุณสมบัติสำหรับกำหนดข้อมูลโซนเวลาเมื่อสร้างงาน โค้ดสคริปต์ต่อไปนี้แสดงวิธีการระบุ Timezone.

อัปเดตงาน

โค้ดตัวอย่างต่อไปนี้แสดงวิธีอัปเดตงานบนเซิร์ฟเวอร์ Exchange.

ลบงาน

โค้ดตัวอย่างต่อไปนี้แสดงวิธีลบงานบนเซิร์ฟเวอร์ Exchange.

ส่งคำขอทำงาน

บริการ Aspose.Email Exchange มีความสามารถในการส่งคำขอทำงานคล้าย Outlook. โค้ดตัวอย่างต่อไปนี้แสดงวิธีโหลดข้อความคำขอทำงานจากดิสก์และส่งโดยใช้ IEWSClient.

บันทึกงานลงดิสก์

Aspose.Email ยังอนุญาตให้บันทึกงาน Exchange ลงดิสก์ในรูปแบบ Outlook MSG. โค้ดตัวอย่างต่อไปนี้แสดงวิธีบันทึกงานลงดิสก์.

รายการงาน

IEWSClient ให้ ListTasks เมธอดที่สามารถใช้ดึงงานจาก Exchange Web Service. มีการโอเวอร์โหลดหลายแบบที่สามารถใช้เพื่อดึงรายการงานจากโฟลเดอร์เฉพาะหรือโดยใช้เงื่อนไขการค้นหา. ตัวอย่างโค้ดด้านล่างแสดงการดึงงานทั้งหมดหรือเฉพาะงานจากโฟลเดอร์ Tasks.

กรองงาน

Aspose.Email ให้ความสามารถในการดึงงานเฉพาะจากเซิร์ฟเวอร์แทนการดึงงานทั้งหมดจากเซิร์ฟเวอร์ API สามารถใช้ดึงงานตามสถานะของงาน เช่น Completed, Deferred, In Progress, Not started หรือ Waiting on others. The ExchangeQueryBuilder คลาสนี้สามารถใช้ระบุเกณฑ์ที่ต้องการโดยใช้คุณสมบัติ Status. นอกจากนี้ยังอนุญาตให้ระบุหลายเงื่อนไขเพื่อดึงงานที่ต้องการจาก Exchange Server. ตัวอย่างโค้ดต่อไปนี้แสดงการทำเช่นนั้น.

Net: จัดการการกำหนดค่าผู้ใช้บน Exchange Server ด้วย EWS ใน C#

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

Aspose.Email for .NET สามารถใช้เพื่อจัดการการกำหนดค่าผู้ใช้บน Exchange Server ด้วย EWSClient คลาส นี้ใช้ Exchange Web Services ซึ่งมีเฉพาะใน Exchange Server 2007 ขึ้นไป ในบทความนี้ เราจะดูวิธีการอ่าน, สร้าง, อัปเดต และลบการกำหนดค่าผู้ค้าบน Exchange Server 2010 จำเป็นต้องมี Microsoft Exchange Server 2010 Service Pack 1 สำหรับคุณลักษณะทั้งหมดที่อธิบายในบทความนี้ โค้ดตัวอย่างต่อไปนี้แสดงวิธีเชื่อมต่อกับ Exchange Server 2010 ในตัวอย่างทั้งหมดของบทความนี้.

อ่านการกำหนดค่าผู้ใช้

เพื่อรับข้อมูลการกำหนดค่าผู้ใช้ของโฟลเดอร์เฉพาะจาก Exchange Server:

เชื่อมต่อกับ Exchange Server ด้วยการใช้ IEWSClient อินเทอร์เฟซ
เรียกใช้ IEWSClient.GetUserConfiguration() เมธอดเพื่อรับการกำหนดค่าผู้ใช้ของโฟลเดอร์
แสดงคุณสมบัติการกำหนดค่าผู้ใช้ เช่น ID, ชื่อ และรายการพจนานุกรมในรูปแบบคู่คีย์-ค่า.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการอ่านการกำหนดค่าผู้ใช้.

สร้างการกำหนดค่าผู้ใช้

เพื่อสร้างการกำหนดค่าผู้ใช้สำหรับโฟลเดอร์เฉพาะบน Exchange Server:

เชื่อมต่อกับ Exchange Server ด้วยการใช้ IEWSClient อินเทอร์เฟซ
เรียกใช้ IEWSClient.CreateUserConfiguration() เมธอดเพื่อสร้างการกำหนดค่าผู้ใช้สำหรับโฟลเดอร์

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีสร้างการกำหนดค่าผู้ใช้

อัปเดตการกำหนดค่าผู้ใช้

เพื่ออัปเดตการกำหนดค่าผู้ใช้สำหรับโฟลเดอร์เฉพาะใน Exchange Server:

เชื่อมต่อกับ Exchange Server ด้วยการใช้ IEWSClient อินเทอร์เฟซ
เรียกใช้ IEWSClient.UpdateUserConfiguration() เมธอดเพื่ออัปเดตการกำหนดค่าผู้ใช้ของโฟลเดอร์

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการอัปเดตการกำหนดค่าผู้ใช้.

ลบการกำหนดค่าผู้ใช้

เพื่อลบการกำหนดค่าผู้ใช้สำหรับโฟลเดอร์เฉพาะใน Exchange Server:

เชื่อมต่อกับ Exchange Server ด้วยการใช้ IEWSClient อินเทอร์เฟซ
เรียกใช้ IEWSClient.DeleteUserConfiguration() เมธอดเพื่อลบการกำหนดค่าผู้ใช้ของโฟลเดอร์

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการลบการกำหนดค่าผู้ใช้.

Net: จัดการคุณสมบัติเพิ่มเติมของข้อความอีเมลโดยใช้ EWS ใน C#

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

Aspose.Email API ช่วยให้คุณสร้าง ดึง และอัปเดตคุณสมบัติเพิ่มเติมของข้อความโดยใช้คล라이언ต์ EWS ของ API ตัวอย่างโค้ดต่อไปนี้แสดงการทำเช่นนี้โดยการสร้างแอตทริบิวต์เพิ่มเติม เพิ่มลงในข้อความบนเซิร์ฟเวอร์และดึงข้อความเป็น MapiMessage จาก Exchange server โดยใช้ไคลเอนต์ 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: ทำงานอัตโนมัติการเก็บถาวรอีเมลในเซิร์ฟเวอร์ Exchange ด้วย C# และ EWS API

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

Aspose.Email สำหรับ .NET มี API ครบวงจรเพื่อจัดการและประมวลผลอีเมลบน Exchange Server คู่มือนี้แสดงวิธีแสดงรายการอีเมลในโฟลเดอร์ Inbox ของกล่องเมล Exchange และเก็บถาวรโดยใช้โปรแกรมด้วย IEWSClient อินเทอร์เฟซ. The IEWSClient.ArchiveItem เมธอดของ IEWSClient อินเทอร์เฟซนี้อนุญาตให้คุณย้ายรายการไปยังกล่องเก็บถาวรของผู้ใช้ มันมีการโอเวอร์โหลดสี่แบบที่แสดงด้านล่าง:

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้ Aspose.Email เพื่อเชื่อมต่อกับเซิร์ฟเวอร์ Exchange, แสดงรายการข้อความ, และเก็บถาวรด้วย IEWSClient.ArchiveItem เมธอด การเก็บอีเมลทำได้โดยการย้ายแต่ละรายการไปยังกล่องเก็บถาวรโดยใช้ UniqueUri.

Net: ดึงอีเมลจากกล่องเมลที่แชร์โดยใช้ C# และ EWS API

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

Aspose.Email รองรับการเข้าถึงข้อความจากกล่องจดหมายที่แชร์ เพื่อทำเช่นนี้ คุณเชื่อมต่อกับกล่องจดหมายหลักของคุณโดยใช้ EWSClient class. เพื่อเข้าถึงข้อความจากกล่องจดหมายที่แชร์ คุณต้องส่งชื่อกล่องจดหมายที่แชร์เป็นพารามิเตอร์ประเภทสตริงไปยัง ListMessages หรือ ListItems เมธอด.

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเข้าถึงข้อความจากกล่องจดหมายที่แชร์โดยใช้ ListItems เมธอด.

Net: โทเค็น OAuth แบบอะซิงค์และการจัดการอีเมล EWS ใน C#

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

เมธอด Async เพื่อดึง OAuth Token

แตกต่างจากเมธอดแบบซิงโครนัส เมธอดแบบอะซิงโครนัสไม่บล็อกและอนุญาตให้ทำหลายคำขอพร้อมกัน เมธอดอะซิงโครนัสจะมีชื่อที่ลงท้ายด้วย Async.

หมายเหตุ: เมธอด Async มีให้ใช้ในเวอร์ชันที่รองรับ .NET Core, .NET Framework 4.5 และรุ่นต่อ ๆ ไป.

ตัวอย่างโค้ดต่อไปนี้กำหนด SomeAsyncTokenProvider คลาส ซึ่งทำการ implements the IAsyncTokenProvider อินเทอร์เฟซ คลาสนี้ทำการ implements GetAccessTokenAsync เมธอดแบบอะซิงโครนัสที่คืนค่าเป็น Task ชนิด OAuthToken เมธอดนี้ดึง 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 วัตถุเป็นพารามิเตอร์ วิธีนี้คืนอ็อบเจ็กต์ Task ดังนั้นจึงรอผลลัพธ์ก่อนดำเนินต่อไป The 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 เป็นพารามิเตอร์. Method ถูก await เนื่องจากคืนค่าเป็นอ็อบเจกต์ Task. The cancellationToken ออบเจกต์ถูกส่งเป็นพารามิเตอร์เลือกให้กับ SendAsync เมธอด.

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

ดึงข้อความอีเมล

เพื่อดึงข้อความอีเมลแบบอะซิงค์ ใช้ตัวอย่างโค้ดต่อไปนี้พร้อมขั้นตอนที่อธิบายด้านล่าง:

เรียกใช้ FetchItemAsync method ของ EWSclient. method รับพารามิเตอร์สองตัว:
- messageUri เป็นสตริงที่แทน URI ของข้อความที่จะดึง
- cancellationToken เป็นพารามิเตอร์เลือกที่สามารถใช้เพื่อยกเลิกการดำเนินการแบบอะซิงค์ method ส่งคืนอ็อบเจกต์ Task ที่ให้ผลลัพธ์เป็น MapiMessage ออบเจกต์เมื่อการดำเนินการแบบอะซิงค์เสร็จ คำสำคัญ "await" ถูกใช้เพื่อรอให้ Task เสร็จสมบูรณ์ก่อนทำต่อ
กำหนดให้กับ fetched ตัวแปรได้รับผลลัพธ์จาก Task ที่เสร็จสมบูรณ์ ซึ่งเป็น MapiMessage ออบเจกต์ที่บรรจุข้อมูลข้อความที่ดึงมา
```
   var fetched = await ewsClient.FetchItemAsync(messageUri, cancellationToken: cancellationToken);
```

เพิ่มข้อความอีเมล

ตัวอย่างโค้ดด้านล่างพยายามเพิ่มข้อความอีเมลแบบอะซิงค์ โค้ดทำตามขั้นตอนต่อไปนี้:

เรียก AppendMessagesAsync method ของ EWSclient ออบเจกต์. method รับ EwsAppendMessage ออบเจกต์ที่บรรจุปารามิเตอร์: ข้อความที่จะเพิ่ม, URI ของโฟลเดอร์เป้าหมาย, และ cancellation token.
สร้าง EwsAppendMessage อ็อบเจ็กต์โดยใช้ สร้าง method และกำหนดค่าด้วยการเรียก method ต่อไปนี้:
- AddMessage เพิ่มข้อความลงในการดำเนินการเพิ่ม
- SetFolder ตั้งค่า URI ของโฟลเดอร์เป้าหมายสำหรับการเพิ่ม
- SetCancellationToken ตั้งค่า cancellation token ที่สามารถใช้เพื่อยกเลิกการดำเนินการแบบอะซิงค์
นี้ AppendMessagesAsync method ส่งคืนอ็อบเจกต์ 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 method ของ EWSClient ออบเจกต์. method รับพารามิเตอร์สามตัว:
- messageUri เป็นสตริงที่แทน URI ของข้อความที่จะคัดลอก
- destinationFolderUri เป็นสตริงที่แทน URI ของโฟลเดอร์ปลายทาง
- cancellationToken เป็นพารามิเตอร์เลือกที่สามารถใช้เพื่อยกเลิกการดำเนินการแบบอะซิงค์.
method ส่งคืนอ็อบเจกต์ Task ที่ให้ผลลัพธ์เป็นสตริงเมื่อการดำเนินการแบบอะซิงค์เสร็จ คำสำคัญ "await" ถูกใช้เพื่อรอให้ Task เสร็จสมบูรณ์ก่อนทำต่อ
newItemUri ตัวแปรได้รับค่าจาก Task ที่เสร็จสมบูรณ์ ซึ่งเป็นสตริงที่มี URI ของสำเนาข้อความที่สร้างใหม่

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

ลบรายการ

โค้ดต่อไปนี้พยายามลบข้อความอีเมลแบบอะซิงค์.

มันเรียก DeleteItemAsync method ของอ็อบเจกต์ EWSClient. method รับพารามิเตอร์สามตัว:

newItemUri เป็นสตริงที่แทน URI ของรายการที่จะลบ
DeletionOptions.DeletePermanently ระบุว่ารายการควรจะถูกลบอย่างถาวร
cancellationToken เป็นพารามิเตอร์เลือกที่สามารถใช้เพื่อยกเลิกการดำเนินการแบบอะซิงค์.

method ส่งคืนอ็อบเจกต์ Task ที่เสร็จสมบูรณ์เมื่อการดำเนินการแบบอะซิงค์เสร็จ คำสำคัญ "await" ถูกใช้เพื่อรอให้ Task เสร็จสมบูรณ์ก่อนทำต่อ

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

ลบโฟลเดอร์

โค้ดต่อไปนี้พยายามลบโฟลเดอร์แบบอะซิงค์.

มันเรียก DeleteFolderAsync method ของอ็อบเจกต์ EWSClient. method รับพารามิเตอร์สามตัว:

folderUri เป็นสตริงที่แทน URI ของโฟลเดอร์ที่จะลบ
deletePermanently ระบุว่าจะลบโฟลเดอร์อย่างถาวรหรือย้ายไปยังโฟลเดอร์ "Deleted Items"
cancellationToken เป็นพารามิเตอร์เลือกที่สามารถใช้เพื่อยกเลิกการดำเนินการแบบอะซิงค์.

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

อัปเดตรายการ

ตัวอย่างโค้ดด้านล่างพยายามอัปเดตรายการแบบอะซิงค์ มันทำตามขั้นตอนต่อไปนี้:

สร้าง EwsUpdateItem อ็อบเจ็กต์โดยใช้ สร้าง method, ส่งผ่านออบเจกต์รายการ. EwsUpdateItem แสดงพารามิเตอร์ของการอัปเดต. The SetCancellationToken method ถูกเรียกบน EwsUpdateItem ออบเจกต์, ส่งผ่านใน cancellationToken พารามิเตอร์ ซึ่งเป็นพารามิเตอร์เลือกที่สามารถใช้เพื่อยกเลิกการดำเนินการแบบอะซิงค์
ส่งผ่าน EwsUpdateItem ออบเจกต์เป็นพารามิเตอร์สำหรับ UpdateItemAsync method ของ EWSClient.
นี้ UpdateItemAsync method ส่งคืนอ็อบเจกต์ Task ที่เสร็จสมบูรณ์เมื่อการดำเนินการแบบอะซิงค์เสร็จ คำสำคัญ "await" ถูกใช้เพื่อรอให้ Task เสร็จสมบูรณ์ก่อนทำต่อ

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

Net: เปิดการบันทึกกิจกรรมสำหรับ EWS Client ในแอปพลิเคชัน .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. การสื่อสารแบบรวมเช่น การรับข้อมูลการกำหนดค่า, เริ่มการโทรออก, ดึงข้อมูลการโทรตาม ID การโทรและตัดการโทรตาม ID ได้รับการสนับสนุนในปัจจุบัน. ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการดึงข้อมูลการกำหนดค่าการสื่อสารแบบรวมจาก Microsoft Exchange Server 2010.

รับเคล็ดลับอีเมล

Microsoft Exchange Server ได้เพิ่มคุณลักษณะใหม่หลายอย่างใน Exchange Server 2010 และ 2013 หนึ่งในนั้นทำให้ผู้ใช้สามารถรับเคล็ดลับการส่งเมลขณะเขียนข้อความอีเมลได้ เคล็ดลับเหล่านี้มีประโยชน์อย่างมากเพราะให้ข้อมูลก่อนที่อีเมลจะถูกส่ง ตัวอย่างเช่น หากที่อยู่อีเมลในรายการผู้รับผิดพลาด จะมีเคล็ดลับแสดงให้คุณทราบว่าที่อยู่นั้นไม่ถูกต้อง เคล็ดลับการส่งเมลยังทำให้คุณเห็นการตอบกลับนอกสำนักก่อนส่งอีเมล: Exchange Server (2010 & 2013) จะส่งเคล็ดลับการส่งเมลเมื่อกำลังเขียนข้อความอีเมล หากผู้รับหนึ่งคนหรือหลายคนตั้งค่าการตอบกลับนอกสำนัก Microsoft Exchange Server 2010 Service Pack 1 เป็นสิ่งจำเป็นสำหรับคุณลักษณะทั้งหมดที่แสดงในบทความนี้ ส่วนโค้ดตัวอย่างต่อไปนี้แสดงวิธีใช้ EWSClient คลาสที่ใช้ Exchange Web Services, มีให้ใน Microsoft Exchange Server 2007 และรุ่นต่อ ๆ ไป.

การแสดงตนของ Exchange

การแอบทำหน้าที่ (Impersonation) ของ Exchange อนุญาตให้บุคคลหนึ่งแอบทำหน้าที่เป็นบัญชีอื่นและดำเนินการต่าง ๆ โดยใช้สิทธิ์ของบัญชีที่ถูกแอบทำหน้าที่แทนของตนเอง ในขณะที่การมอบหมาย (delegation) ให้ผู้ใช้ทำงานในนามของผู้ใช้อื่น การแอบทำหน้าที่ทำให้พวกเขาสามารถทำงานเหมือนผู้ใช้คนอื่น Aspose.Email รองรับการแอบทำหน้าที่ของ Exchange. The EWSClient class ให้ ImpersonateUser และ ResetImpersonation เมธอดเพื่ออำนวยความสะดวกให้กับคุณลักษณะนี้.

เพื่อทำงานนี้:

เริ่มต้น ExchangeWebServiceClient สำหรับผู้ใช้ 1.
เริ่มต้น ExchangeWebServiceClient สำหรับผู้ใช้ 2.
เพิ่มข้อความทดสอบไปยังบัญชี.
เปิดใช้งานการแสดงตน.
รีเซ็ตการแสดงตน.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการใช้ EWSClient คลาสสำหรับทำฟีเจอร์การแสดงตน (Impersonation).

ฟีเจอร์ Auto Discover ด้วย EWS

Aspose.Email API ช่วยให้คุณค้นพบการตั้งค่า Exchange Server ด้วยการใช้ EWS Client

ยกเลิกการกู้คืน PST ไปยัง Exchange Server

Aspose.Email API ช่วยให้คุณกู้คืนไฟล์ PST ไปยัง Exchange Server. อย่างไรก็ตาม หากการดำเนินการใช้เวลานานเนื่องจากไฟล์ PST มีขนาดใหญ่ อาจจำเป็นต้องระบุเกณฑ์สำหรับการยกเลิกการดำเนินการ. สามารถทำได้โดยใช้ API ตามที่แสดงในตัวอย่างโค้ดต่อไปนี้.

หมายเหตุ: ตัวอย่างต้องการให้เพิ่มคลาสต่อไปนี้ด้วย.


 public class CustomAbortRestoreException : Exception { }

Documentation – ทำงานกับ Exchange EWS Client

Net: การเชื่อมต่อกับ Exchange Server

เชื่อมต่อกับ Exchange Server ด้วย EWS

เพิ่ม Header กำหนดเองในการเริ่มต้น EWSClient

เชื่อมต่อกับ Exchange Server ด้วย IMAP

การตั้งค่าโปรโตคอลการเข้ารหัสที่ต้องการ

เชื่อมต่อกับ Exchange Server โดยใช้ Modern Authentication

การตั้งค่าก่อนใช้งาน

การลงทะเบียนแอปกับ Azure Active Directory

ใช้การตรวจสอบสิทธิ์สมัยใหม่กับ EWSClient

รับโทเค็นการอนุญาต

การตรวจสอบสิทธิ์ด้วยโทเค็น

ใช้ Modern Authentication กับไคลเอนท์ IMAP, POP หรือ SMTP

เปิดหรือปิด IMAP, POP, SMTP AUTH ในศูนย์ผู้ดูแล Microsoft 365

เรียกคืนโทเค็นการตรวจสอบสิทธิ์จากเซิร์ฟเวอร์โทเค็น

ตรวจสอบสิทธิ์ด้วยโทเค็น

คืนค่า Client Request ID

เพิ่ม X-AnchorMailbox และ Header อื่น ๆ ไปยังคำขอ EWS

ละเลยหรือข้ามใบรับรอง SSL ที่ไม่ถูกต้องหรือหมดอายุ

Net: ดึงและจัดการข้อมูลกล่องจดหมายของ Exchange Server ด้วย EWS

ดึงข้อมูลกล่องจดหมายโดยใช้ EWS

ส่งข้อความอีเมล

ดึง URI ของรายการที่ส่ง

อ่านอีเมลจากกล่องจดหมายของผู้ใช้อื่น

การแสดงรายการข้อความ

รายการข้อความอย่างง่าย

แสดงรายการข้อความจากโฟลเดอร์

แสดงรายการข้อความด้วยการสนับสนุนการแบ่งหน้า

ดึงข้อมูลประเภทของข้อความ

ดึงคลาสของข้อความ

การบันทึกข้อความ

บันทึกข้อความเป็นไฟล์ EML

บันทึกข้อความลง Memory Stream

บันทึกข้อความเป็นไฟล์ MSG

กำลังดึงข้อความ

ดึงข้อความตาม URI

ดึงข้อความจากกล่องจดหมาย

ดึงข้อความโดยไม่มีไฟล์แนบ

ดึงอีเมลพร้อมไฟล์แนบ

ดึงรายการพร้อมไฟล์แนบโดยใช้ EWS Client

ดึงขนาดข้อความล่วงหน้า

ดาวน์โหลดข้อความอย่างทำซ้ำ

ดาวน์โหลดข้อความจากโฟลเดอร์สาธารณะ

ย้ายข้อความ

การย้ายข้อความระหว่างโฟลเดอร์

ลบข้อความ

คัดลอกข้อความ

คัดลอกข้อความไปยังโฟลเดอร์อื่น

Net: กรองและจัดเรียงข้อความในกล่องเมล Exchange Server ด้วย EWS

กรองและจัดเรียงข้อความโดยใช้ EWS

กรองข้อความตามเกณฑ์

ตามวันที่วันนี้

ตามช่วงวันที่

ตามผู้ส่ง

ตามโดเมน

ตามผู้รับ

ตาม MessageID

ตามการแจ้งการส่งเมล

ตามขนาดข้อความ

การสร้างคิวรีซับซ้อน

การรวมคิวรีด้วย AND

การรวมคิวรีด้วย OR

การกรองอีเมลแบบแยกแยะตัวพิมพ์ใหญ่-เล็ก

กรองข้อความด้วยการสนับสนุนการแบ่งหน้า

จัดเรียงข้อความที่กรองแล้วในลำดับเพิ่มขึ้น/ลดลง

กรองข้อความโดยใช้ AQS

Net: กรองข้อความด้วย AQS จากกล่องเมล Exchange

การสร้างคำค้นหา AQS

ใช้ Query Builder

คิวรี AQS โดยตรง

Net: การจัดการรายการสนทนาบน Exchange Server

ค้นหาการสนทนา

คัดลอกการสนทนา

ย้ายการสนทนา

ลบการสนทนา

Net: จัดการรายการปฏิทินด้วย Exchange Web Services (EWS) ด้วย C#

ส่งคำขอประชุม

จัดการรายการปฏิทินผ่าน EWS

แสดงรายการนัดหมายพร้อมการสนับสนุนการแบ่งหน้า

เพิ่มเหตุการณ์ไปยังโฟลเดอร์ปฏิทินรอง