Documentation – SMTP 클라이언트 작업

Net: SMTP 서버에 연결하기

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

이메일 클라이언트 연결 최적화

사용자는 기본 타임아웃 설정으로 인해 지연이 발생하는 경우가 많으며, 이는 연결 시간이 길어지거나 시도 자체가 실패할 수 있습니다.

이러한 연결 효율성을 개선하기 위해 Aspose.Email for .NET은 다음과 같은 속성을 제공합니다 시간 제한 및 GreetingTimeout. 반면에 Timeout 속성은 이메일 작업 전체 기간을 관리합니다, GreetingTimeout 속성은 서버가 연결 시 인사 문자열을 보내는 데 걸리는 시간을 특정합니다.

다음 섹션에서는 이러한 설정을 구성하여 이메일 클라이언트의 연결 속도와 안정성을 향상시키는 방법을 살펴보겠습니다.

사용할 때 Timeout 속성을 사용할 때는 할당된 값이 긴 작업을 수행할 수 있도록 충분히 긴 간격을 가져야 한다는 점에 유의해야 합니다.

하지만 이 속성에만 의존하면 연결 설정이 예상보다 오래 걸릴 수 있습니다. 이는 이메일 클라이언트가 자동 모드로 연결을 설정할 때 발생할 수 있습니다. 이 모드에서는 클라이언트가 연결이 설정될 때까지 다양한 연결 매개변수를 순환합니다.

SMTP, IMAP 및 POP3 서버에 연결할 때, 성공적으로 연결이 설정되면 인사 문자열이 클라이언트에 전송됩니다. 서버는 암시적이거나 명시적(START TLS) SSL/TLS 연결 시작을 사용할 수 있습니다. 연결 모드가 일치하지 않을 경우(예: 서버가 암시적 SSL 연결을 기대하지만 클라이언트가 비보안 또는 명시적 SSL 연결을 시도하는 경우) 서버는 인사 문자열을 보내지 않습니다.

그 결과, 사용자는 타임아웃이 도달할 때까지 오래 기다릴 수 있으며, 클라이언트는 다음 연결 옵션으로 넘어갑니다.

이 문제를 해결하기 위해, GreetingTimeout 속성이 도입되었습니다. 이 속성을 사용하면 사용자는 인사 문자열에 대한 타임아웃을 설정하여 자동 연결을 설정하는 데 걸리는 시간을 줄일 수 있습니다. 이를 구현함으로써 GreetingTimeout 속성을 사용하면 사용자는 이메일 클라이언트의 성능을 최적화하고 연결 설정 중 긴 대기 시간을 피할 수 있습니다.

다음 코드 샘플은 다음을 설정하는 방법을 보여줍니다 EmailClient.GreetingTimeout 속성:

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

서버 확장 기능 가져오기

다음은 SmtpClient 서버가 지원하는 IDLE, UNSELECT, QUOTA 등과 같은 확장 기능을 검색할 수 있게 해줍니다. 이는 특정 기능을 사용하기 전에 확장의 가용성을 판단하는 데 도움이 됩니다. 해당 GetCapabilities() method는 지원되는 확장 유형을 문자열 배열 형태로 반환합니다.

다음 코드 스니펫은 서버 확장 기능을 검색하는 방법을 보여줍니다.

이메일 전송 없이 메일 서버 자격 증명 검증

Aspose.Email API는 이메일을 전송하지 않고도 메일 서버 자격 증명을 검증할 수 있는 기능을 제공합니다. 이는 다음을 사용하여 구현할 수 있습니다 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은 SOCKS 프록시 프로토콜 버전 4, 4a 및 5를 지원합니다. 프록시 서버를 통해 이메일을 보내려면 다음 단계를 수행하십시오:

프록시 주소, 포트 및 SOCKS 버전 등 필요한 정보를 사용하여 프록시를 초기화합니다.
초기화 SmtpClient 호스트 주소, 사용자 이름 및 비밀번호, 그리고 기타 설정과 함께.
클라이언트의 Proxy 속성을 다음으로 설정합니다 Proxy 이전에 생성된 객체.

다음 코드 스니펫은 프록시 서버를 통해 서버에 연결하는 방법을 보여줍니다.

HTTP 프록시 서버를 통한 이메일 전송

보안 SMTP 연결을 위한 인증 방법 식별

Aspose.Email은 이메일을 전송하기 전에 SMTP 서버와 보안 연결을 설정할 때 사용할 수 있는 인증 방법을 확인할 수 있는 속성을 제공합니다:

그 SmtpClient.SupportedAuthentication 속성은 SMTP 서버가 지원하는 인증 방법 목록을 반환합니다.
그 SmtpClient.AllowedAuthentication 속성은 사용자가 정의한 인증 방법 목록을 반환합니다.

smtpClient.AllowedAuthentication = SmtpKnownAuthenticationType.Login;

CONFIG 파일에서 SMTP 인증 정보 로드

Aspose.Email이 구성 파일을 읽을 수 있으려면 올바른 형식이어야 합니다. 아래에 예시 XML 구성 파일과 이를 읽는 코드를 보여드립니다. 다음 코드 스니펫은 CONFIG 파일에서 SMTP 인증 정보를 로드하는 방법을 보여줍니다.

구성 설정이 정의되면, 이러한 설정을 해당 클래스 인스턴스에 직접 로드합니다 SmtpClient 클래스는 오버로드된 생성자 중 하나를 사용합니다. 다음 코드 스니펫은 구성 파일에서 설정을 읽어 해당 클래스 인스턴스에 직접 로드하는 예를 보여줍니다. SmtpClient.

SMTP 클라이언트를 특정 IP 주소에 바인딩

호스트에 이메일 전송을 위한 여러 포트가 존재할 가능성을 배제할 수 없습니다. 이러한 경우, 이메일 전송 클라이언트를 호스트의 특정 포트에 바인딩해야 할 필요가 생길 수 있습니다. 이는 Aspose.Email API를 사용하여도 구현할 수 있습니다. SmtpClient BindIPEndPoint 속성. API의 SmtpClient 특정 IP 엔드포인트를 지정하여 호스트에서 특정 IP 주소를 사용하도록 설정할 수 있습니다. 다음 코드 스니펫은 SMTP 클라이언트를 호스트의 특정 IP 주소에 바인딩하는 방법을 보여줍니다.

메일 작업 타임아웃 설정

각 메일 작업은 네트워크 지연, 데이터 크기, 서버 성능 등 여러 요인에 따라 시간이 소요됩니다. 모든 메일 작업에 대한 시간 제한을 설정할 수 있습니다. 아래 코드 예제는 이를 …을 사용해 설정하는 방법을 보여줍니다. 시간 제한 속성.

참고: 애플리케이션에서 긴 대기를 방지하려면 큰 값을 설정하지 말아야 합니다.

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

    // some code...
}

암호화 프로토콜 사용

Aspose.Email은 SSL(구식) 및 TLS 암호화 프로토콜을 지원하여 통신 보안을 제공합니다. 애플리케이션과 메일 서버 간 데이터 교환을 보호하려면 암호화 암호화를 활성화할 수 있습니다.

NOTE: .NET Framework에서 지원하는 프로토콜 버전만 설정해야 합니다. 현재 사용 중인 .NET Framework 버전에서 지원되지 않는 암호화 프로토콜 버전은 무시되고 건너뛰어집니다. 이 경우 예외가 발생하지 않습니다. Please use 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 속성은 다음과 같습니다:

If SupportedEncryption 이 속성이 사용되면 이메일 클라이언트가 암호화 프로토콜을 지원되는 수준으로 낮춥니다.
If SetSupportedEncryptionUnsafe 이 메서드가 사용되면 이메일 클라이언트가 예외를 발생시킵니다.

CRAM-MD5 메커니즘을 이용한 SMTP 인증

Aspose.Email for .NET의 CRAM-MD5 인증 메커니즘은 서버에 접근할 때 추가 보안 계층을 제공합니다. 다음 코드 스니펫은 프로젝트에 이 기능을 구현하는 방법을 보여줍니다:

smtpClient.AllowedAuthentication = SmtpKnownAuthenticationType.CramMD5;

Net: C#에서 SMTP 클라이언트를 사용하여 이메일 전송 및 메시지 전달

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

이메일 전송

SmtpClient 클래스를 사용한 이메일 전송

다음은 SmtpClient 클래스는 애플리케이션이 SMTP(Simple Mail Transfer Protocol)를 통해 이메일을 보낼 수 있게 합니다.

주요 기능 중 하나는 대량 메시지 전송.

또한 완전히 지원합니다 동기식 및 비동기식 프로그래밍 모델을 사용할 수 있습니다. 작업이 완료될 때까지 메인 스레드를 차단하여 이메일을 전송하려면 개발자는 동기식 중 하나를 사용할 수 있습니다 보내기 메서드. 또는 이메일 전송 중에 메인 스레드가 계속 실행되도록 하려면 개발자는 SendAsync 메서드.

또한, SmtpClient 다음 형식으로 메시지 전송을 지원합니다 전송 중립 캡슐화 형식 (TNEF).

동기식 이메일 전송

이메일 메시지는 다음을 사용해 동기적으로 전송할 수 있습니다 보내기 메서드 SmtpClient 클래스. 지정된 이메일 메시지를 SMTP 서버를 통해 전송합니다. 이메일 메시지를 동기식으로 보내려면 아래 단계에 따라 진행하십시오:

다음의 인스턴스를 생성합니다 MailMessage class를 사용하고 해당 속성을 설정합니다.
다음의 인스턴스를 생성합니다 SmtpClient class에 호스트, 포트, 사용자명 및 비밀번호를 지정합니다.
다음을 사용하여 메시지를 전송합니다 보내기 메서드 SmtpClient class에 전달하고 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 이메일 메시지를 보내는 방법을 보여줍니다:

SendAsync 지정된 메시지를 보냅니다.
IAsyncSmtpClient - 애플리케이션이 간단 메일 전송 프로토콜(SMTP)을 사용해 메시지를 보낼 수 있도록 합니다.
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);
}

다중 연결을 사용한 이메일 전송

다음은 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 class에 값을 전달합니다.
요약 및 설명을 지정합니다 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);
    }
}

메일 병합

이메일 병합 방법

메일 병합을 사용하면 유사한 이메일 메시지를 일괄 생성 및 전송할 수 있습니다. 이메일 내용은 동일하지만, 받는 사람의 연락처 정보(이름, 성, 회사 등)를 활용해 개인화할 수 있습니다.

|메일 병합 작동 방식 예시:| | :- | || Aspose.Email을 사용하면 개발자가 다양한 데이터 소스의 데이터를 포함하는 메일 병합을 설정할 수 있습니다.

Aspose.Email으로 메일 병합을 수행하려면 다음 단계를 따르세요:

다음 서명 이름을 가진 함수를 생성합니다
다음의 인스턴스를 생성합니다. MailMessage 클래스.
보낸 사람, 받는 사람, 제목 및 본문을 지정합니다.
이메일 끝에 서명을 생성합니다.
다음의 인스턴스를 생성합니다. TemplateEngine 클래스와 이를 전달합니다 MailMessage 인스턴스.
다음에서 서명을 가져옵니다 TemplateEngine 인스턴스.
DataTable 클래스의 인스턴스를 생성합니다.
DataTable 클래스에 Receipt, FirstName, LastName 열을 데이터 원본으로 추가합니다.
DataRow 클래스의 인스턴스를 생성합니다.
DataRow 객체에 수신 주소와 이름 및 성을 지정합니다.
다음의 인스턴스를 생성합니다. MailMessageCollection 클래스
지정하세요 TemplateEngine 및 DataTable 인스턴스를 MailMessageCollection 인스턴스.
다음의 인스턴스를 생성합니다. SmtpClient class에 서버, 포트, 사용자명 및 비밀번호를 지정합니다.
다음으로 이메일 전송: SmtpClient 클래스 보내기 메서드.

아래 샘플에서 #FirstName#은 사용자가 값을 설정하는 DataTable 열을 나타냅니다. 아래 코드 스니펫은 메일 병합을 수행하는 방법을 보여줍니다.

// 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 object. 해당 TemplateEngine.Merge method는 행별 메일 병합을 수행하는 데 사용할 수 있습니다.

// 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: appsettings.json을 사용하여 .NET에서 SMTP 활동 로깅을 활성화합니다

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

활동 로깅은 디버깅뿐 아니라 SMTP 클라이언트에 대한 작업 정보를 수집하고 분석하는 데 사용됩니다.

활동 로깅 활성화

appsettings.json 파일을 사용하여 활동 로깅 활성화

NOTE: .NET Core 애플리케이션에 권장되는 옵션입니다.

로그인 SmtpClient 다음 단계와 코드 샘플로 활성화할 수 있습니다:

C# 프로젝트에 아직 추가되지 않은 경우 appsettings.json 구성 파일을 추가합니다.

프로젝트 파일에 ItemGroup 섹션에 다음 라인이 포함되어 있는지 확인하십시오.

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

그런 다음 appsettings.json 파일에 다음 내용을 추가합니다.

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

위에서 언급한 두 속성은 다음과 같습니다:

SmtpDiagnosticLog - 로그 파일의 상대 경로나 절대 경로를 지정합니다.
SmtpDiagnosticLog_UseDate - 로그 파일 이름에 현재 날짜의 문자열 표현을 추가할지 여부를 지정합니다.

프로그램 코드에서 활동 로깅 활성화

코드에서 즉시 로깅을 활성화할 수도 있습니다.

NOTE: 구성 파일을 사용해 이미 로깅을 활성화했더라도 이 옵션이 적용됩니다.

로그인 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 클라이언트 활동은 config 파일의 configSections를 수정하여 기록할 수 있습니다. 진단 로깅은 다음 단계로 수행할 수 있습니다:

"applicationSettings" 섹션 그룹을 추가합니다.
"Aspose.Email.Properties.Settings" 섹션을 추가합니다.
파일 이름이 applicationSettings/Aspose.Email.Properties.Settings에 정의된 SmtpDiagonosticLog라는 이름의 설정을 포함합니다

다음은 사용되는 샘플 폼 기반 애플리케이션입니다 SmtpClient 이메일을 보내기 위해서입니다. 이 전체 활동은 App.config 파일을 수정하여 기록됩니다. 단일 버튼이 있는 폼 애플리케이션을 생성합니다. 버튼 클릭에 대한 다음 코드를 추가하십시오:

Aspose.Email에 대한 참조를 추가합니다.

App.Config 파일을 추가하고 파일 내용이 다음과 같이 되도록 수정합니다

C# .NET의 경우 다음 옵션을 사용합니다

VB .NET의 경우 다음 옵션을 사용합니다

코드를 실행한 후 디버그 폴더를 확인하십시오. 다음 파일이 생성됩니다.