Documentation – کار با کلاینت SMTP

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

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

بهینه‌سازی اتصالات کلاینت ایمیل

کاربران اغلب به دلیل تنظیمات زمان‌سرب پیش‌فرض با تاخیر مواجه می‌شوند که می‌تواند به زمان‌های اتصال طولانی یا حتی تلاش‌های ناموفق منجر شود.

برای بهبود کارایی این اتصالات، Aspose.Email برای .NET ویژگی‌هایی مانند را ارائه می‌دهد زمان انتظار و GreetingTimeout. در حالی که Timeout ویژگی مدت زمان کلی عملیات ایمیل را مدیریت می‌کند، GreetingTimeout ویژگی به طور خاص زمان ارسال رشتهٔ خوش‌آمدگویی توسط سرور پس از اتصال را هدف می‌گیرد.

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

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

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

هنگام اتصال به سرورهای SMTP، IMAP و POP3، پس از برقراری موفقیت‌آمیز اتصال، یک رشتهٔ خوش‌آمدگویی به کلاینت ارسال می‌شود. سرورها ممکن است از شروع اتصال SSL/TLS به صورت ضمنی یا صریح (START TLS) استفاده کنند. در مواردی که حالت اتصال مطابقت نداشته باشد (به‌عنوان مثال، سرور انتظار اتصال SSL ضمنی دارد در حالی که کلاینت سعی می‌کند اتصال غیرامن یا SSL صریح برقرار کند)، سرور رشتهٔ خوش‌آمدگویی را ارسال نخواهد کرد.

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

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

نمونه کد زیر نشان می‌دهد چگونه تنظیم شود EmailClient.GreetingTimeout ویژگی:

using (SmtpClient client = new SmtpClient("localhost", 25, "username", "password"))
{
    client.GreetingTimeout = 4000;
}

دریافت افزونه‌های سرور

این SmtpClient به شما اجازه می‌دهد افزونه‌های سروری که پشتیبانی می‌کند مانند IDLE، UNSELECT، QUOTA و غیره را دریافت کنید. این به شناسایی در دسترس بودن یک افزونه قبل از استفاده از کلاینت برای آن عملکرد خاص کمک می‌کند. GetCapabilities() متد انواع افزونه‌های پشتیبانی‌شده را به‌صورت آرایه‌ای از رشته‌ها برمی‌گرداند.

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

اعتبارسنجی مدارک سرور ایمیل بدون ارسال ایمیل

API Aspose.Email امکان اعتبارسنجی مدارک سرور ایمیل را بدون ارسال ایمیل فراهم می‌کند. این کار می‌تواند با استفاده از ValidateCredentials متدی که مسئول تأیید اصالت و صحت مدارک ایمیل ارائه‌شده است، که معمولاً برای احراز هویت هنگام اتصال به سرور استفاده می‌شوند.

این متد اعتبار مدارک ایمیل ارائه‌شده، مانند نام کاربری و رمز عبور، را بررسی می‌کند و اطمینان می‌دهد که کلاینت می‌تواند اتصال موفق به سرور برقرار کند. این اعتبارسنجی به مشتری کمک می‌کند تا به حساب ایمیل خود به‌صورت امن دسترسی داشته و عملیات مختلفی مانند ارسال ایمیل را انجام دهد.

using (SmtpClient client = new SmtpClient(server.SmtpUrl, server.SmtpPort, "username", "password", SecurityOptions.Auto))
{
    client.Timeout = 4000;
   
    if (client.ValidateCredentials())
    {
        //to do something
    }
}

نسخه دیگری از این متد نیز وجود دارد ValidateCredentialsAsync برای انجام یک عملیات ناهمزمان.

ارسال ایمیل از طریق سرور پراکسی SOCKS

در این موارد، کلاینت‌های ایمیل بدون مشخص کردن آدرس پراکسی نمی‌توانند از طریق اینترنت ارتباط برقرار کنند. Aspose.Email پشتیبانی از نسخه‌های 4، 4a و 5 پروتکل پراکسی SOCKS را فراهم می‌کند. برای ارسال ایمیل از طریق یک سرور پراکسی، مراحل زیر را انجام دهید:

پروکسی را با اطلاعات مورد نیاز، یعنی آدرس پروکسی، پورت و نسخه SOCKS راه‌اندازی کنید.
راه‌اندازی SmtpClient با آدرس میزبان، نام کاربری و رمز عبور و هر تنظیم دیگر.
ویژگی Proxy کلاینت را به پروکسی شیء‌ای که قبلاً ایجاد شده است.

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

ارسال ایمیل از طریق سرور پراکسی HTTP

شناسایی روش‌های احراز هویت برای اتصال امن به SMTP

Aspose.Email ویژگی‌هایی ارائه می‌دهد که امکان بررسی روش‌های احراز هویت قابل استفاده برای برقراری اتصال امن با سرور SMTP پیش از ارسال ایمیل را فراهم می‌کند:

the SmtpClient.SupportedAuthentication ویژگی لیستی از روش‌های احراز هویت پشتیبانی‌شده توسط سرور SMTP را برمی‌گرداند.
the SmtpClient.AllowedAuthentication ویژگی لیستی از روش‌های احراز هویت تعریف‌شده توسط کاربر را برمی‌گرداند.

smtpClient.AllowedAuthentication = SmtpKnownAuthenticationType.Login;

بارگذاری اطلاعات احراز هویت SMTP از فایل CONFIG

برای اینکه Aspose.Email بتواند یک فایل پیکربندی را بخواند، باید در قالب صحیح باشد. در زیر، یک نمونهٔ فایل پیکربندی XML را به همراه کدی که آن را می‌خواند نشان می‌دهیم. بخش کد زیر نشان می‌دهد چگونه اطلاعات احراز هویت SMTP را از فایل CONFIG بارگذاری کنید.

پس از تعریف تنظیمات پیکربندی، این تنظیمات را مستقیماً به یک نمونهٔ SmtpClient کلاس با استفاده از یکی از سازنده‌های بارگذاری‌شدهٔ خود. بخش کد زیر نشان می‌دهد چگونه تنظیمات پیکربندی را از فایل پیکربندی بخوانید و مستقیماً به نمونهٔ SmtpClient.

متصل کردن کلاینت SMTP به آدرس IP خاص

امکان وجود پورت‌های متعدد در یک میزبان برای ارسال ایمیل نمی‌تواند رد شود. در چنین مواردی ممکن است نیاز به بستن مشتری ارسال ایمیل به یک پورت خاص در میزبان برای ارسال ایمیل‌ها پیش آید. این کار می‌تواند با استفاده از Aspose.Email API نیز با استفاده از SmtpClient BindIPEndPoint ویژگی بارگذاری کنید. API SmtpClient می‌تواند با تعیین IP Endpoint خاص، برای استفاده از یک آدرس IP مشخص در میزبان تنظیم شود. قطعه کد زیر نشان می‌دهد چگونه مشتری SMTP را به آدرس IP خاص در میزبان بایند کنید.

تنظیم زمان‌سرب برای عملیات‌های ایمیل

هر عملیات ایمیل بسته به عوامل متعددی (تاخیرهای شبکه، حجم داده، عملکرد سرور و غیره) مدتی طول می‌کشد. می‌توانید زمان انتظار (Timeout) را برای تمام عملیات ایمیل تنظیم کنید. مثال کد زیر نشان می‌دهد چگونه با استفاده از زمان انتظار ویژگی.

نکته: نباید مقادیر بزرگ تنظیم کنید تا از انتظارهای طولانی در برنامهٔ خود جلوگیری شود.

using (SmtpClient smtpClient = new SmtpClient("host", 587, "username", "password", SecurityOptions.SSLExplicit))
{
    smtpClient.Timeout = 60000; // 60 seconds

    // some code...
}

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

Aspose.Email پروتکل‌های رمزنگاری SSL (منقضی) و TLS را برای فراهم کردن امنیت ارتباطات پشتیبانی می‌کند. می‌توانید رمزنگاری را فعال کنید تا تبادل داده‌ها بین برنامهٔ شما و سرورهای ایمیل محافظت شود.

توجه: باید فقط نسخه‌های پروتکل را تنظیم کنید که توسط .NET Framework پشتیبانی می‌شوند. اگر برخی نسخه‌های پروتکل رمزنگاری توسط نسخهٔ فعلی .NET Framework شما پشتیبانی نشود، نادیده گرفته شده و رد می‌شوند. در این صورت استثناها تولید نمی‌شوند. لطفاً از SetSupportedEncryptionUnsafe متد اگر می‌خواهید پروتکل‌ها را بدون هیچ بررسی سازگاری تنظیم کنید.

مثال کد زیر نشان می‌دهد چگونه TLS 1.3 را برای SmtpClient نمونهٔ کلاس.

using (SmtpClient smtpClient = new SmtpClient("host", 587, "username", "password", SecurityOptions.SSLExplicit))
{
    smtpClient.SupportedEncryption = EncryptionProtocols.Tls13;

    // some code...
}

در صورتی که پروتکل رمزنگاری مشخص‌شده در نسخهٔ فعلی .NET Framework پشتیبانی نشود، تفاوت رفتار بین SetSupportedEncryptionUnsafe متد و SupportedEncryption ویژگی به شرح زیر است:

اگر SupportedEncryption اگر این ویژگی استفاده شود، کلاینت ایمیل پروتکل رمزنگاری را به سطحی پشتیبانی‌شده کاهش می‌دهد.
اگر SetSupportedEncryptionUnsafe اگر از این متد استفاده شود، کلاینت ایمیل استثناها را پرتاب می‌کند.

احراز هویت SMTP با مکانیزم CRAM-MD5

مکانیزم احراز هویت CRAM-MD5 در Aspose.Email برای .NET لایهٔ اضافی امنیتی هنگام دسترسی به سرور فراهم می‌کند. بخش کد زیر نشان می‌دهد چگونه این ویژگی را در پروژه خود پیاده‌سازی کنید:

smtpClient.AllowedAuthentication = SmtpKnownAuthenticationType.CramMD5;

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

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

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

ارسال ایمیل‌ها با کلاس SmtpClient

این SmtpClient کلاس امکان ارسال ایمیل‌ها از طریق پروتکل ساده انتقال ایمیل (SMTP) را برای برنامه‌ها فراهم می‌کند.

یکی از ویژگی‌های کلیدی آن توانایی ارسال پیام‌ها به‌صورت انبوه.

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

علاوه بر این، SmtpClient پشتیبانی می‌کند از ارسال پیام‌ها در فرمت محصورسازی خنثی حمل‌ونقل (TNEF).

ارسال ایمیل‌ها به‌صورت همزمان

یک پیام ایمیل می‌تواند به‌صورت همزمان با استفاده از ارسال متد از SmtpClient کلاس. پیام ایمیل مشخص‌شده را از طریق سرور SMTP برای تحویل ارسال می‌کند. برای ارسال پیام ایمیل به صورت همزمان، مراحل زیر را دنبال کنید:

یک نمونه از MailMessage کلاس و ویژگی‌های آن را تنظیم کنید.
یک نمونه از SmtpClient کلاس و میزبان، پورت، نام کاربری و رمز عبور را مشخص کنید.
ارسال پیام با استفاده از ارسال متد از SmtpClient کلاس و پاس دهید MailMessage نمونه.

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

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Declare msg as MailMessage instance
MailMessage msg = new MailMessage();

// Create an instance of SmtpClient class
SmtpClient client = new SmtpClient();

// Specify your mailing host server, Username, Password, Port # and Security option
client.Host = "mail.server.com";
client.Username = "username";
client.Password = "password";
client.Port = 587;
client.SecurityOptions = SecurityOptions.SSLExplicit;

try
{
    // Client.Send will send this message
    client.Send(msg);
    Console.WriteLine("Message sent");
}
catch (Exception ex)
{
    Trace.WriteLine(ex.ToString());
}

ارسال ایمیل‌ها به صورت ناهمزمان

گاهی ممکن است بخواهید ایمیل را به صورت ناهمزمان ارسال کنید تا برنامه بتواند عملیات دیگر را در حالی که ایمیل در پس‌زمینه ارسال می‌شود، ادامه دهد. از .NET Framework 4.5، می‌توانید از متدهای ناهمزمان پیاده‌سازی‌شده بر اساس TAP مدل. قطعه کد زیر در C# نشان می‌دهد چگونه پیام‌های ایمیل Outlook را با استفاده از روش‌های الگوی ناهمزمان مبتنی بر تس(Task) ارسال کنیم:

SendAsync پیام‌های مشخص‌شده را ارسال می‌کند.
IAsyncSmtpClient - به برنامه‌ها اجازه می‌دهد تا با استفاده از پروتکل SMTP (Simple Mail Transfer Protocol) پیام ارسال کنند.
SmtpClient.CreateAsync - یک نمونه جدید از کلاس Aspose.Email.Clients.Smtp.SmtpClient ایجاد می‌کند.
SmtpSend - مجموعه پارامترهای متد Aspose.Email.Clients.Smtp.IAsyncSmtpClient.SendAsync(Aspose.Email.Clients.Smtp.Models.SmtpSend).
SmtpForward - آرگومان‌های Aspose.Email.Clients.Smtp.IAsyncSmtpClient.ForwardAsync(Aspose.Email.Clients.Smtp.Models.SmtpForward).

// Authenticate the client to obtain necessary permissions
static readonly string tenantId = "YOU_TENANT_ID";
static readonly string clientId = "YOU_CLIENT_ID";
static readonly string redirectUri = "http://localhost";
static readonly string username = "username";
static readonly string[] scopes = { "https://outlook.office.com/SMTP.Send" };

// Use the SmtpAsync method for asynchronous operations
static async Task Main(string[] args)
{
    await SmtpAsync();
    Console.ReadLine();
}

static async Task SmtpAsync()
{
    // Create token provider and get access token
    var tokenProvider = new TokenProvider(clientId, tenantId, redirectUri, scopes);
    var client = SmtpClient.CreateAsync("outlook.office365.com", username, tokenProvider, 587).GetAwaiter().GetResult();

    // Create a message to send
    var eml = new MailMessage("from@domain.com", "to@domain.com", "test subj async", "test body async");
    
    // send message
    var sendOptions = SmtpSend.Create();
    sendOptions.AddMessage(eml);
    await client.SendAsync(sendOptions);
    Console.WriteLine("message was sent");

    // forward message
    var fwdOptions = SmtpForward.Create();
    fwdOptions.SetMessage(eml);
    fwdOptions.AddRecipient("rec@domain.com");
    await client.ForwardAsync(fwdOptions);
    Console.WriteLine("message was forwarded");
}

// Token provider implementation
public class TokenProvider : IAsyncTokenProvider
{
    private readonly PublicClientApplicationOptions _pcaOptions;
    private readonly string[] _scopes;

    public TokenProvider(string clientId, string tenantId, string redirectUri, string[] scopes)
    {
        _pcaOptions = new PublicClientApplicationOptions
        {
            ClientId = clientId,
            TenantId = tenantId,
            RedirectUri = redirectUri
        };

        _scopes = scopes;
    }

    public async Task<OAuthToken> GetAccessTokenAsync(bool ignoreExistingToken = false, CancellationToken cancellationToken = default)
    {

        var pca = PublicClientApplicationBuilder
            .CreateWithApplicationOptions(_pcaOptions).Build();

        try
        {
            var result = await pca.AcquireTokenInteractive(_scopes)
                .WithUseEmbeddedWebView(false)
                .ExecuteAsync(cancellationToken);

            return new OAuthToken(result.AccessToken);
        }
        catch (MsalException ex)
        {
            Console.WriteLine($"Error acquiring access token: {ex}");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex}");
        }

        return null;
    }

    public void Dispose()
    {

    }
}

ارسال پیام‌ها از دیسک

فایل‌های EML شامل هدر، بدنه پیام و پیوست‌ها هستند. Aspose.Email به توسعه‌دهندگان امکان کار با فایل‌های EML را به روش‌های مختلف می‌دهد. این بخش نشان می‌دهد چگونه فایل‌های EML را از دیسک بارگذاری کرده و به عنوان ایمیل با SMTP ارسال کنیم. می‌توانید فایل‌های .eml را از دیسک یا جریان به داخل MailMessage کلاس و پیام ایمیل را با استفاده از SmtpClient کلاس. MailMessage کلاس اصلی برای ایجاد پیام‌های ایمیلی جدید، بارگذاری فایل‌های پیام ایمیل از دیسک یا جریان و ذخیره‌سازی پیام‌ها است. قطعه کد زیر در C# نشان می‌دهد چگونه پیام‌های ذخیره‌شده را از دیسک ارسال کنید.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Load an EML file in MailMessage class
var message = MailMessage.Load(dataDir + "test.eml");

// Send this message using SmtpClient
var client = new SmtpClient("host", "username", "password");
            
try
{
    client.Send(message);
}
catch (Exception ex)
{
    Console.WriteLine(ex.Message);
}

ارسال ایمیل‌ها به صورت متن ساده

این بدنه ویژگی، یک ویژگی از MailMessage کلاس، برای مشخص کردن محتوای متن ساده بدنه پیام استفاده می‌شود. برای ارسال یک پیام ایمیل متن ساده، این مراحل را دنبال کنید:

یک نمونه از MailMessage کلاس.
آدرس ایمیل فرستنده و گیرنده را در MailMessage نمونه.
مشخص کنید بدنه محتوا، برای پیام متن ساده استفاده می‌شود.
یک نمونه از SmtpClient کلاس و ایمیل را ارسال کنید.

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

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
//Create an instance of the MailMessage class
var message = new MailMessage();

// Set From field, To field and Plain text body
message.From = "sender@sender.com";
message.To.Add("receiver@receiver.com");
message.Body = "This is Plain Text Body";

// Create an instance of the SmtpClient class
var client = new SmtpClient();

// And Specify your mailing host server, Username, Password and Port
client.Host = "smtp.server.com";
client.Username = "Username";
client.Password = "Password";
client.Port = 25;

try
{
    //Client.Send will send this message
    client.Send(message);
    Console.WriteLine("Message sent");
}
catch (Exception ex)
{
    System.Diagnostics.Trace.WriteLine(ex.ToString());
}

ارسال ایمیل‌ها با بدنه HTML

نمونه‌های برنامه‌نویسی زیر نشان می‌دهند چگونه می‌توانید یک پیام ایمیل ساده HTML ارسال کنید. این HtmlBody، یک ویژگی از MailMessage کلاس، برای مشخص کردن محتوای HTML بدنه پیام استفاده می‌شود. برای ارسال یک ایمیل ساده HTML، این مراحل را دنبال کنید:

یک نمونه از MailMessage کلاس.
آدرس ایمیل فرستنده و گیرنده را در MailMessage نمونه.
مشخص کنید HtmlBody محتوا.
یک نمونه از SmtpClient کلاس و ایمیل را با استفاده از ارسال متد.

برای هدف این مقاله، محتوای HTML ایمیل به صورت ساده است: This is the HTML body اکثر ایمیل‌های HTML پیچیده‌تر خواهند بود. قطعه کد زیر نشان می‌دهد چگونه ایمیلی با بدنه HTML ارسال کنید.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
public static void Run()
{
    // Declare msg as MailMessage instance
    var msg = new MailMessage();

    // Use MailMessage properties like specify sender, recipient, message and HtmlBody
    msg.From = "newcustomeronnet@gmail.com";
    msg.To = "asposetest123@gmail.com";
    msg.Subject = "Test subject";
    msg.HtmlBody = "<html><body>This is the HTML body</body></html>";

    var client = GetSmtpClient();

    try
    {
        // Client will send this message
        client.Send(msg);
        Console.WriteLine("Message sent");
    }
    catch (Exception ex)
    {
        Trace.WriteLine(ex.ToString());
    }

    Console.WriteLine(Environment.NewLine + "Email sent with HTML body.");
}

private static SmtpClient GetSmtpClient()
{
    var client = new SmtpClient("smtp.gmail.com", 587, "your.email@gmail.com", "your.password");
    client.SecurityOptions = SecurityOptions.Auto;
    return client;
}

ارسال ایمیل‌های HTML با متن جایگزین

از AlternateView کلاس برای مشخص کردن نسخه‌های یک پیام ایمیل در قالب‌های مختلف. برای مثال، اگر پیام را به صورت HTML ارسال کنید، ممکن است بخواهید نسخه متن ساده نیز برای دریافت‌کنندگانی که ایمیل‌خوان‌هایی دارند که نمی‌توانند محتوای HTML را نمایش دهند، ارائه کنید. یا اگر خبرنامه‌ای می‌فرستید، ممکن است بخواهید یک نسخه متن ساده از متن برای دریافت‌کنندگانی که نسخه متن ساده را انتخاب کرده‌اند، فراهم کنید. برای ارسال ایمیل با متن جایگزین، این مراحل را دنبال کنید:

یک نمونه از MailMessage کلاس.
آدرس ایمیل فرستنده و گیرنده را در MailMessage نمونه.
یک نمونه از AlternateView کلاس.

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

نمونه‌ای از AlternateView کلاس به MailMessage شیء.
یک نمونه از SmtpClient کلاس و ایمیل را با استفاده از ارسال متد.

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

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Declare message as MailMessage instance
var message = new MailMessage();

// Creates AlternateView to view an email message using the content specified in the //string
var alternate = AlternateView.CreateAlternateViewFromString("Alternate Text");
            
// Adding alternate text
message.AlternateViews.Add(alternate);

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

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

یک نمونه از SmtpClient کلاس.
مشخص کنید SmtpClient ویژگی‌های کلاس را مشخص کنید.
یک نمونه از MailMessage کلاس.
فرستنده، گیرنده، موضوع ایمیل و پیام را در نمونه MailMessage کلاس.
دو مرحله بالا را دوباره تکرار کنید، اگر می‌خواهید ایمیل را به شخص دیگری ارسال کنید.
یک نمونه از MailMessageCollection کلاس.
یک نمونه از MailMessage کلاس در شیء MailMessageCollection کلاس.
اکنون ایمیل خود را با استفاده از SmtpClient کلاس ارسال متد با عبور نمونه از MailMessageCollection کلاس در آن.

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

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Create SmtpClient as client and specify server, port, user name and password
var client = new SmtpClient("mail.server.com", 25, "Username", "Password");

// Create instances of MailMessage class and Specify To, From, Subject and Message
var message1 = new MailMessage("msg1@from.com", "msg1@to.com", "Subject1", "message1, how are you?");
var message2 = new MailMessage("msg1@from.com", "msg2@to.com", "Subject2", "message2, how are you?");
var message3 = new MailMessage("msg1@from.com", "msg3@to.com", "Subject3", "message3, how are you?");

// Create an instance of MailMessageCollection class
var manyMsg = new MailMessageCollection();
manyMsg.Add(message1);
manyMsg.Add(message2);
manyMsg.Add(message3);

try
{
    // Send Messages using Send method
    client.Send(manyMsg);                
    Console.WriteLine("Message sent");
}
catch (Exception ex)
{
    Trace.WriteLine(ex.ToString());
}

پیگیری موفقیت ایمیل‌های انبوه

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

نمونه کد:

using (var client = new SmtpClient(host, SecurityOptions.Auto))
{
    int messageCount = 0;

    client.SucceededSending += (sender, eventArgs) =>
    {
        Console.WriteLine("The message '{0}' was successfully sent.", eventArgs.Message.Subject);
        messageCount++;
    };

    client.Send(messages);

    Console.WriteLine("{0} messages were successfully sent.", messageCount);
}

ارسال ایمیل‌ها با MultiConnection

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

var smtpClient = new SmtpClient();
smtpClient.Host = "<HOST>";
smtpClient.Username = "<USERNAME>";
smtpClient.Password = "<PASSWORD>";
smtpClient.Port = 587;
smtpClient.SupportedEncryption = EncryptionProtocols.Tls;
smtpClient.SecurityOptions = SecurityOptions.SSLExplicit;

var messages = new List<MailMessage>();
for (int i = 0; i < 20; i++)
{
    MailMessage message = new MailMessage(
        "<EMAIL ADDRESS>",
        "<EMAIL ADDRESS>",
        "Test Message - " + Guid.NewGuid().ToString(),
        "SMTP Send Messages with MultiConnection");
    messages.Add(message);
}

smtpClient.ConnectionsQuantity = 5;
smtpClient.UseMultiConnection = MultiConnectionMode.Enable;
smtpClient.Send(messages);

لطفاً توجه داشته باشید که استفاده از حالت چنداتصال تضمین‌کننده‌ی افزایش عملکرد نیست.

ارسال پیام‌ها به صورت TNEF

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

var emlFileName = RunExamples.GetDataDir_Email() + "Message.eml";     // A TNEF Email

// Load from eml
var eml1 = MailMessage.Load(emlFileName, new EmlLoadOptions());
eml1.From = "somename@gmail.com";
eml1.To.Clear();
eml1.To.Add(new MailAddress("first.last@test.com"));
eml1.Subject = "With PreserveTnef flag during loading";
eml1.Date = DateTime.Now;

var client = new SmtpClient("smtp.gmail.com", 587, "somename", "password");
client.SecurityOptions = SecurityOptions.Auto;
client.UseTnef = true;     // Use this flag to send as TNEF
client.Send(eml1);

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

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

ارسال درخواست‌ها از طریق ایمیل

برای ارسال درخواست‌های جلسه از طریق ایمیل، این مراحل را دنبال کنید:

یک نمونه از MailMessage کلاس.
آدرس‌های فرستنده و گیرنده را با استفاده از یک نمونه از MailMessage کلاس.
یک نمونه از را مقداردهی اولیه کنید Appointment کلاس و مقادیر آن را پاس دهید.
خلاصه و توصیف را در Calendar نمونه.
افزودن Calendar به MailMessage نمونه و پاس دهید آن را Appointment نمونه.

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


// Create an instance of the MailMessage class
var msg = new MailMessage();

// Set the sender, recipient, who will receive the meeting request. Basically, the recipient is the same as the meeting attendees
msg.From = "newcustomeronnet@gmail.com";
msg.To = "person1@domain.com, person2@domain.com, person3@domain.com, asposetest123@gmail.com";

// Create Appointment instance
var app = new Appointment("Room 112", new DateTime(2015, 7, 17, 13, 0, 0), new DateTime(2015, 7, 17, 14, 0, 0), msg.From, msg.To);
app.Summary = "Release Meetting";
app.Description = "Discuss for the next release";

// Add appointment to the message and Create an instance of SmtpClient class
msg.AddAlternateView(app.RequestApointment());
var client = GetSmtpClient();

try
{
    // Client.Send will send this message
    client.Send(msg);
    Console.WriteLine("Message sent");
}
catch (Exception ex)
{
    Trace.WriteLine(ex.ToString());
}

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

ارسال پیام‌ها با کلاینت SMTP

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

//Create an instance of SmtpClient class
var client = new SmtpClient();

// Specify your mailing host server, Username, Password, Port and SecurityOptions
client.Host = "mail.server.com";
client.Username = "username";
client.Password = "password";
client.Port = 587;
client.SecurityOptions = SecurityOptions.SSLExplicit;
var message = MailMessage.Load(dataDir + "Message.eml");
client.Forward("Recipient1@domain.com", "Recipient2@domain.com", message);

ارسال پیام‌ها بدون MailMessage

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


using (var client = new SmtpClient(host, smtpPort, username, password, SecurityOptions.Auto))
{
    using (var fs = File.OpenRead(@"test.eml"))
    {
        client.Forward(sender, recipients, fs);
    }
}

ارسال پیام‌ها به‌صورت ناهمزمان بدون MailMessage

using (var client = new SmtpClient(host, smtpPort, username, password))
{
    using (var fs = File.OpenRead(@"test.eml"))
    {
        await client.ForwardAsync(sender, recipients, fs);
    }
}

ادغام ایمیل (Mail Merge)

چگونه ایمیل‌ها را ادغام کنیم

ادغام نامه به شما کمک می‌کند یک دسته از پیام‌های ایمیل مشابه را ایجاد و ارسال کنید. محتوای اصلی ایمیل‌ها یکسان است، اما محتوا می‌تواند شخصی‌سازی شود. معمولاً جزئیات تماس گیرنده (نام، نام خانوادگی، شرکت و غیره) برای شخصی‌سازی ایمیل استفاده می‌شود.

|نمونه‌ای از نحوه کار ترکیب ایمیل:| | :- | || Aspose.Email به توسعه‌دهندگان اجازه می‌دهد ترکیب‌های ایمیل را که شامل داده از منابع مختلف هستند تنظیم کنند.

برای انجام ادغام نامه با Aspose.Email، مراحل زیر را انجام دهید:

یک تابع با امضای نام ایجاد کنید
یک نمونه از MailMessage کلاس.
فرستنده، گیرنده، موضوع و بدنه را مشخص کنید.
یک امضا برای انتهای ایمیل ایجاد کنید.
یک نمونه از TemplateEngine کلاس بگیرید و به آن MailMessage نمونه.
امضای را در TemplateEngine نمونه.
یک نمونه از کلاس DataTable ایجاد کنید.
ستون‌های Receipt، FirstName و LastName را به عنوان منبع داده در کلاس DataTable اضافه کنید.
یک نمونه از کلاس DataRow ایجاد کنید.
آدرس دریافت، نام و نام خانوادگی را در شیء DataRow مشخص کنید.
یک نمونه از MailMessageCollection کلاس
مشخص کنید TemplateEngine و نمونه‌های DataTable در MailMessageCollection نمونه.
یک نمونه از SmtpClient کلاس و سرور، پورت، نام کاربری و رمز عبور را مشخص کنید.
ارسال ایمیل‌ها با استفاده از SmtpClient کلاس ارسال متد.

در نمونه زیر، #FirstName# نمایانگر یک ستون DataTable است که مقدار آن توسط کاربر تنظیم می‌شود. قطعه کد زیر نشان می‌دهد چگونه Mail Merge انجام شود.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
public static void Run()
{
    // The path to the File directory.
    string dataDir = RunExamples.GetDataDir_SMTP();
    string dstEmail = dataDir + "EmbeddedImage.msg";

    // Create a new MailMessage instance
    MailMessage msg = new MailMessage();

    // Add subject and from address
    msg.Subject = "Hello, #FirstName#";
    msg.From = "sender@sender.com";

    // Add email address to send email also Add mesage field to HTML body
    msg.To.Add("your.email@gmail.com");
    msg.HtmlBody = "Your message here";
    msg.HtmlBody += "Thank you for your interest in <STRONG>Aspose.Email</STRONG>.";

    // Use GetSignment as the template routine, which will provide the same signature
    msg.HtmlBody += "<br><br>Have fun with it.<br><br>#GetSignature()#";

    // Create a new TemplateEngine with the MSG message,  Register GetSignature routine. It will be used in MSG.
    TemplateEngine engine = new TemplateEngine(msg);
    engine.RegisterRoutine("GetSignature", GetSignature);

    // Create an instance of DataTable and Fill a DataTable as data source
    DataTable dt = new DataTable();
    dt.Columns.Add("Receipt", typeof(string));
    dt.Columns.Add("FirstName", typeof(string));
    dt.Columns.Add("LastName", typeof(string));

    DataRow dr = dt.NewRow();
    dr["Receipt"] = "abc<asposetest123@gmail.com>";
    dr["FirstName"] = "a";
    dr["LastName"] = "bc";
    dt.Rows.Add(dr);
    dr = dt.NewRow();
    dr["Receipt"] = "John<email.2@gmail.com>";
    dr["FirstName"] = "John";
    dr["LastName"] = "Doe";
    dt.Rows.Add(dr);
    dr = dt.NewRow();
    dr["Receipt"] = "Third Recipient<email.3@gmail.com>";
    dr["FirstName"] = "Third";
    dr["LastName"] = "Recipient";
    dt.Rows.Add(dr);

    MailMessageCollection messages;
    try
    {
        // Create messages from the message and datasource.
        messages = engine.Instantiate(dt);

        // Create an instance of SmtpClient and specify server, port, username and password
        SmtpClient client = new SmtpClient("smtp.gmail.com", 587, "your.email@gmail.com", "your.password");
        client.SecurityOptions = SecurityOptions.Auto;

        // Send messages in bulk
        client.Send(messages);
    }
    catch (MailException ex)
    {
        Debug.WriteLine(ex.ToString());
    }

    catch (SmtpException ex)
    {
        Debug.WriteLine(ex.ToString());
    }

    Console.WriteLine(Environment.NewLine + "Message sent after performing mail merge.");
}

// Template routine to provide signature
static object GetSignature(object[] args)
{
    return "Aspose.Email Team<br>Aspose Ltd.<br>" + DateTime.Now.ToShortDateString();
}

چگونه ادغام ایمیل سطر به سطر انجام شود

کاربر می‌تواند ردیف دادهٔ فردی را ادغام کند و همچنین یک مجموعهٔ کامل و آماده دریافت کند. MailMessage شیء. این TemplateEngine.Merge متد می‌تواند برای انجام ترکیب ایمیل به‌صورت سطری استفاده شود.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Create message from the data in current row.
message = engine.Merge(currentRow);

Net: فعال‌سازی لاگ‌گیری فعالیت SMTP در .NET با استفاده از appsettings.json

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

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

فعال‌سازی ثبت فعالیت

استفاده از فایل appsettings.json برای فعال‌سازی لاگ‌گیری فعالیت

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

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

یک فایل پیکربندی appsettings.json به پروژه C# اضافه کنید، اگر قبلاً اضافه نشده باشد.

اطمینان حاصل کنید که فایل پروژه خطوط زیر را در بخش ItemGroup دارد.

   <Content Include="appsettings.json">
       <CopyToOutputDirectory>Always</CopyToOutputDirectory>
   </Content>

سپس محتویات زیر را به فایل appsettings.json اضافه کنید.

   {
     "SmtpDiagnosticLog": "smtp.log",
     "SmtpDiagnosticLog_UseDate": true
   }

دو ویژگی ذکر شده در بالا عبارتند از:

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

فعال‌سازی لاگ‌گیری فعالیت در کد برنامه

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

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

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

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

   using (var client = new SmtpClient("your smtp server"))
   {
       // Set username, password, port, and security options
       client.Username = "your username";
       client.Password = "your password";
       client.Port = 465;
       client.SecurityOptions = SecurityOptions.SSLImplicit;
   
       // Set the path to the log file using the LogFileName property.
       client.LogFileName = @"C:\Aspose.Email.Smtp.log";
       
       // Set the UseDateInLogFileName property if it is necessary.
       client.UseDateInLogFileName = false;
   
       var eml = new MailMessage("from address", "to address", "this is a test subject", "this is a test body");
   
       client.Send(eml);
   }

استفاده از فایل App.config برای فعال‌سازی لاگ‌گیری فعالیت

فعالیت کلاینت SMTP می‌تواند با تغییر configSections در فایل پیکربندی لاگ شود. لاگ‌گیری تشخیص می‌تواند با مراحل زیر انجام شود:

یک sectionGroup به نام "applicationSettings" اضافه کنید.
بخشی به نام "Aspose.Email.Properties.Settings" اضافه کنید.
تنظیم با نام SmtpDiagonosticLog را شامل کنید که نام فایل در applicationSettings/Aspose.Email.Properties.Settings تعریف شده است

در اینجا یک نمونه برنامه مبتنی بر فرم که استفاده می‌کند آورده شده است SmtpClient برای ارسال ایمیل. تمام این فعالیت با تغییر فایل App.config لاگ می‌شود. یک برنامه فرم با یک دکمه ایجاد کنید. کد زیر را برای کلیک دکمه اضافه کنید:

مرجع به Aspose.Email را اضافه کنید.

فایل App.Config را اضافه کنید و به گونه‌ای ویرایش کنید که محتوای آن به شکل زیر باشد

برای C# .NET از گزینه زیر استفاده کنید

برای VB .NET از گزینه زیر استفاده کنید

کد را اجرا کنید و سپس پوشه debug را بررسی کنید. فایل زیر تولید خواهد شد.