Documentation – Hướng dẫn nhà phát triển

Net: Gửi tin nhắn Email qua MailGun và SendGrid

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

Aspose.Email cung cấp khả năng gửi tin nhắn email bằng dịch vụ MailGun hoặc SendGrid. API thống nhất của nó cho phép bạn khởi tạo một client, chuẩn bị và gửi tin nhắn email.

Đầu tiên, cần thiết lập các tùy chọn tùy theo dịch vụ sẽ được sử dụng để gửi tin nhắn. DeliveryServiceOptions lớp sẽ giúp bạn thực hiện điều đó. Đoạn mã mẫu dưới đây cho thấy cách thiết lập các tùy chọn cho các dịch vụ.

các tùy chọn client MailGun:

string domain = "YOUR_MAILGUN_DOMEN";
string privApiKey = "YOUR_MAILGUN_PRIVATE_API_KEY";
var opt = new MailgunClientOptions { Domain = domain, ApiKey = privApiKey };

các tùy chọn client SendGrid:

string privApiKey = "YOUR_SENDGRID_PRIVATE_API_KEY";
var opt = new SendGridClientOptions { ApiKey = privApiKey };

Để chuẩn bị và gửi một tin nhắn, hãy sử dụng đoạn mã mẫu và các bước sau:

Tạo một đối tượng của IDeliveryServiceClient giao diện.
Tạo một tin nhắn eml mới bằng cách sử dụng MailMessage lớp. Xác định các thuộc tính của nó.
Sử dụng Gửi phương thức của đối tượng client để gửi email. Kết quả của thao tác gửi được lưu trong biến resp.
Nếu hoạt động gửi không thành công (resp.Successful là false), mã sẽ vào vòng lặp foreach để lặp qua bộ sưu tập ErrorMessages của đối tượng resp. Mỗi thông báo lỗi sẽ được in ra console bằng Console.WriteLine.

IDeliveryServiceClient client = DeliveryServiceClientFactory.Get(opt);

MailMessage eml = new MailMessage(fromAddress, toAddress, subject, body);

var resp = client.Send(eml);

if (!resp.Successful)
{
    foreach (var error in resp.ErrorMessages)
    {
        Console.WriteLine(error);
    }
}

Gửi tin nhắn bất đồng bộ

MailMessage eml = new MailMessage(fromAddress, toAddress, subject, body);

var sendTask = client.SendAsync(eml);
sendTask.Wait();

if (!sendTask.Result.Successful)
{
    foreach (var error in sendTask.Result.ErrorMessages)
    {
        Console.WriteLine(error);
    }
}

Đặt URL cơ sở tùy chỉnh cho SendGrid

Cấu hình URL cơ sở cho client SendGrid bằng cách sử dụng SendGridRegion kiểu liệt kê và các thuộc tính trong SendGridClientOptions lớp. Tính năng này cho phép các nhà phát triển chỉ định khu vực SendGrid mong muốn, chẳng hạn như EU hoặc khu vực toàn cầu mặc định, đảm bảo hiệu suất tối ưu và tuân thủ các yêu cầu khu vực. Đoạn mã mẫu dưới đây cho thấy cách cấu hình SendGridClientOptions để sử dụng khu vực EU của SendGrid. Điều chỉnh URL cơ sở giúp phù hợp với yêu cầu lưu trữ dữ liệu và độ trễ.

SendGridClientOptions opt = new SendGridClientOptions() 
{ 
    ApiKey = "YourApiKey", 
    Region = SendGridRegion.EU 
};
IDeliveryServiceClient client = DeliveryServiceClientFactory.Get(opt);
client.EndPoint = "https://api.eu.sendgrid.com";

Net: Làm việc với các tin nhắn MIME

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

Net: Quản lý cuộc hẹn: Tạo & Sửa đổi, Chuyển đổi ICS sang MSG

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

Tạo một cuộc hẹn và lưu vào ổ đĩa ở định dạng MSG hoặc ICS

Cái Appointment lớp trong Aspose.Email cho .NET có thể được sử dụng để tạo một cuộc hẹn mới. Trong bài viết này, chúng tôi đầu tiên tạo một cuộc hẹn và lưu nó vào ổ đĩa ở định dạng ICS. Các bước sau đây yêu cầu để tạo một cuộc hẹn và lưu nó vào ổ đĩa.

Tạo một đối tượng của Appointment class và khởi tạo nó với hàm khởi tạo này.
Truyền các đối số sau vào hàm khởi tạo ở trên
1. Địa điểm
2. Tóm tắt
3. Mô tả
4. Ngày bắt đầu
5. Ngày kết thúc
6. Người tổ chức
7. Người tham dự
Gọi Save() phương thức và chỉ định tên tệp và định dạng trong các đối số.

Cuộc hẹn có thể được mở trong Microsoft Outlook hoặc bất kỳ chương trình nào có thể tải tệp ICS. Nếu tệp được mở trong Microsoft Outlook, nó sẽ tự động thêm cuộc hẹn vào lịch Outlook.

Đoạn mã sau đây cho bạn thấy cách tạo và lưu một cuộc hẹn vào ổ đĩa ở định dạng ICS hoặc MSG.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET

// Create and initialize an instance of the Appointment class
Appointment appointment = new Appointment(
    "Meeting Room 3 at Office Headquarters",// Location
    "Monthly Meeting",                      // Summary
    "Please confirm your availability.",    // Description
    new DateTime(2015, 2, 8, 13, 0, 0),     // Start date
    new DateTime(2015, 2, 8, 14, 0, 0),     // End date
    "from@domain.com",                      // Organizer
    "attendees@domain.com");                // Attendees

// Save the appointment to disk in ICS format            
appointment.Save(fileName + ".ics", new AppointmentIcsSaveOptions());
Console.WriteLine("Appointment created and saved to disk successfully.");

// Save the appointment to disk in MSG format
appointment.Save(fileName + ".msg", new AppointmentMsgSaveOptions(););
Console.WriteLine("Appointment created and saved to disk successfully.");

Tạo một cuộc hẹn với nội dung HTML

Bạn có thể chỉ định các biểu diễn thay thế của mô tả sự kiện ở các loại nội dung khác nhau bằng cách sử dụng tiêu đề X-ALT-DESC. Nó cho phép người nhận tệp iCalendar chọn biểu diễn phù hợp nhất với nhu cầu của họ. Ví dụ, bạn có thể bao gồm mô tả văn bản thuần sử dụng loại nội dung "text/plain" và mô tả HTML sử dụng loại nội dung "text/html". Tiêu đề X-ALT-DESC được thêm cho mỗi biểu diễn thay thế. Để tạo một cuộc hẹn với nội dung HTML, đặt HtmlDescription thuộc tính.

Thử mẫu mã sau để tạo một cuộc hẹn với mô tả HTML thay thế:

Tạo một thể hiện mới của lớp Appointment.
Cung cấp các tham số cần thiết cho hàm khởi tạo Appointment:
- Xác định vị trí của cuộc hẹn.
- Đặt ngày và giờ bắt đầu.
- Đặt ngày và giờ kết thúc.
- Xác định người tổ chức.
- Xác định người tham dự.
Đặt HtmlDescription thuộc tính của đối tượng cuộc hẹn, cho biết mô tả ở định dạng HTML.
Đặt thuộc tính Description của đối tượng cuộc hẹn thành một chuỗi định dạng HTML, được bao quanh bởi chuỗi đa dòng:
- Mã HTML bao gồm một khối <style> định nghĩa lớp CSS có tên "text" với các kiểu chữ.
- Thân HTML chứa thẻ đoạn văn <p> với lớp CSS "text", và tin nhắn mời thực tế.
Đối tượng cuộc hẹn hiện đã sẵn sàng, và bạn có thể thực hiện các thao tác tiếp theo hoặc lưu nó dưới dạng tệp iCalendar.

var appointment = new Appointment("Bygget 83",
    DateTime.UtcNow, // start date
    DateTime.UtcNow.AddHours(1), // end date
    new MailAddress("TintinStrom@from.com", "Tintin Strom"), // organizer
    new MailAddress("AinaMartensson@to.com", "Aina Martensson")) // attendee
{
    HtmlDescription = @"
    <html>
     <style type=""text/css"">
      .text {
             font-family:'Comic Sans MS';
             font-size:16px;
            }
     </style>
    <body>
     <p class=""text"">Hi, I'm happy to invite you to our party.</p>
    </body>
    </html>"
};

Tạo yêu cầu cuộc hẹn bản nháp

Trong các bài viết trước đây của chúng tôi đã chỉ ra cách tạo và lưu một cuộc hẹn ở định dạng ICS. Thường thì cần tạo một yêu cầu cuộc hẹn ở chế độ Nháp, để thông tin cơ bản được thêm vào và sau đó bản nháp cuộc hẹn này có thể được chuyển tiếp cho người dùng khác để thực hiện các thay đổi cần thiết theo nhu cầu cá nhân. Để lưu một cuộc hẹn ở chế độ Nháp, MethodType thuộc tính của lớp Appointment nên được đặt thành AppointmentMethodType.Publish. Đoạn mã sau đây cho bạn thấy cách tạo yêu cầu cuộc hẹn dạng nháp.

string sender = "test@gmail.com";
string recipient = "test@email.com";

MailMessage message = new MailMessage(sender, recipient, string.Empty, string.Empty);

Appointment app = new Appointment(string.Empty, DateTime.Now, DateTime.Now, sender, recipient)
{
    MethodType = AppointmentMethodType.Publish
};

message.AddAlternateView(app.RequestApointment());

MapiMessage msg = MapiMessage.FromMailMessage(message);

// Save the appointment as draft.
msg.Save(dstDraft);

Console.WriteLine(Environment.NewLine + "Draft saved at " + dstDraft);

Tạo cuộc hẹn bản nháp từ văn bản

Đoạn mã sau cho thấy cách tạo một cuộc hẹn nháp từ Văn bản.

string ical = @"BEGIN:VCALENDAR
METHOD:PUBLISH
PRODID:-//Aspose Ltd//iCalender Builder (v3.0)//EN
VERSION:2.0
BEGIN:VEVENT
ATTENDEE;CN=test@gmail.com:mailto:test@gmail.com
DTSTART:20130220T171439
DTEND:20130220T174439
DTSTAMP:20130220T161439Z
END:VEVENT
END:VCALENDAR";

string sender = "test@gmail.com";
string recipient = "test@email.com";
MailMessage message = new MailMessage(sender, recipient, string.Empty, string.Empty);
AlternateView av = AlternateView.CreateAlternateViewFromString(ical, new ContentType("text/calendar"));
message.AlternateViews.Add(av);
MapiMessage msg = MapiMessage.FromMailMessage(message);
msg.Save(dataDir + "draft_out.msg");

Tùy chỉnh cuộc hẹn

Đặt trạng thái người tham dự của cuộc hẹn

API Aspose.Email cho .NET cho phép bạn đặt trạng thái của người tham dự cuộc hẹn khi soạn tin trả lời. Điều này thêm thuộc tính PARTSTAT vào tệp ICS.

DateTime startDate = new DateTime(2011, 12, 10, 10, 12, 11),
         endDate = new DateTime(2012, 11, 13, 13, 11, 12);
MailAddress organizer = new MailAddress("aaa@amail.com", "Organizer");
MailAddressCollection attendees = new MailAddressCollection();
MailAddress attendee1 = new MailAddress("bbb@bmail.com", "First attendee");
MailAddress attendee2 = new MailAddress("ccc@cmail.com", "Second attendee");

attendee1.ParticipationStatus = ParticipationStatus.Accepted;
attendee2.ParticipationStatus = ParticipationStatus.Declined;
attendees.Add(attendee1);
attendees.Add(attendee2);

Appointment target = new Appointment(location, startDate, endDate, organizer, attendees);

Tùy chỉnh định danh sản phẩm cho ICalendar

API Aspose.Email cho .NET cho phép lấy hoặc đặt định danh sản phẩm đã tạo đối tượng iCalendar.

string description = "Test Description";
Appointment app = new Appointment("location", "test appointment", description, DateTime.Today,
DateTime.Today.AddDays(1), "first@test.com", "second@test.com");

IcsSaveOptions saveOptions = IcsSaveOptions.Default;
saveOptions.ProductId = "Test Corporation";
app.Save(dataDir + "ChangeProdIdOfICS.ics", saveOptions);

Tải cuộc hẹn

Ngoài ra, Appointment lớp có thể được sử dụng để tải một cuộc hẹn từ tệp ICS.

Tải một cuộc hẹn ở định dạng ICS

Để tải một cuộc hẹn ở định dạng ICS, cần thực hiện các bước sau:

Tạo một đối tượng của Appointment lớp.
Gọi Load() phương thức bằng cách cung cấp đường dẫn của tệp ICS.
Đọc bất kỳ thuộc tính nào để lấy thông tin từ cuộc hẹn (tệp ICS).

Đoạn mã sau đây cho bạn thấy cách tải một cuộc hẹn ở định dạng ICS.

// Load an Appointment just created and saved to disk and display its details.
Appointment loadedAppointment = Appointment.Load(dstEmail);
Console.WriteLine(Environment.NewLine + "Loaded Appointment details are as follows:");
// Display the appointment information on screen
Console.WriteLine("Summary: " + loadedAppointment.Summary);
Console.WriteLine("Location: " + loadedAppointment.Location);
Console.WriteLine("Description: " + loadedAppointment.Description);
Console.WriteLine("Start date: " + loadedAppointment.StartDate);
Console.WriteLine("End date: " + loadedAppointment.EndDate);
Console.WriteLine("Organizer: " + appointment.Organizer);
Console.WriteLine("Attendees: " + appointment.Attendees);
Console.WriteLine(Environment.NewLine + "Appointment loaded successfully from " + dstEmail);

Chuyển đổi ICS sang MSG

API cho phép bạn dễ dàng chuyển đổi một cuộc hẹn thành đối tượng tin nhắn. Đoạn mã ví dụ sau đây cho thấy cách chuyển đổi yêu cầu cuộc hẹn thành MailMessage hoặc MapiMessage:

var appointment = Appointment.Load("appRequest.ics");

var eml = appointment.ToMailMessage();
var msg = appointment.ToMapiMessage();

Đọc nhiều sự kiện từ tệp ICS

List<Appointment> appointments = new List<Appointment>();
CalendarReader reader = new CalendarReader(dataDir + "US-Holidays.ics");

while (reader.NextEvent())
{
    appointments.Add(reader.Current);
}
//working with appointments...

Ghi Nhiều Sự kiện vào Tệp ICS

IcsSaveOptions saveOptions = new IcsSaveOptions();
saveOptions.Action = AppointmentAction.Create;
using (CalendarWriter writer = new CalendarWriter(dataDir + "WriteMultipleEventsToICS_out.ics", saveOptions))
{
    for (int i = 0; i < 10; i++)
    {
        Appointment app = new Appointment(string.Empty, DateTime.Now, DateTime.Now, "sender@domain.com", "receiver@domain.com");
        app.Description = "Test body " + i;
        app.Summary = "Test summary:" + i;
        writer.Write(app);
    }
}

Xác định phiên bản cuộc hẹn

Để xác định phiên bản của một cuộc hẹn, bạn có thể sử dụng Appointment.Version thuộc tính của Appointment lớp. Thuộc tính này giúp xác định phiên bản dựa trên các tệp của chúng, đảm bảo tích hợp với các hệ thống và ứng dụng khác.

Mẫu mã sau đây cho thấy cách triển khai thuộc tính này trong dự án của bạn:

var app = Appointment.Load("meeting.ics");

if (app.Version == 1.0)
{
    // do something
}

Net: Làm việc với các mục Outlook

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

Net: Làm việc với các tệp lưu trữ Outlook

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

Net: Làm việc với SMTP Client

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

Net: Làm việc với POP3 Client

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

Net: Làm việc với IMAP Client

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

Net: Làm việc với Exchange EWS Client

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

Net: Làm việc với Microsoft Graph Client

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

Net: Làm việc với Exchange WebDav Client

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

Net: Lập trình với Gmail

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

Net: Cách đọc và chuyển đổi tệp MBOX của Thunderbird trong .NET

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

Net: Lập trình với Thunderbird

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

Đọc tệp MBOX

Mozilla Thunderbird là một khách hàng email mã nguồn mở, đa nền tảng, được phát triển bởi Mozilla Foundation. Nó lưu trữ email trong cấu trúc tệp riêng, quản lý chỉ mục tin nhắn và thư mục con qua các định dạng tệp độc quyền. Aspose.Email có thể làm việc với cấu trúc lưu trữ thư của Thunderbird. The MboxrdStorageReader lớp cho phép các nhà phát triển đọc tin nhắn từ tệp lưu trữ thư của Mozilla Thunderbird. Bài viết này chỉ ra cách đọc tin nhắn từ lưu trữ email của Thunderbird:

Mở tệp lưu trữ Thunderbird trong FileStream.
Tạo một đối tượng của MboxrdStorageReader lớp và truyền luồng trên vào hàm khởi tạo.
Gọi ReadNextMessage() để lấy tin nhắn đầu tiên.
Sử dụng cùng ReadNextMessage() trong vòng lặp while để đọc tất cả các tin nhắn.
Đóng tất cả các luồng.

Đoạn mã dưới đây cho bạn thấy cách đọc tất cả các tin nhắn từ bộ lưu trữ thư của Thunderbird.

// The path to the File directory.
var dataDir = RunExamples.GetDataDir_Thunderbird();

// Open the storage file with FileStream
var stream = new FileStream(dataDir + "ExampleMbox.mbox", FileMode.Open, FileAccess.Read);
// Create an instance of the MboxrdStorageReader class and pass the stream
var reader = new MboxrdStorageReader(stream, false);
// Start reading messages
var message = reader.ReadNextMessage();

// Read all messages in a loop
while (message != null)
{
    // Manipulate message - show contents
    Console.WriteLine("Subject: " + message.Subject);
    // Save this message in EML or MSG format
    message.Save(message.Subject + ".eml", SaveOptions.DefaultEml);
    message.Save(message.Subject + ".msg", SaveOptions.DefaultMsgUnicode);

    // Get the next message
    message = reader.ReadNextMessage();
}

// Close the streams
reader.Dispose();
stream.Close();

Lấy thuộc tính tin nhắn

MboxMessageInfo lớp chứa các thuộc tính sau để truy xuất thông tin về một tin nhắn:

DateTime Ngày - Lấy ngày của tin nhắn
MailAddress Từ - Lấy địa chỉ người gửi
string Tiêu đề - Lấy tiêu đề tin nhắn
MailAddressCollection Đến - Lấy tập hợp địa chỉ chứa người nhận của tin nhắn
MailAddressCollection CC - Lấy tập hợp địa chỉ chứa người nhận CC
MailAddressCollection Bcc - Lấy tập hợp địa chỉ chứa người nhận BCC của tin nhắn

MboxStorageReader reader = MboxStorageReader.CreateReader(fileName, new MboxLoadOptions());

foreach (var mboxMessageInfo in reader.EnumerateMessageInfo())
{
    Console.Writeline($"Subject: {mboxMessageInfo.Subject}");
    Console.Writeline($"Date: {mboxMessageInfo.Date}");
    Console.Writeline($"From: {mboxMessageInfo.From}");
    Console.Writeline($"To: {mboxMessageInfo.To}");
    Console.Writeline($"CC: {mboxMessageInfo.CC}");
    Console.Writeline($"Bcc: {mboxMessageInfo.Bcc}");
}

Trích xuất tin nhắn từ MBOX theo định danh

Cái MboxStorageReader lớp bao gồm EnumerateMessageInfo() phương thức, cho phép bạn duyệt qua từng tin nhắn trong tệp MBOX. Khi sử dụng phương thức này, bạn có thể trích xuất các tin nhắn riêng lẻ mà không cần phải quét toàn bộ lưu trữ nhiều lần. Điều này cải thiện hiệu suất và giảm thời gian xử lý.

Cái MboxMessageInfo class cung cấp EntryId thuộc tính, cung cấp quyền truy cập vào các định danh duy nhất cho mỗi tin nhắn trong tệp MBOX. Định danh này có thể được lưu trong cơ sở dữ liệu hoặc sử dụng làm tham chiếu để nhanh chóng tìm và trích xuất các tin nhắn cụ thể khi cần.

Cái ExtractMessage(string id) phương thức trong MboxStorageReader lớp cho phép các nhà phát triển trích xuất tin nhắn dựa trên EntryId duy nhất của chúng. Với ExtractMessage(string id) phương thức, bạn có thể sử dụng EntryId đã lưu để lấy tin nhắn tương ứng và thực hiện các thao tác bổ sung với nó.

Mẫu mã sau đây minh họa cách trích xuất tin nhắn từ tệp MBOX bằng cách sử dụng các định danh:

MboxStorageReader reader = MboxStorageReader.CreateReader("my.mbox", new MboxLoadOptions());

foreach (MboxMessageInfo msgInfo in reader.EnumerateMessageInfo())
{
    MailMessage eml = reader.ExtractMessage(msgInfo.EntryId, new EmlLoadOptions());
}

Cấu hình các tùy chọn tải khi đọc tin nhắn từ MBOX

Các tính năng sau sẽ cho phép bạn chỉ định các tùy chọn khác nhau liên quan tới việc tải và xử lý tin nhắn:

Thuộc tính MailStorageConverter.MboxMessageOptions - Lấy hoặc đặt các tùy chọn tải email khi phân tích lưu trữ Mbox.
Phương thức MboxrdStorageReader.ReadNextMessage(EmlLoadOptions options) - Tham số EmlLoadOptions chỉ định các tùy chọn khi đọc tin nhắn từ lưu trữ Mbox.

var reader = new MboxrdStorageReader(fileName, new MboxLoadOptions());
// Read messages preserving tnef attachments.
var eml = reader.ReadNextMessage(new EmlLoadOptions {PreserveTnefAttachments = true});
MailStorageConverter.MboxMessageOptions(new EmlLoadOptions {PreserveTnefAttachments = true});
// Convert messages from mbox to pst preserving tnef attachments.
var pst = MailStorageConverter.mboxToPst("Input.mbox", "Output.pst");

Đặt Bộ mã Văn bản Ưu tiên khi Tải tệp Mbox để Đọc

Tùy chọn mã hoá có sẵn cho lớp MboxrdStorageReader. Điều này cung cấp các tùy chọn bổ sung cho việc tải tệp mbox và đảm bảo các tin nhắn có nội dung đã mã hoá sẽ được đọc và xử lý đúng cách.. Đoạn mã sau đây cho thấy cách bạn có thể đặt mã hoá văn bản phù hợp với nhu cầu của mình:

var reader = new MboxrdStorageReader("sample.mbox", new MboxLoadOptions() { PreferredTextEncoding = Encoding.UTF8});
var message = reader.ReadNextMessage();

Lấy tổng số tin nhắn từ tệp MBOX

Cái MboxrdStorageReader lớp cung cấp khả năng đọc số lượng mục có trong tệp MBox. Điều này có thể được sử dụng để phát triển các ứng dụng hiển thị tiến độ hoạt động khi xử lý tệp như vậy.

// The path to the File directory.
var dataDir = RunExamples.GetDataDir_Thunderbird();

using (var stream = new FileStream(dataDir + "ExampleMbox.mbox", FileMode.Open, FileAccess.Read))
using (var reader = new MboxrdStorageReader(stream, false))
{
    Console.WriteLine("Total number of messages in Mbox file: " + reader.GetTotalItemsCount());
}

Lấy kích thước tin nhắn hiện tại

using (var stream = new FileStream(dataDir + "ExampleMbox.mbox", FileMode.Open, FileAccess.Read))
using (var reader = new MboxrdStorageReader(stream, false))
{
    MailMessage msg;
    while ((msg = reader.ReadNextMessage()) != null)
    {
        long currentDataSize = reader.CurrentDataSize;

        msg.Dispose();
    }
}

Chuyển đổi MBOX sang PST Giữ lại hoặc Loại bỏ Chữ ký

Để xóa chữ ký khỏi tệp trong quá trình chuyển đổi, đặt MboxToPstConversionOptions.RemoveSignature thuộc tính thành true.

Mẫu mã sau đây cho thấy cách sử dụng thuộc tính này:

var pstDataStream = new MemoryStream();
var personalStorage = PersonalStorage.Create(pstDataStream, FileFormatVersion.Unicode);
MailStorageConverter.MboxToPst(new MboxrdStorageReader(new FileStream(fileName, FileMode.Open, FileAccess.Read), new MboxLoadOptions()),
personalStorage,
    "Inbox",
new MboxToPstConversionOptions() { RemoveSignature = true });

Ghi các tệp MBOX

Cái MboxrdStorageWriter lớp cung cấp khả năng ghi các tin nhắn mới vào tệp lưu trữ thư của Thunderbird. Để ghi tin nhắn:

Mở tệp lưu trữ Thunderbird trong FileStream.
Tạo một đối tượng của MboxrdStorageWriter lớp và truyền luồng trên vào hàm khởi tạo.
Chuẩn bị một tin nhắn mới bằng cách sử dụng MailMessage lớp.
Gọi WriteMessage() phương thức và truyền những giá trị ở trên MailMessage đối tượng để thêm tin nhắn vào bộ lưu trữ Thunderbird.
Đóng tất cả các luồng.

Đoạn mã sau đây cho bạn thấy cách ghi tin nhắn vào bộ lưu trữ thư của Thunderbird.

// Open the storage file with FileStream
var stream = new FileStream(dataDir + "ExampleMbox.mbox", FileMode.Open, FileAccess.Write);

// Initialize MboxStorageWriter and pass the above stream to it
var writer = new MboxrdStorageWriter(stream, false);
// Prepare a new message using the MailMessage class
var message = new MailMessage("from@domain.com", "to@domain.com", Guid.NewGuid().ToString(), "added from Aspose.Email");
message.IsDraft = false;
// Add this message to storage
writer.WriteMessage(message);
// Close all related streams
writer.Dispose();
stream.Close();

Chia lưu trữ MBOX/Hủy thao tác chia

Aspose.Email cung cấp các phương thức để chia lưu trữ Mbox thành các phần nhỏ hơn, giúp dễ dàng quản lý các kho lưu trữ email lớn. Tùy vào phiên bản .NET bạn đang sử dụng, các phương thức khả dụng và tham số của chúng có thể khác nhau. Dưới đây là các phương thức của MboxStorageReader lớp được sử dụng cho cả .NET Framework 4.5 và các phiên bản .NET Core cũng như các phiên bản dưới 4.5.

Các thành viên cho .NET Framework 4.5 và các phiên bản .NET Core:

SplitInto(long chunkSize, string outputPath, CancellationToken token) - Chia lưu trữ Mbox thành các phần nhỏ hơn dựa trên kích thước khối đã chỉ định.
Tham số:
- chunkSize: Kích thước xấp xỉ của mỗi phần tính bằng byte.
- outputPath: Đường dẫn thư mục nơi các phần sẽ được tạo.
- token: Một CancellationToken cho phép hủy bỏ thao tác nếu cần.
SplitInto(long chunkSize, string outputPath, string partFileNamePrefix, CancellationToken token) - Chia lưu trữ Mbox thành các phần nhỏ hơn với tiền tố tên tệp nhất định cho mỗi phần.
Tham số:
- chunkSize: Kích thước xấp xỉ của mỗi phần tính bằng byte.
- outputPath: Đường dẫn thư mục nơi các phần sẽ được tạo.
- partFileNamePrefix: Tiền tố sẽ được thêm vào tên tệp của mỗi phần.
- token: Một CancellationToken cho phép hủy bỏ thao tác nếu cần.

Các thành viên cho .NET Framework phiên bản dưới 4.5:

SplitInto(long chunkSize, string outputPath) - Chia lưu trữ Mbox thành các phần nhỏ hơn dựa trên kích thước khối đã chỉ định.
SplitInto(long chunkSize, string outputPath, string partFileNamePrefix) - Chia lưu trữ Mbox thành các phần nhỏ hơn với tiền tố tên tệp nhất định cho mỗi phần.
Cancel() - Ngắt một thao tác chia đang diễn ra.

Các đoạn mã sau đây minh họa cách chia một tệp MBOX thành các phần trong khi giới hạn quá trình tối đa năm phần, sử dụng cơ chế hủy:

.NET Framework 4.5 và .NET Core:

int partCount = 0;

var tokenSource = new CancellationTokenSource();

var mbox = new MboxrdStorageReader(fileName, new MboxLoadOptions { LeaveOpen = false });

// Subscribe to events
mbox.MboxFileCreated += (sender, e) =>
{
    partCount++;
    if (partCount >= 5)
        tokenSource.Cancel();
};

System.Threading.Tasks.Task task = mbox.SplitInto(10000000, outputPath, tokenSource.Token);
task.Wait();

.NET Framework Dưới 4.5:

int partCount = 0;
var mbox = new MboxrdStorageReader(fileName, new MboxLoadOptions { LeaveOpen = false });
mbox.SplitInto(10000000, outputPath);

mbox.MboxFileCreated += (sender, e) =>
{
    partCount++;
    if (partCount >= 5)
        mbox.Cancel();
};

Net: Chuyển đổi tệp Email bằng API C#

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

Chuyển đổi Tệp Email giữa các Định dạng trong C# bằng lập trình

Một trong những tính năng chính của Aspose.Email cho .NET là khả năng chuyển đổi các tệp email giữa các định dạng khác nhau. Sự linh hoạt này giúp truy cập nội dung email bất kể thiết bị hoặc client email nào được sử dụng.

Định dạng được Hỗ trợ

Tất cả các định dạng có sẵn để chuyển đổi với Aspose.Email cho .NET được liệt kê trên Định dạng tệp được hỗ trợ trang. Bạn có thể tìm thấy mô tả về khả năng và ưu điểm của chúng, các mẫu mã và thực hành tốt nhất trên các trang sau:

Chuyển đổi EML/EMLX sang Các Định dạng Khác - Loại chuyển đổi này bao gồm việc chuyển đổi các tệp EML/EMLX sang EMLX, HTML, ICS, MBOX, MHTML, MSG, OFT, OST, PST và VCF.
Chuyển đổi HTML sang Các Định dạng Khác
Chuyển đổi ICS sang Các Định dạng Khác
Chuyển đổi MBOX sang Các Định dạng Khác
Chuyển đổi MHTML sang Các Định dạng Khác
Chuyển đổi MSG sang các định dạng khác
Chuyển đổi OFT sang Các Định dạng Khác
Chuyển đổi OST sang Các Định dạng Khác
Chuyển đổi PST sang Các Định dạng Khác
Chuyển đổi VCF sang Các Định dạng Khác

Tùy chỉnh

Aspose.Email cho phép bạn tùy chỉnh các tệp đầu ra. Điều này có nghĩa là thư viện cung cấp các tùy chọn để lưu các tệp đầu ra ở định dạng mong muốn cũng như chỉ định cấu trúc thư mục mục tiêu, thiết lập tùy chọn chuyển đổi cho tệp đính kèm và các đối tượng nhúng, kiểm soát mã hoá đầu ra, và hơn thế nữa.

Các tùy chọn lưu của Aspose.Email đảm bảo khả năng tương thích và tương tác với nhiều client, server và nền tảng email.

Xử lý hàng loạt

Aspose.Email cho phép nhập một tập hợp tin nhắn từ thư mục vào tệp với định dạng mục tiêu. Ví dụ, có thể nhập nhiều tin nhắn EML vào thư mục Inbox trong tệp PST.

Tính toàn vẹn dữ liệu

Aspose.Email cho .NET đảm bảo giữ nguyên định dạng gốc, tệp đính kèm và các yếu tố đa phương tiện của email trong quá trình chuyển đổi. Bạn có thể tìm hiểu chi tiết về cách xử lý các mục trong quá trình chuyển đổi trên các trang với loại chuyển đổi tương ứng. Ví dụ, trên trang [Convert EML to other formats] bạn có thể tìm hiểu cách bảo tồn tài nguyên khi chuyển đổi EML sang HTML mà không mất dữ liệu. Để mục đích này, Aspose.Email cung cấp một tập hợp các lớp và phương thức để thao tác tài nguyên trong tệp HTML và một đoạn mã mẫu để thử nghiệm.

Phiên bản Dùng thử Miễn phí

Trên Aspose.Email cho .NET trên trang chính thức có phiên bản dùng thử miễn phí của thư viện xử lý email. Với bản dùng thử, các nhà phát triển có thể khám phá nhiều tính năng và chức năng, bao gồm phân tích email, thao tác, chuyển đổi và hơn nữa.

Net: Đọc và Xuất tệp Zimbra TGZ trong Node.js qua .NET

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

Zimbra là một bộ ứng dụng email và hợp tác dựa trên đám mây cung cấp email, danh bạ, lịch, chia sẻ tệp, nhiệm vụ và tin nhắn - tất cả có thể truy cập qua Zimbra Web Client trên bất kỳ thiết bị nào.

Aspose.Email cho Node.js qua .NET cho phép các nhà phát triển đọc, trích xuất và xuất dữ liệu từ tệp sao lưu Zimbra TGZ bằng cách sử dụng TgzReader lớp. Bạn có thể dễ dàng truy cập tất cả các tin nhắn, đếm tổng số mục, và xuất tin nhắn, danh bạ hoặc dữ liệu lịch từ tệp TGZ sang các định dạng phổ biến.

Đọc Tất cả Tin nhắn từ Tệp Zimbra TGZ

Cái TgzReader lớp cho phép bạn đọc tất cả các tin nhắn lưu trong tệp sao lưu Zimbra TGZ.

Ví dụ sau đây minh họa cách duyệt qua tất cả các tin nhắn và hiển thị vị trí thư mục và chủ đề của chúng.

const asposeemail = require('@aspose/email');
const fs = require('fs');

// Path to the Zimbra TGZ file
const tgzPath = "ZimbraSample.tgz";

// Create a TgzReader instance
const reader = new asposeemail.TgzReader(tgzPath);

// Read and display all messages
while (reader.readNextMessage()) {
    const directoryName = reader.currentDirectory;
    console.log("Directory:", directoryName);

    const message = reader.currentMessage;
    console.log("Subject:", message.subject);
}

reader.dispose();
console.log("All messages read successfully from the Zimbra TGZ file.");

Đếm Tổng số Mục trong Tệp Zimbra TGZ

Bạn có thể nhanh chóng xác định có bao nhiêu mục email tồn tại trong sao lưu TGZ bằng cách sử dụng getTotalItemsCount() phương thức của TgzReader lớp.

Đoạn mã mẫu dưới đây sẽ cho bạn thấy cách thực hiện phương thức này trong dự án của bạn:

const asposeemail = require('@aspose/email');

const tgzFile = "ZimbraSample.tgz";
const reader = new asposeemail.TgzReader(tgzFile);

const totalCount = reader.getTotalItemsCount();
console.log(`Total items in TGZ file: ${totalCount}`);

reader.dispose();

Lưu Tin nhắn và Cấu trúc Thư mục từ Tệp Zimbra TGZ

Cái exportTo() phương thức cho phép bạn lưu tất cả các tin nhắn từ tệp TGZ đồng thời duy trì cấu trúc thư mục gốc. Điều này hữu ích khi khôi phục hoặc di chuyển dữ liệu hộp thư.

Đoạn mã mẫu dưới đây minh họa cách trích xuất và xuất tất cả các tin nhắn email Zimbra từ tệp lưu trữ TGZ bằng thư viện Aspose.Email.

const asposeemail = require('@aspose/email');

const tgzFile = "ZimbraSample.tgz";
const outputDir = "Output/Zimbra/";

const reader = new asposeemail.TgzReader(tgzFile);
reader.exportTo(outputDir);

reader.dispose();
console.log(`All Zimbra messages exported to: ${outputDir}`);

Xuất Lịch và Danh bạ từ Tệp sao lưu Zimbra

Sao lưu Zimbra TGZ có thể bao gồm các thư mục danh bạ và lịch. Bạn có thể xuất chúng sang định dạng VCard (.vcf) và iCalendar (.ics) bằng cùng exportTo() phương thức.

const asposeemail = require('@aspose/email');

const tgzFile = "ZimbraBackup.tgz";
const outputPath = "Output/ZimbraData/";

const reader = new asposeemail.TgzReader(tgzFile);

// Contacts can be found in "Contacts" and "Emailed Contacts" folders.
// Calendar entries can be found in the "Calendar" folder.
reader.exportTo(outputPath);

reader.dispose();
console.log("Zimbra calendar and contacts exported successfully.");

Net: Làm việc với IBM Notes

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

Thông tin về IBM Notes

IBM Notes là một client và IBM Domino là một server của nền tảng phần mềm hợp tác client-server. IBM Notes cung cấp các tính năng hợp tác như email, lịch, danh sách công việc, quản lý danh bạ, v.v. Tệp cơ sở dữ liệu được IBM Notes sử dụng được lưu ở định dạng Notes Storage Facility (NSF).

Phát hiện tệp ở định dạng NSF

Đoạn mã mẫu dưới đây sẽ cho bạn thấy cách nhận dạng định dạng tệp NSF:

var formatType = FileFormatUtil.DetectFileFormat("storage.nsf").FileFormatType; // Returns FileFormatType.Nsf

Đọc tin nhắn từ tệp lưu trữ NSF

Lưu ý, việc triển khai NSF khá hạn chế. Nói chung, có thể gặp một số vấn đề trong các trường hợp sau:

Tệp này được tạo bởi Notes phiên bản 7 trở lên
Được sử dụng nén LZ1

Aspose.Email cung cấp NotesStorageFacility class để đọc các tệp lưu trữ NSF. The NotesStorageFacility class cung cấp EnumerateMessages phương thức duyệt qua các tin nhắn trong tệp lưu trữ NSF. Đoạn mã mẫu sau đây trình bày việc sử dụng NotesStorageFacility class và EnumerateMessages phương thức để đọc tin nhắn từ tệp lưu trữ NSF.

Xin lưu ý rằng chỉ việc đọc tin nhắn đã được triển khai. Việc đọc thư mục chưa được hỗ trợ do thiếu thông số kỹ thuật.

Net: Lập trình xác thực email

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

Sử dụng Aspose.Email.Verifications

Aspose.Email.Verifications cung cấp hỗ trợ đầy đủ cho việc xác thực địa chỉ email. Nhờ lớp Aspose.Email.Verifications.EmailValidator, có thể thực hiện các loại xác thực khác nhau, bao gồm kiểm tra cú pháp email, kiểm tra miền email và kiểm tra tài khoản người dùng với máy chủ thư. Kiểu liệt kê ValidationPolicy được sử dụng để đặt mức độ chính sách xác thực:

SyntaxOnly chỉ xác thực cú pháp địa chỉ email.
SyntaxAndDomain xác thực cú pháp địa chỉ email, sau đó là miền.
MailServer xác thực địa chỉ bằng cách cố gắng kết nối tới máy chủ thư.

Ứng dụng mẫu

Aspose.Email.Verifications là một thành phần mạnh mẽ và hữu ích để kiểm tra tính hợp lệ của địa chỉ email, tên miền email và nhiều hơn nữa. Bài viết này trình bày cách tạo một ứng dụng sử dụng Aspose.Email.Verifications. Ứng dụng demo kiểm tra tính hợp lệ của một địa chỉ email.

Để tạo một ứng dụng sử dụng Aspose.Email.Verifications để xác minh địa chỉ email:

Mở Visual Studio.
Trong menu File, nhấp New rồi Project. Để đơn giản, đây sẽ là một chương trình console. Chọn dự án C# hoặc VB.NET tùy ý.

|Tạo dự án mới| | :- | ||

Thêm một tham chiếu vào ứng dụng console.

|Thêm tham chiếu tới Aspose.Email| | :- | ||

Duyệt tới tệp Aspose.Email.dll trong thư mục Bin dưới thư mục cài đặt của Aspose.Email.

Đoạn mã sau cho thấy cách xác thực một địa chỉ email. Khi mã được thực thi, một thông báo sẽ thông báo địa chỉ email có hợp lệ hay không.

Xây dựng và chạy.

|Chạy ứng dụng.|| | :- | :- | || |

Chức năng xác thực cơ bản

Sử dụng Aspose.Email.Verifications để xác minh tính hợp lệ của địa chỉ email. Để thực hiện mục đích này, Aspose.Email.Verifications có lớp EmailValidator.

Xác thực Email

Chức năng xác thực của Aspose.Email có thể được sử dụng để xác thực địa chỉ email, tên miền và máy chủ thư. Đoạn mã sau cho bạn thấy cách sử dụng EmailValidator để xác thực một địa chỉ email.

Xác thực miền

Aspose.Email.Verifications có thể xác thực tính hợp lệ của một tên miền.

Xác thực máy chủ thư

Aspose.Email.Verifications có thể xác thực tính hợp lệ của một máy chủ thư.

Net: Làm việc với email AMP HTML

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

Về AMP

AMP (Accelerated Mobile Pages) là một framework nguồn mở của Google được tạo ra từ HTML, CSS và JavaScript. Nó cho phép xây dựng các email nhẹ với thời gian tải nhanh hơn. AMP cung cấp nhiều thành phần như carousel, form, hình ảnh, v.v. Ngoài việc nhanh, Email AMP còn hiển thị các email tương tác đầy đủ bên trong khách hàng email và người dùng có thể tương tác trực tiếp như điền mẫu hoặc trả lời khảo sát mà không cần rời khỏi khách hàng email.

Làm việc với email AMP HTML

Aspose.Email cung cấp AmpMessage đại diện cho một Email AMP. Aspose.Email cung cấp nhiều lớp để thêm các thành phần vào Email AMP như AmpImage, AmpCarousel, AmpAccordion, AmpForm, v.v. Danh sách đầy đủ các lớp bạn có thể tìm thấy tại Aspose.Email.Amp trang. Đoạn mã sau đây minh họa việc tạo, lưu và cập nhật Email AMP bằng API Aspose.Email.

Net: Bài viết kỹ thuật

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

Net: Câu hỏi thường gặp

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

Question

Chào! cho đoạn mã sau:


 Aspose.Email.Mime.ContentType ct = new Aspose.Email.Mime.ContentType();

ct.MediaType = "application/msword";

ct.CharSet = "ISO-2022-JP";

Attachment att = new Attachment("Test.doc", ct);

Console.WriteLine(att.ContentType.Name);

att.ContentType.Name trả về tên của tài liệu đính kèm. Đây có phải là hành vi mong đợi không?

Trả lời: Có, đây là hành vi mong đợi. Nếu ContentType.Name không được đặt rõ ràng, giá trị của tên tệp sẽ được lấy làm tên.

Câu hỏi:

Tại sao ExchangeWebServiceClient.FetchMessage lại biến các hình ảnh nhúng thành tệp đính kèm?

Trả lời: Microsoft Exchange Server có chức năng như ‘Chuyển đổi nội dung, là quá trình định dạng đúng một tin nhắn cho mỗi người nhận. Quyết định thực hiện chuyển đổi nội dung trên một tin nhắn phụ thuộc vào đích đến và định dạng của tin nhắn đang được xử lý.

Nói cách khác, với các client không xác định, server có thể thực hiện việc định dạng tin nhắn theo cài đặt của server (để chọn định dạng tin nhắn phù hợp nhất). Như bạn hiểu, định dạng phổ biến nhất cho bất kỳ client nào là ’text/plain’ và các cài đặt này có thể cấu hình trên server.

Lưu ý: Outlook là client email nổi tiếng cho Microsoft Exchange Server (trong trường hợp Outlook có phiên bản cũ hơn server). Điều này có nghĩa là Exchange Server truyền định dạng tin nhắn dựa trên khả năng của Outlook. Trong trường hợp của chúng ta khi ExchangeWebServiceClient cố gắng lấy tin nhắn, khả năng của các thành phần chúng tôi không được biết bởi MS Exchange. Server truyền tin nhắn cho các thành phần ở định dạng đơn giản nhất (text/plain). Nói cách khác không có phần html trong phản hồi của server. Trong tình huống này, hình ảnh được đưa vào tin nhắn như tệp đính kèm.

Có một cách để tránh vấn đề đã mô tả. Nếu tin nhắn trên máy chủ có Content-Type: multipart/alternative và một trong các phần của nó là text/plain, trong trường hợp này tin nhắn sẽ được chuyển cho client nguyên trạng. Các hình ảnh trong trường hợp này được hiển thị trong phần thân tin nhắn vì tin nhắn cũng chứa phần html. Trong kịch bản hiện tại, tin nhắn được thêm vào MS Exchange bằng cách sử dụng MS Outlook và do đó Content-Type của tin nhắn không phải là ‘multipart/alternative’. Kết quả chúng ta gặp vấn đề khi cố gắng lấy tin nhắn. Ví dụ dưới đây là các mẫu của các vấn đề tương tự: một(http://support.risualblogs.com/blog/2011/02/24/html-mails-sent-via-owa-and-outlook-2011-are-received-as-plain-text-mails-externally/), hai(http://forums.mozillazine.org/viewtopic.php?f=39&t=628678), ba(http://stackoverflow.com/questions/4681798/how-do-i-send-html-multipart-alternative-from-exchange-web-services-2010-sp1)As Kết luận, tình huống được mô tả trong vấn đề (hình ảnh được bao gồm trong tin nhắn dưới dạng tệp đính kèm) không phải là lỗi của các thành phần Aspose. Đây là tính năng đặc thù của máy chủ Exchange.

Question: Làm thế nào tôi có thể trích xuất dữ liệu từ tệp đính kèm "oleData.mso" mà tôi nhận được khi đọc một MapiMessage có đối tượng OLE nhúng trong đó?

Answer: Các tệp như "oleData.mso" là định dạng tệp Microsoft Compound Document (MCDF) và, thật tiếc, việc hỗ trợ các tệp này nằm ngoài phạm vi của Aspose.Email. Tuy nhiên, có một số thư viện .NET mã nguồn mở, ví dụ OpenMCDF, có thể được sử dụng để đọc nội dung của các tệp này và lưu vào đĩa.

Question: Chúng ta có thể ghi vào cùng một tệp PST trong các luồng song song bằng cùng các đối tượng không?

Answer: Không, độ an toàn luồng không được đảm bảo trong trường hợp này. Việc ghi tin nhắn nên được thực hiện trong một luồng duy nhất. Tuy nhiên, sản phẩm phải hoạt động đúng với các đối tượng khác nhau từ các luồng khác nhau.