Documentation – POP3 클라이언트 작업

Net: POP3 서버에 연결

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

POP3 서버에 연결

다음은 Pop3Client 이 클래스는 POP3(우편 배달 프로토콜 버전 3)를 사용하여 애플리케이션이 메일함을 관리하도록 허용합니다. POP3 관리를 .NET 애플리케이션에 추가하려는 개발자를 위한 주요 진입점입니다.

POP3 서버에 연결하려면:

다음의 인스턴스를 생성합니다. Pop3Client 클래스.
호스트, 사용자 이름 및 비밀번호를 다음에 지정합니다: Pop3Client 인스턴스.

다음 코드 스니펫은 POP3 서버에 연결하는 방법을 보여줍니다.

SSL 서버에 연결

SSL이 활성화된 POP3 서버에 연결하는 과정은 유사하지만 몇 가지 추가 속성을 설정해야 합니다.

SecurityOptions
포트

SSL이 활성화된 POP3 서버에 연결하려면, SecurityOptions 및 Port 속성. 다음 코드 스니펫은 SSL이 활성화된 POP3 서버에 연결하는 방법을 보여줍니다.

APOP 서버에 연결

POP은 우편국 프로토콜(Post Office Protocol)을 의미합니다. APOP은 인증된 우편국 프로토콜(Authenticated Post Office Protocol)을 의미합니다. APOP은 사용자 이름과 비밀번호를 암호화하고 POP3 계정 비밀번호를 보호하도록 설계된 인증 메커니즘을 사용하는 POP3 서버 설정의 확장 버전입니다. APOP 인증은 POP3 메일 서버에 비밀번호를 평문으로 전송할 필요가 없습니다.

프록시를 통한 서버 연결

프록시 주소는 이메일 클라이언트가 인터넷을 통해 메일함에 접근할 때 사용됩니다. Aspose.Email은 SOCKS 프록시 프로토콜 버전 4, 4a 및 5를 지원합니다.

프록시 서버를 통해 이메일을 검색하려면:

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

다음 코드 스니펫은 프록시 서버를 통해 이메일을 검색하는 방법을 보여줍니다.

HTTP 프록시를 통한 서버 연결

CRAM-MD5 인증을 통한 연결

CRAM-MD5 인증을 사용하면 Aspose.Email for .NET은 이 인증 방식을 지원하는 이메일 서버에 안전하게 인증하고 접근할 수 있는 추가 보안 계층을 제공합니다. 아래 코드 샘플은 프로젝트에 이 메커니즘을 적용하는 방법을 보여줍니다:

popClient.AllowedAuthentication = Pop3KnownAuthenticationType.CramMD5;

서버 확장 기능 목록

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

서버 확장 기능 가져오기

다음 코드 샘플은 POP3Client를 사용하여 Gmail 서버에서 서버 확장 기능을 검색하는 예를 보여줍니다.

메일 작업 타임아웃 설정

각 메일 작업은 네트워크 지연, 데이터 크기, 서버 성능 등 여러 요인에 따라 시간이 소요됩니다. 모든 메일 작업에 대한 시간 제한을 설정할 수 있습니다. 아래 코드 예제는 이를 …을 사용해 설정하는 방법을 보여줍니다. 시간 제한 속성. 참고: 애플리케이션에서 긴 대기 시간을 피하려면 큰 값을 설정하지 않아야 합니다.

using (Pop3Client pop3Client = new Pop3Client("host", 995, "username", "password", SecurityOptions.Auto))
{
    pop3Client.Timeout = 60000; // 60 seconds

    // some code...
}

POP3 클라이언트와 암호화 프로토콜 사용

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

NOTE: .NET Framework에서 지원하는 프로토콜 버전만 설정해야 합니다. 현재 사용 중인 .NET Framework 버전에서 지원되지 않는 암호화 프로토콜 버전은 무시되고 건너뛰어집니다. 이 경우 예외가 발생하지 않습니다. Please use SetSupportedEncryptionUnsafe 호환성 검사를 수행하지 않고 프로토콜을 설정하려는 경우 해당 메서드

아래 코드 예제는 TLS 1.3을 설정하는 방법을 보여줍니다 Pop3Client 클래스 인스턴스.

using (Pop3Client pop3Client = new Pop3Client("host", 995, "username", "password", SecurityOptions.Auto))
{
    pop3Client.SupportedEncryption = EncryptionProtocols.Tls13;

    // some code...
}

지정된 암호화 프로토콜이 현재 .NET Framework 버전에서 지원되지 않을 경우, 다음 두 메서드 사이의 동작 차이가 발생합니다 SetSupportedEncryptionUnsafe 메서드 및 SupportedEncryption 속성은 다음과 같습니다:

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

Net: C#에서 POP3 메일 서버 자격 증명 검증

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

다음은 ValidateCredentials 이 메서드는 이메일을 전송하지 않고도 메일 서버 자격 증명 검증을 가능하게 합니다. 제공된 이메일 자격 증명의 진위와 유효성을 확인하며, 서버에 연결할 때 인증에 사용됩니다.

사용자 이름과 비밀번호와 같은 이메일 자격 증명이 유효한지, 그리고 클라이언트가 서버에 성공적으로 연결할 수 있는지 확인합니다. 이러한 자격 증명 검증은 클라이언트가 이메일 계정에 안전하게 접근하고 이메일 수신과 같은 다양한 작업을 수행할 수 있도록 보장합니다.

using (Pop3Client client = new Pop3Client(server.Pop3Url, server.Pop3Port, "userName", "password", SecurityOptions.Auto))
{
    client.Timeout = 4000;
   
    if (client.ValidateCredentials())
    {
        //to do something
    }
}

비동기 작업을 수행하기 위해 해당 메서드의 버전도 있습니다 ValidateCredentialsAsync.

Net: .NET에서 POP3 활동 로깅을 활성화하는 방법

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

POP3 클라이언트에서 활동 로깅 활성화

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

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

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

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

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

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

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

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

   {
     "Pop3DiagnosticLog": "Pop3.log",
     "Pop3DiagnosticLog_UseDate": true
   }

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

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

프로그램 코드를 사용하여 활동 로깅 활성화

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

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

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

생성합니다 Pop3Client.
다음으로 로그 파일 경로를 설정합니다 LogFileName 속성.
설정합니다. UseDateInLogFileName 필요한 경우 속성입니다.

   using (var client = new Pop3Client("your pop3 server", 995, "your username", "your password"))
{
    // Set security mode
    client.SecurityOptions = SecurityOptions.Auto;

    // Set the path to the log file using the LogFileName property.
    client.LogFileName = @"C:\Aspose.Email.Pop3.log";

    // Set the UseDateInLogFileName property if it is necessary.
    client.UseDateInLogFileName = false;
}

App.config 파일로 활동 로깅 활성화

Pop3Client 활동은 구성 파일의 configSections를 수정하여 로깅할 수 있습니다. 다음은 진단 로깅을 수행하는 단계입니다:

"applicationSettings"라는 sectionGroup을 추가합니다.
"Aspose.Email.Properties.Settings"라는 section을 추가합니다.
applicationSettings/Aspose.Email.Properties.Settings에 파일 이름이 정의된 ImapDiagonosticLog 설정을 포함합니다.

다음은 사용되는 샘플 폼 애플리케이션입니다 Pop3Client 메일을 처리합니다. 전체 활동은 App.config 파일을 수정하여 로깅됩니다.

단일 버튼이 있는 폼 기반 애플리케이션을 생성합니다. 버튼 클릭에 대한 다음 샘플 코드를 추가합니다:

Aspose.Email에 대한 참조를 추가합니다.
이제 App.Config 파일을 추가하고 내용을 다음과 같이 수정합니다:

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

|| | :- | VB .NET의 경우 다음 옵션을 사용하십시오

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

Net: 메일 서버에서 메시지를 검색하고 관리하기

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

메일함 정보 가져오기

메시지 수와 사서함 크기와 같은 사서함 정보를 다음을 사용하여 가져올 수 있습니다. GetMailBoxSize 및 GetMailBoxInfo 의 메서드 Pop3Client 클래스.

다음은 GetMailBoxSize 메서드는 사서함의 크기를 바이트 단위로 반환합니다.
다음은 GetMailBoxInfo 메서드는 타입의 객체를 반환합니다. Pop3MailBoxInfo.

다음 방법을 사용하여 메시지 수를 가져올 수도 있습니다. MessageCount 속성 및 크기를 사용하여 OccupiedSize 속성 Pop3MailBoxInfo 클래스. 다음 샘플 코드는 사서함 정보를 가져오는 방법을 보여줍니다. 다음과 같이:

다음을 생성합니다 Pop3Client.
POP3 서버에 연결합니다.
사서함의 크기를 가져옵니다.
사서함 정보를 가져옵니다.
사서함의 메시지 수를 가져옵니다.
사용 중인 크기를 가져옵니다.

메일함 내 이메일 수 조회

다음 코드 스니펫은 사서함에서 이메일 메시지 수를 계산하는 방법을 보여줍니다.

Aspose.Email을 사용하면 개발자는 다양한 방법으로 이메일을 처리할 수 있습니다. 예를 들어, 이메일을 다운로드하기 전에 헤더 정보를 조회하거나, 서버에서 이메일을 가져와 파싱 없이 저장(빠름)하거나 파싱 후 저장(느림)할 수 있습니다.

이메일 헤더 검색

이메일 헤더는 전체 이메일을 가져올지 여부를 판단하는 데 사용할 수 있는 이메일 메시지 정보를 제공합니다. 일반적으로 헤더 정보에는 발신자, 제목, 수신 날짜 등이 포함됩니다. (이메일 헤더에 대한 자세한 내용은 이메일 헤더 사용자 정의. 다음 예제는 메시지 순번을 사용하여 POP3 서버에서 이메일 헤더를 검색하는 방법을 보여줍니다.

이메일 메시지 검색

다음은 MailMessage 클래스는 이메일 내용을 조작하기 위한 여러 속성과 메서드를 포함합니다. 사용하면 FetchMessage 메서드 Pop3Client 클래스에서, 다음을 얻을 수 있습니다: MailMessage POP3 서버에서 직접 인스턴스를 가져옵니다. 다음 코드 스니펫은 POP3 서버에서 전체 이메일 메시지를 가져오는 방법을 보여줍니다.

고유 ID를 이용한 메시지 요약 검색

POP3 클라이언트는 메시지 고유 ID를 사용하여 서버에서 메시지 요약 정보를 가져올 수 있습니다. 이를 통해 전체 메시지를 먼저 가져오지 않고도 메시지의 간략 정보를 빠르게 확인할 수 있습니다. 다음 코드 스니펫은 메시지 요약 정보를 검색하는 방법을 보여줍니다.

다중 연결을 통한 메시지 목록

Pop3Client 를 제공합니다. UseMultiConnection 무거운 작업을 위해 다중 연결을 생성하는 데 사용할 수 있는 속성입니다. 멀티연결 모드에서 사용할 연결 수는 다음을 사용하여 설정할 수 있습니다. Pop3Client.ConnectionsQuantity. 다음 코드 스니펫은 다중 연결 모드를 사용하여 메시지를 나열하고 단일 연결 모드와 성능을 비교하는 예를 보여줍니다.

멀티 연결 모드 사용이 성능 향상을 보장하지는 않는다는 점에 유의하십시오.

서버에서 메시지를 가져와 디스크에 저장

파싱 없이 메시지를 디스크에 저장

POP3 서버에서 이메일을 파싱하지 않고 다운로드하려면, Pop3Client 클래스 SaveMessage 함수. SaveMessage 함수는 이메일을 파싱하지 않으므로 ~보다 빠릅니다. FetchMessage 함수. 다음 코드 스니펫은 순번으로 메시지를 저장하는 방법을 보여줍니다. 이 경우, SaveMessage 메서드는 메시지를 파싱하지 않고 원본 EML 형식으로 저장합니다.

저장하기 전에 메시지 파싱

다음 코드 스니펫은 ~를 사용합니다. Pop3Client FetchMessage 시퀀스 번호로 POP3 서버에서 메시지를 가져와 제목을 파일 이름으로 사용해 디스크에 저장하는 메서드.

그룹 메시지 가져오기

Pop3Client 를 제공합니다. FetchMessages 시퀀스 번호 또는 고유 ID의 iterable을 받아 리스트를 반환하는 메서드. MailMessage. 다음 코드 스니펫은 ~의 사용을 보여줍니다. FetchMessages 시퀀스 번호와 고유 ID로 메시지를 가져오는 메서드.

Net: 메일 서버에서 이메일 필터링

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

보낸 사람, 받는 사람 또는 날짜별 메시지 필터링

다음은 Pop3Client 클래스, 자세한 내용은 POP3 서버에 연결, 제공하는 ListMessages() 메서드는 사서함의 모든 메시지를 가져옵니다. 특정 조건에 일치하는 메시지만 얻으려면 오버로드된 메서드를 사용하십시오 ListMessages() 메서드는 ~를 받아들입니다 MailQuery 을 인수로 사용합니다. MailQuery 클래스는 날짜, 제목, 발신자, 수신자 등과 같은 쿼리 조건을 지정하기 위한 다양한 속성을 제공합니다. MailQueryBuilder 클래스는 검색 식을 구축하는 데 사용됩니다. 먼저 모든 조건과 제약을 설정하고 나서 MailQuery ~에 의해 개발된 쿼리로 채워집니다 MailQueryBuilder. The MailQuery 클래스 객체는 ~에 의해 사용됩니다 Pop3Client 서버에서 필터링된 정보를 추출합니다. 이 문서는 사서함에서 이메일 메시지를 필터링하는 방법을 보여줍니다. 첫 번째 예제는 날짜와 제목을 기준으로 메시지를 필터링하는 방법을 설명합니다. 또한 다른 기준으로 필터링하고 더 복잡한 쿼리를 만드는 방법도 보여줍니다. 날짜와 시간 필터를 적용하여 사서함에서 특정 이메일을 검색하는 예시도 포함됩니다. 추가로 대소문자 구분 필터링 적용 방법도 설명합니다.

사서함에서 메시지 필터링

사서함에서 메시지를 필터링하려면:

POP3 서버에 연결.
다음의 인스턴스를 생성합니다 MailQuery 그리고 원하는 속성을 설정합니다.
다음을 호출합니다. Pop3Client.ListMessages(MailQuery query) method에 전달하고 MailQuery 매개변수에 지정하여 필터링된 메시지만 가져옵니다.

다음 코드 스니펫은 POP3 사서함에 연결하고 오늘 도착한 메시지 중 제목에 "newsletter"가 포함된 메시지를 가져오는 방법을 보여줍니다.

특정 기준으로 메시지 조회

위의 코드 샘플 이메일 제목과 날짜를 기준으로 메시지를 필터링하는 방법을 보여줍니다. 다른 지원 조건을 설정하기 위해 다른 속성을 사용할 수도 있습니다. 아래는 해당 속성을 사용하여 조건을 설정하는 몇 가지 예시입니다. MailQuery.

다음 코드 스니펫은 다른 기준으로 이메일을 필터링하는 방법을 보여줍니다:

오늘 전달된 이메일을 찾습니다.
특정 기간 내에 수신된 이메일을 찾습니다.
특정 발신자의 이메일을 찾습니다.
특정 도메인에서 보낸 이메일을 찾습니다.
특정 수신자에게 보낸 이메일을 찾습니다.

오늘 날짜

다음 코드 스니펫은 오늘 전달된 이메일을 찾는 방법을 보여줍니다.

날짜 범위

다음 코드 스니펫은 특정 기간 내에 수신된 이메일을 찾는 방법을 보여줍니다.

특정 발신자

다음 코드 스니펫은 특정 발신자에게서 온 이메일을 찾는 방법을 보여줍니다.

특정 도메인

다음 코드 스니펫은 특정 도메인에서 보낸 이메일을 찾는 방법을 보여줍니다.

특정 수신자

다음 코드 스니펫은 특정 수신자에게 보낸 이메일을 찾는 방법을 보여줍니다.

복잡한 쿼리 구성

다른 경우 MailQueryBuilder 속성을 별도의 문장으로 설정하면 모든 조건이 일치합니다. 예를 들어, 날짜 범위와 특정 호스트에서 온 메시지를 가져오려면 세 개의 문장을 작성해야 합니다.

AND 연산자로 쿼리 결합

다음 코드 스니펫은 AND로 쿼리를 결합하는 방법을 보여줍니다.

OR 연산자로 쿼리 결합

MailQueryBuilder 제공합니다 Or() 두 개를 받는 메서드 MailQuery 인스턴스를 매개변수로 사용합니다. 지정된 두 조건 중 하나라도 일치하는 메시지를 가져옵니다. 다음 코드 스니펫은 제목에 “test”가 포함되었거나 발신자가 "noreply@host.com"인 메시지를 필터링하는 방법을 보여줍니다. 또한 OR 연산자를 사용해 쿼리를 결합하는 방법을 보여줍니다.

대소문자 구분 필터

API는 또한 대소문자 구분 기준에 따라 사서함의 이메일을 필터링하는 기능을 제공합니다. 다음 메서드들은 대소문자 구분 플래그를 지정하여 이메일을 검색할 수 있는 기능을 제공합니다.

Method Aspose.Email.StringComparisonField.Contains(string value, bool ignoreCase)
Method Aspose.Email.StringComparisonField.Equals(string value, bool ignoreCase)
Method Aspose.Email.StringComparisonField.NotContains(string value, bool ignoreCase)
Method Aspose.Email.StringComparisonField.NotEquals(string value, bool ignoreCase)

Net: POP3 서버에서 이메일 삭제

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

서버에서 이메일 삭제

다음은 Pop3Client 이 클래스는 POP3 프로토콜을 사용하여 메일함의 메일 메시지를 PC로 복사합니다. 메일을 가져온 후에는 인터넷에 연결되어 있지 않아도 PC에서 읽을 수 있습니다. POP3 서버에 보관된 일부 메일을 복사할 필요가 없거나 원하지 않을 경우 해당 메일을 삭제할 수 있습니다. 이 섹션에서는 다음을 사용하여 이메일을 삭제하는 방법을 보여줍니다 Pop3Client 클래스.

인덱스로 이메일 삭제

다음 코드는 인덱스를 기준으로 사서함의 모든 메일을 하나씩 삭제합니다. 인덱스는 절대 0 이하가 되어서는 안 됩니다. Pop3Client.DeleteMessage.

모든 이메일 삭제

또한 다음을 호출할 수 있습니다 Pop3Client.DeleteMessages 모든 메시지를 삭제하기 위해. 다음 코드 스니펫은 모든 이메일을 삭제하는 방법을 보여줍니다.

// Delete all the messages
client.DeleteMessages();

삭제 작업 직후 POP3 서버와의 연결이 끊어지면, 더 이상 Cancel Deletes를 호출하여 원하는 작업을 수행할 수 없습니다.

이메일 삭제 취소

Pop3Client.UndeleteMessages 이메일 메시지 삭제를 취소하는 데 사용할 수 있습니다. 다음 코드 스니펫은 삭제 취소 방법을 보여줍니다.

// Cancel deletes
client.UndeleteMessages();

Net: POP3 클라이언트를 사용한 비동기 이메일 처리

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

Pop3Client와 비동기 작업

메시지 작업은 Aspose.Email을 사용하여 비동기적으로 수행할 수도 있습니다 Pop3Client. 이 문서는 사서함에서 메시지를 비동기적으로 검색하는 방법을 보여줍니다. 또한 검색 기준을 제공하여 메시지를 나열하는 방법을 보여줍니다. MailQuery. 작업을 중단하는 방법은 작업 기반 비동기 패턴( TAP) 메서드.

메시지 비동기 검색

다음 코드 스니펫은 메시지를 비동기적으로 검색하는 방법을 보여줍니다.

MailQuery를 사용한 비동기 메시지 목록

다음은 MailQuery 클래스는 다음 코드 샘플에 표시된 대로 비동기적으로 메시지 목록을 검색하기 위한 검색 기준을 지정하는 데 사용할 수 있습니다.

TAP 메서드 중단

.NET Framework 4.5부터 TAP 모델에 따라 구현된 비동기 메서드를 사용할 수 있습니다. 아래 코드 스니펫은 해당 작업 기반 비동기 패턴 메서드를 사용하여 사서함 정보를 받는 방법을 보여줍니다. GetMailboxInfoAsync 그리고 잠시 후 이 프로세스를 중단합니다.

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

using (Pop3Client client = new Pop3Client(host, 995, senderEmail, password, SecurityOptions.Auto))
{
    CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();
    AutoResetEvent autoResetEvent = new AutoResetEvent(false);
    Exception exception = null;

    ThreadPool.QueueUserWorkItem(delegate
    {
        try
        {
            // start receiving mailbox information
            var task = client.GetMailboxInfoAsync(cancellationTokenSource.Token);
            Pop3MailboxInfo mailboxInfo = task.GetAwaiter().GetResult();
            Console.WriteLine("Message count: " + mailboxInfo.MessageCount);
        }
        catch (Exception e)
        {
            exception = e;
        }
        finally
        {
            autoResetEvent.Set();
        }
    });

    Thread.Sleep(2000);

    // stop receiving mailbox information
    cancellationTokenSource.Cancel();
    autoResetEvent.WaitOne();

    if (exception is OperationCanceledException)
        Console.WriteLine("Operation has been interrupted: " + exception.Message);
}