Documentation – C++ Email Parser API를 사용하여 MIME 메시지를 다룹니다

Cpp: Aspose.Email for C++를 사용하여 이메일 메시지 만들기 및 사용자 정의

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

**Aspose.Email for C++**는 다음을 제공합니다. MailMessage 클래스는 다양한 형식으로 이메일 메시지를 생성, 사용자 정의 및 저장합니다. 이 클래스는 발신자, 수신자, 제목 및 본문과 같은 필수 속성을 정의할 수 있게 하며, EML, MSG, MHTML 형식으로 메시지를 저장하는 것을 지원합니다.

새 이메일 메시지 만들기

다음 코드 샘플은 Aspose.Email for C++를 사용하여 새 이메일 메시지를 생성하고 구성하는 방법을 보여줍니다.

다음의 인스턴스를 생성합니다. MailMessage 클래스.
From, To, Cc, Subject, HtmlBody와 같은 메시지 속성을 설정합니다.
필요에 따라 메시지를 여러 형식(EML, MSG, MHTML 등)으로 저장합니다.

이메일 주소에 친근한 이름 사용

친근한 이름은 이메일 주소를 더 읽기 쉽게 만듭니다. 예를 들어, John Smith <jsmith@domain.com> 그냥 대신에 jsmith@domain.com.

다음 을 사용하여 이메일을 구성할 때 주소에 친절한 이름을 연결할 수 있습니다: MailMessage 클래스.

아래 코드 샘플은 친절한 이름을 추가하는 방법을 보여줍니다:

새 인스턴스를 생성합니다 MailMessage 클래스.
추가 To, Cc, 그리고 Bcc 주소와 친절한 이름을 모두 가진 수신자.

메일 본문 내용 설정

다음은 MailMessage 클래스를 사용하면 이메일 본문을 HTML 형식으로 정의할 수 있습니다. 또한 대체 보기를 제공하여 다양한 이메일 클라이언트에 맞게 설정할 수 있습니다. AlternateView 클래스.

HTML 본문 설정

다음 코드 샘플은 이메일 메시지에 HTML 문자열을 할당하여 HTML 내용을 설정하는 방법을 보여줍니다. set_HtmlBody 속성. 이 문자열을 메시지 본문으로 사용하면 이메일이 일반 텍스트가 아닌 HTML 형식으로 전송됨을 나타냅니다.

대체 텍스트 설정

일부 이메일 클라이언트는 HTML 내용을 표시하지 못합니다. 모든 수신자가 메시지를 읽을 수 있도록 대체 일반 텍스트 버전을 추가할 수 있습니다. AlternateView 클래스입니다. 다양한 형식으로 이메일 메시지의 여러 버전을 포함할 수 있게 합니다. 예를 들어, 기본 메시지 본문이 HTML인 경우 대안으로 일반 텍스트 버전을 첨부할 수 있습니다.

아래 코드 샘플은 이메일 메시지를 생성하고 일반 텍스트 내용을 포함한 대체 보기를 추가하는 방법을 보여줍니다.

다음은 AlternateView 클래스는 이메일 본문에서 사용되는 리소스도 관리합니다:

LinkedResources – 메시지 내용의 링크가 참조하는 이미지나 첨부 파일과 같은 임베드된 항목들의 컬렉션입니다.
set_BaseUri() – 메시지 본문에서 상대 링크나 리소스 경로를 해석하는 데 사용되는 기본 URL을 정의합니다.

Cpp: C++에서 이메일 내용 생성 및 설정 및 SmtpClient를 사용한 이메일 전송

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

새 이메일 메시지 만들기

MailMessage 클래스는 이메일 메시지를 나타내며 개발자가 새 이메일 메시지를 생성할 수 있게 합니다. From, To, Subject 및 본문과 같은 기본 이메일 속성을 새 메일 메시지에 쉽게 지정할 수 있습니다. 또한 메일 메시지를 EML, MSG, MHTML과 같은 다양한 형식으로 저장할 수 있습니다.

<a name="csharp-create-new-email-msg" id="csharp-create-new-email-msg">단계: C#에서 새 이메일 메시지 만들기

MailMessage 클래스를 인스턴스화합니다.
메일 메시지 속성을 설정합니다.
메일 메시지를 다양한 형식으로 저장합니다.
SmtpClient 클래스를 인스턴스화하고 Send 메서드를 사용하여 이메일을 보냅니다.

다음 C++ 코드 스니펫은 다양한 속성을 가진 새 이메일을 만드는 방법을 보여줍니다.

이메일 주소를 친숙한 이름으로 변경

아래 프로그래밍 예제는 이메일 메시지의 이메일 주소를 친숙한 이름으로 변경하는 방법을 보여줍니다. 친숙한 이름은 이메일 주소보다 사람에게 더 이해하기 쉬운 이름이며, 예를 들어 js346@domain.com 대신 John Smith와 같이 사용할 수 있습니다. 이메일을 보낼 때 MailMessage 클래스 생성자에서 이메일 주소와 친숙한 이름을 연결할 수 있습니다.

이메일 메시지에서 이메일 주소를 친숙한 이름으로 변경하려면 다음 단계를 따르세요:

MailMessage 클래스 인스턴스를 만들고 To 및 From 필드에 친숙한 이름과 함께 이메일 주소를 지정합니다.
MailMessage 인스턴스에서 MailMessage 클래스 생성자를 호출하여 Cc 및 Bcc 이메일 주소와 친숙한 이름을 지정합니다.
SmtpClient 클래스를 인스턴스화하고 Send 메서드를 사용하여 이메일을 보냅니다.

다음 코드 스니펫은 이메일 주소에 대한 이름을 표시하는 방법을 보여줍니다.

메일 본문 설정

MailMessage 클래스는 이메일 메시지를 나타냅니다. MailMessage 클래스의 인스턴스는 SmtpClient 클래스를 사용해 SMTP 서버로 전달되는 이메일 메시지를 구성하는 데 사용됩니다. 메일 본문은 MailMessage 클래스를 사용해 지정할 수 있습니다. 이메일은 여러 본문을 가질 수 있으며, MailMessage 클래스에는 두 종류의 메일 본문이 있습니다:

HTML 본문
텍스트 본문

HtmlBody와 TextBody 외에도, Aspose.Email에는 메일 본문과 관련된 두 개의 읽기 전용 속성이 추가로 있습니다:

IsBodyText: 본문이 텍스트인지 여부를 알려줍니다.
IsBodyHtml: 본문이 HTML인지 일반 텍스트인지 여부를 알려줍니다.

이 문서는 일반 텍스트 또는 HTML 본문을 정의하고, 대체 텍스트를 설정하며, 이메일 본문을 인코딩하는 방법을 보여줍니다.

HTML 본문 설정

HtmlBody 메시지 본문의 HTML 내용을 지정하는 데 사용됩니다. HtmlBody는 태그 사이에 있어야 합니다. 다음 코드 스니펫은 HTML 본문을 설정하는 방법을 보여줍니다.

대체 텍스트 설정

AlternateView 클래스를 사용하면 이메일 메시지를 다른 형식으로 복제본을 지정할 수 있습니다. 예를 들어 HTML 형태로 메시지를 보낼 경우, HTML을 표시할 수 없는 이메일 리더를 사용하는 수신자를 위해 일반 텍스트 버전을 제공할 수 있습니다. 이 클래스에는 이메일 내용 내 URL을 해석하는 데 사용되는 LinkedResources와 BaseUri 두 속성이 있습니다.

LinkedResources는 LinkedResources 객체의 컬렉션입니다. 렌더링 시 이메일 내용 내 URL은 먼저 LinkedResources 컬렉션에 있는 각 LinkedResources 객체의 Content Link URL과 매치되어 해석됩니다.
BaseUri는 메일 리더가 본문 내 상대 URL을 해결하고, LinkedResources 컬렉션의 상대 Content Link URL을 해결하는 데 사용됩니다.

다음 C++ 코드 스니펫은 대체 텍스트를 설정하는 방법을 보여줍니다.

Cpp: C++에서 이메일 메시지 및 헤더 읽기 및 표시

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

**Aspose.Email for C++**는 다음을 제공합니다. MailMessage 클래스는 이메일 메시지를 나타내며 개발자가 내용과 헤더에 액세스하고 표시할 수 있게 합니다. 기존 이메일 파일(EML)에서 보낸 사람, 수신자, 제목, 본문 및 헤더와 같은 정보를 손쉽게 추출할 수 있습니다.

이메일 정보 표시

이메일 파일을 로드하고 화면에 보낸 사람, 수신자, 제목, 본문과 같은 주요 속성을 표시합니다. 아래 코드 샘플은 Aspose.Email API를 사용하여 이메일 정보를 화면에 표시하는 방법을 보여줍니다.

다음의 인스턴스를 생성합니다. MailMessage 클래스.
이메일 메시지를 로드합니다 MailMessage 인스턴스.
콘솔에 원하는 속성(예: From, To, Subject, Body)을 표시합니다.

Note: 전체 예제와 데이터 파일은 다음을 방문하십시오: Aspose.Email for C++ GitHub 저장소.

이메일 헤더 추출

email header는 라우팅 정보, 콘텐츠 유형, 인코딩 및 발신자/수신자 세부 정보를 포함한 메시지를 설명하는 메타데이터 필드 집합입니다.

Aspose.Email for C++를 사용하면 다음을 통해 이러한 헤더를 추출하고 작업할 수 있습니다: MailMessage 클래스.

가장 일반적인 헤더 유형은 다음을 통해 사용할 수 있습니다: HeaderType 클래스는 표준 헤더 필드에 대한 명명된 상수를 제공합니다.

다음 코드 스니펫은 email 헤더 추출 방법을 보여줍니다:

다음의 인스턴스를 생성합니다. MailMessage 클래스.
인스턴스에 이메일 파일을 로드합니다.
다음 을 사용하여 헤더 컬렉션을 검색합니다: get_Headers() 메서드.
컬렉션을 반복하여 헤더 이름과 값을 읽거나 표시합니다.

디코드된 헤더 값 가져오기

일부 이메일 헤더에는 인코딩된 텍스트가 포함될 수 있습니다(예: 제목 행 또는 인코딩된 단어를 사용하는 사용자 정의 헤더). 다음을 사용하여 디코딩된 값을 쉽게 검색할 수 있습니다: GetDecodedValue() 메서드 HeaderCollection 클래스.

다음 코드 스니펫은 디코딩된 헤더 값을 가져오는 방법을 보여줍니다.

Cpp: Aspose.Email for C++를 사용한 이메일 메시지 로드 및 저장

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

**Aspose.Email for C++**는 EML, MSG, MHTML, HTML 등 다양한 형식의 이메일 메시지를 로드, 저장 및 변환할 수 있는 유연한 옵션을 제공합니다. 또한 인코딩, 첨부 파일 및 포맷 요구사항을 처리하도록 로드 및 저장 옵션을 사용자 정의할 수 있습니다.

사용자 정의 로드 옵션으로 메시지 로드

다음은 MailMessage 클래스는 EML, MSG, MHTML, HTML 등 다양한 형식의 메시지를 특수 로드 옵션을 사용해 로드할 수 있습니다. 이 옵션을 통해 개발자는 인코딩 설정, 첨부 파일 보존 및 임베드된 리소스 관리를 지정할 수 있습니다.

다음 C++ 예제는 다양한 로드 옵션을 사용하여 이메일 메시지를 로드하는 방법을 보여줍니다.

다양한 형식으로 이메일 메시지 저장

Aspose.Email for C++는 EML, MSG, MHTML, HTML 등 형식 간 메시지 변환을 지원합니다. 개발자는 이를 사용하여 SaveOptions 클래스 계층 구조를 사용하여 인코딩, TNEF 첨부 파일 및 경계 보존 등을 포함한 고급 저장 매개변수를 지정합니다.

사용 가능한 저장 옵션은 다음과 같습니다:

EmlSaveOptions
MsgSaveOptions
MhtSaveOptions
HtmlSaveOptions

이메일을 EML로 저장

다음 코드 스니펫은 EML 메시지를 로드한 뒤 동일한 형식으로 디스크에 저장하는 방법을 보여줍니다.

원본 EML 경계 보존

EML 파일을 저장할 때 원본 MIME 경계를 보존할 수 있습니다.

EML에서 TNEF 첨부 파일 보존

다음 코드 예제는 TNEF(Transport Neutral Encapsulation Format) 첨부 파일을 보존하면서 이메일을 저장하는 방법을 보여줍니다.

Convert EML to MSG

EML 파일을 Outlook MSG 형식으로 쉽게 변환할 수 있습니다. 다음 코드 스니펫은 EML 메시지를 로드하고 적절한 옵션을 사용해 MSG로 변환하는 방법을 보여줍니다. SaveOptions 클래스.

MHTML로 저장

다음 예제는 EML 메시지를 로드하여 MHTML 파일로 저장하는 방법을 보여줍니다.

사용자 지정 시간대로 MHT 내보내기

MHT 형식으로 내보내기 전에 메시지 날짜 필드에 사용자 지정 혹은 시스템 시간대를 설정할 수 있습니다. MailMessage class는 다음을 제공합니다 TimeZoneOffset 속성을 사용하여 사용자 지정 시간대를 설정합니다. 다음 코드 스니펫은 사용자 지정 시간대와 함께 이메일을 MHT로 내보내는 방법을 보여줍니다.

EML로 이메일 내보내기

다음 예제는 이메일을 EML 형식으로 내보내는 방법을 보여줍니다:

Cpp: 유틸리티 기능 - MailMessage

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

TNEF 첨부 파일이 포함된 MailMessage

Transport Neutral Encapsulation Format(TNEF)은 Microsoft Outlook 및 Microsoft Exchange Server에서 사용하는 독점 이메일 첨부 파일 형식입니다. Aspose.Email API를 사용하면 TNEF 첨부 파일이 포함된 이메일 메시지를 읽고 첨부 파일의 내용을 수정할 수 있습니다. 그런 다음 이메일을 일반 이메일 형식이나 동일한 형식으로 저장하면서 TNEF 첨부 파일을 보존할 수 있습니다. 이 문서는 TNEF 첨부 파일이 포함된 메시지를 처리하는 다양한 코드 샘플을 보여줍니다. 또한 Outlook MSG 파일에서 TNEF EML 파일을 생성하는 방법도 다룹니다.

TNEF 첨부 파일을 보존하면서 메시지 읽기

다음 코드 스니펫은 TNEF 첨부 파일을 보존하면서 메시지를 읽는 방법을 보여줍니다.

반송된 메시지 확인

수신자에게 보낸 메시지가 잘못된 주소 등 다양한 이유로 반송되는 경우가 흔합니다. Aspose.Email API는 메시지가 반송 이메일인지 일반 이메일인지 확인할 수 있는 기능을 제공합니다. MailMessage의 CheckBounced 메서드는 이메일이 반송된 경우 유효한 결과를 반환합니다. 이 문서에서는 반송 여부를 확인하는 BounceResult 클래스 사용법을 보여줍니다. 또한 수신자, 수행된 조치 및 알림 이유에 대한 자세한 정보를 제공합니다. 다음 코드 스니펫은 반송 메시지를 처리하는 방법을 보여줍니다.

Cpp: C++ API를 사용한 첨부 파일 및 포함 객체 작업

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

첨부 파일 작업

Email attachments는 이메일 메시지와 함께 전송되는 파일입니다. 이러한 파일에는 문서, 이미지, 압축 파일 등이 포함될 수 있습니다.

Aspose.Email for C++에서 첨부 파일은 다음을 통해 관리됩니다: Attachment 클래스, 이는 다음과 함께 작동합니다: MailMessage 클래스. 프로그래밍 방식으로 첨부 파일을 추가, 제거, 추출 또는 표시할 수 있습니다.

Note: 최대 첨부 파일 크기는 메일 서버에 따라 다릅니다(예: Gmail은 첨부 파일을 10 MB로 제한합니다).

사용해 보세요!

무료로 이메일 첨부 파일을 추가하거나 제거하세요 Aspose.Email Editor App.

이메일에 첨부 파일 추가

이메일 메시지에 하나 이상의 파일을 첨부하려면 아래 단계에 따르십시오:

다음의 인스턴스를 생성합니다. MailMessage 클래스.
Create Attachment 각 파일에 대한 객체.
다음으로 메시지에 첨부 파일을 추가하십시오: AddAttachment().
필요한 경우 메시지를 저장하십시오.

코드 샘플

이메일에서 첨부 파일 제거

다음 방법을 사용하여 메시지에서 첨부 파일을 손쉽게 제거할 수 있습니다: Remove() 메서드 첨부 파일 컬렉션.

다음 코드 스니펫은 첨부 파일을 제거하는 방법을 보여줍니다:

로드하거나 생성하십시오: MailMessage 인스턴스.
하나 이상의 첨부 파일을 추가합니다.
원하는 첨부 파일을 제거합니다.
필요에 따라 남은 첨부 파일을 표시합니다.

첨부 파일 이름 표시

모든 첨부 파일을 반복하여 콘솔에 이름을 표시할 수 있습니다:

이메일에서 첨부 파일 추출

기존 이메일 파일에서 첨부 파일을 추출하고 저장하려면 아래 단계에 따르십시오:

다음으로 메시지를 로드하십시오: MailMessage 클래스.
반복합니다 첨부 파일 컬렉션.
각 첨부 파일을 디스크에 저장하고 필요에 따라 이름을 표시합니다.

다음 코드 스니펫은 이메일 첨부 파일을 추출하는 방법을 보여줍니다:

|이메일에서 추출된 첨부 파일| | :- | ||

첨부 파일 Content Description 읽기

Aspose.Email를 사용하면 첨부 파일의 Content-Description 헤더를 읽어 추가 메타데이터를 확인할 수 있습니다.

코드 샘플

포함된 개체 작업

embedded object는 한 애플리케이션에서 생성된 파일을 다른 문서나 이메일에 포함한 것입니다. 예를 들어, Microsoft Excel 스프레드시트를 Word 문서에 포함하거나 이미지를 이메일 본문에 직접 포함할 수 있습니다.

객체가 포함되면(단순히 첨부되거나 링크된 것이 아니라) 원래 형식을 유지하며 기본 애플리케이션에서 열거나 편집할 수 있습니다.

이메일에 개체 포함

이메일 메시지에 이미지나 다른 객체를 포함하려면 다음을 사용하십시오: LinkedResource 클래스와 함께 MailMessage 및 AlternateView 클래스. 이를 통해 인라인 이미지나 미디어 콘텐츠를 메시지 본문에 직접 표시할 수 있습니다.

다음 코드 샘플은 평문 텍스트와 HTML 콘텐츠를 모두 포함하고, 포함된 이미지를 포함하는 이메일 메시지를 만드는 방법을 보여줍니다:

다음의 인스턴스를 생성합니다. MailMessage 클래스.
보낸 사람, 받는 사람 및 제목 필드를 설정하십시오.
다음 을 사용하여 평문 본문을 생성합니다: AlternateView.
다음 을 사용하여 포함된 객체에 대한 참조가 포함된 HTML 본문을 생성합니다: cid (Content-ID).
다음의 인스턴스를 생성합니다. LinkedResource 클래스와 객체를 로드합니다.
연결된 리소스에 Content-ID를 할당하십시오.
연결된 리소스와 대체 보기를 메시지에 추가하십시오.
이메일 메시지를 저장하거나 전송하십시오.

Note: > 여러 객체를 포함할 수 있지만, 최대 메시지 크기는 메일 서버에 의해 제한됩니다. 예를 들어, Gmail은 메시지 크기를 10 MB로 제한합니다.

이메일에서 포함 객체 추출

기존 이메일 메시지에서 이미지나 파일과 같은 포함 객체를 추출할 수도 있습니다. 과정은 첨부 파일을 추출하는 것과 유사합니다:

다음의 인스턴스를 생성합니다. MailMessage 클래스.
다음으로 이메일 파일을 로드하십시오: MailMessage 인스턴스.
첨부 파일 컬렉션을 반복합니다.
각 포함 객체를 디스크에 저장합니다.
필요에 따라 콘솔에 파일 이름을 표시합니다.

|이메일에서 추출된 내장 객체| | :- | ||

Cpp: Aspose.Email for C++에서 TNEF 첨부 파일 작업

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

**Transport Neutral Encapsulation Format (TNEF)**은 Microsoft Outlook 및 Exchange Server에서 사용하는 독점적인 이메일 첨부 형식입니다. 이러한 첨부 파일에는 서식이 지정된 텍스트, 포함된 이미지, 회의 요청과 같은 풍부한 메시지 데이터가 포함되는 경우가 많습니다.

Aspose.Email for C++는 이메일 메시지를 로드할 때 TNEF 첨부 파일을 읽고 보존하는 완전한 지원을 제공합니다. TNEF 첨부 파일의 내용을 액세스하고 수정한 뒤, 모든 포함된 데이터를 유지하면서 원본 형식 또는 다른 형식으로 메시지를 저장할 수 있습니다.

TNEF 첨부 파일을 보존하면서 이메일 읽기

이메일 메시지를 로드하고 TNEF 첨부 파일을 보존하려면 다음을 사용하십시오. MsgLoadOptions 클래스와 설정 PreserveTnefAttachments 속성 true.

다음 예제는 TNEF 데이터를 포함하는 메시지에서 첨부 파일 이름을 로드하고 표시하는 방법을 보여줍니다.

Cpp: Aspose.Email for C++를 사용한 반송 이메일 감지 및 처리

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

이메일을 보낼 때, 잘못된 수신자 주소나 사서함이 가득 찬 경우 등으로 일부 메시지가 수신자에게 도달하지 못할 수 있습니다. 이러한 배달되지 않은 메시지를 반송 이메일이라고 합니다.

Aspose.Email for C++는 다음을 사용해 반송 메시지를 감지하고 분석하는 편리한 방법을 제공합니다. MailMessage 및 BounceResult classes. The MailMessage::CheckBounced() 메시지가 반송인지 판단하고 반환하는 메서드 BounceResult 다음과 같은 상세 정보를 포함하는 객체:

메시지가 반송되었는지 여부
수신자 주소
반송 작업 유형
반송 사유 및 상태 코드

이를 통해 개발자는 전달 실패를 자동으로 식별하고, 메일링 리스트에서 잘못된 주소를 정리하는 등의 적절한 조치를 취할 수 있습니다.

다음 코드 예제는 이메일이 반송되었는지 확인하고 상세 정보를 가져오는 방법을 보여줍니다: